开始接入
从创建一笔收款开始。先打通创建、跳转和结果确认,再接入订单与资金管理。
一笔收款的接入流程
- 01
在商户后台创建 App ID 和 App Secret,将密钥保存为服务端环境变量 NUTSPAY_APP_ID、NUTSPAY_APP_SECRET。不要放入网页或移动应用包。
- 02
由服务端调用 POST /api/v1/payments。amount 使用派士;每个业务订单生成一个稳定的 Idempotency-Key。
- 03
保存返回的 id,将付款人跳转至 cashier_url。支付结束后的返回页只负责界面展示。
- 04
验签接收 payment.succeeded,或通过收款 id 查询 paid 状态。对同一订单只发货一次。
选择接入方式
托管收银台适合由 NutsPay 展示支付方式;支付链接适合重复收款或收款码;渠道接口适合由你的应用直接调起微信或支付宝。托管收银台及支付链接创建目前仅支持正式环境;使用测试凭证时,选择标注“支持沙盒”的渠道接口。