SDK
NUTSPAY / DEVELOPERS/接入文档

开始接入

从创建一笔收款开始。先打通创建、跳转和结果确认,再接入订单与资金管理。

一笔收款的接入流程

  1. 01

    在商户后台创建 App ID 和 App Secret,将密钥保存为服务端环境变量 NUTSPAY_APP_ID、NUTSPAY_APP_SECRET。不要放入网页或移动应用包。

  2. 02

    由服务端调用 POST /api/v1/payments。amount 使用派士;每个业务订单生成一个稳定的 Idempotency-Key。

  3. 03

    保存返回的 id,将付款人跳转至 cashier_url。支付结束后的返回页只负责界面展示。

  4. 04

    验签接收 payment.succeeded,或通过收款 id 查询 paid 状态。对同一订单只发货一次。

选择接入方式

托管收银台适合由 NutsPay 展示支付方式;支付链接适合重复收款或收款码;渠道接口适合由你的应用直接调起微信或支付宝。托管收银台及支付链接创建目前仅支持正式环境;使用测试凭证时,选择标注“支持沙盒”的渠道接口。