Manual 收单(线下收单)是 Payin 收款方案 的线下分支:商户在后台预先创建固定收款地址,通过线下渠道分发给付款方,付款方将资金转入地址后即自动入账,并通过标准 Webhook 通知商户。全程无需终端用户访问支付页面。

适用场景

  • 代理商 / 渠道充值:付款方为固定合作方,长期向同一地址转账
  • 线下结算:与合作方按周期线下结算的大额转账
  • 人工收款:任何不便走线上支付页面、但需要自动入账与对账的收款

业务流程

时序图

Manual 收单时序

操作步骤

1

创建固定收款地址

在后台「地址管理」中创建地址:选择链、填写描述备注(建议按「区域/渠道/用途」命名,如 华东_渠道A)。可按业务需要创建多个地址,每个地址唯一;只要所属钱包与链保持启用,地址即持续可用。
2

线下分发地址

将「链 + 地址 + 备注」提供给运营,由运营分发给对应的付款方。
3

付款方转账

付款方将 USDT 等支持的代币转入固定地址(支持范围与线上 Payin 一致,见 支持的代币)。
4

自动入账

NUSDpay 检测到链上交易后,等待区块确认并完成入账。入账规则(确认数、汇率换算、服务费)与 线上 Payin 完全一致。
5

Webhook 通知

入账完成后,系统通过标准 充值回调 推送事件——与线上充值同一通道、同一结构,商户直接复用已有入账处理代码。接入细节见 充值回调 · Manual 收单场景
6

订单与结算

订单在后台「充值记录」中可查;结算规则与线上 Payin 一致(商户发起、平台审核),见 结算方案

收款钱包与资金核算

Manual 收单使用独立的项目收单钱包,与线上 Payin 钱包分开核算余额与账单。
  • 各项目对应的收单钱包 ID 由 NUSDpay 在接入时提供
  • Webhook 事件中的 data.wallet_id 即为该钱包 ID(现成字段),商户据此区分线下 / 线上订单并做路由

注意事项

固定地址会持续接收转账,请妥善管理分发范围:地址一经分发,任何人转入受支持的代币都会触发入账;不支持的代币不会自动入账,需走工单处理(见 异常情况)。
Webhook 不下发地址备注:商户侧可用 data.destination.address 关联建地址时填写的「描述」,实现按渠道归因(字段对照见 充值回调 · Manual 收单场景)。

下一步

充值回调

Webhook 事件结构、入账判断与字段对照。

地址管理

在后台创建与管理固定收款地址。