创建代付

POST /v1/api/disbursement/create_order

• success=true / code=200 仅表示订单创建或幂等返回成功，不表示已付款；通过查单或回调确认结果。
• 银行卡付款请填写真实收款人信息及适用的银行支行 IFSC。
• 同商户同订单号重试：参数一致且已有订单未失败/取消/失效/冲正时返回原订单；不会创建第二笔。已结束或关键参数不同返回 100409。

请求参数

字段	类型	要求	说明
tenant_id	string	必填	商户编号，须与 app_key 属于同一商户；最多 20 字符。
app_key	string	必填	商户应用标识，最多 16 字符；使用该应用对应的 app_secret 签名。
timestamp	string / integer	必填	当前 Unix 秒级时间戳。超过 60 秒的旧时间戳会被拒绝；不要传毫秒。
sign	string	必填	按签名规则计算的 32 位小写 MD5。
tenant_order_no	string	必填	商户订单号，最多 64 字符；不是平台订单号。
amount	string / number	必填	订单金额，最小 0.01；建议传十进制字符串。单笔上下限按商户配置。
payment_type	integer	必填	1 银行卡；2 UPI。按本笔付款方式选择，不是始终固定为 1。
payee_account_name	string	银行卡必填	payment_type=1 时必填，最多 100 字符；填写收款人姓名，不是账号。
payee_account_no	string	银行卡必填	payment_type=1 时必填，最多 100 字符；填写真实银行账号并保留前导零。
payee_bank_code	string / null	按付款方式要求提供	收款银行支行 IFSC，最多 100 字符。银行卡付款建议提供真实有效的 11 位编码，具体要求按开通的付款方式确认。
payee_bank_name	string / null	选填	选填，最多 100 字符；使用真实标准银行名称，无公开固定枚举。
payee_upi	string	UPI 必填	payment_type=2 时必填，最多 100 字符；收款人 UPI，格式为用户名@机构标识。
payee_phone	string	选填	收款人手机号，选填字符串，最多 20 字符。
notify_url	string	选填	结果回调地址，最多 255 字符，须通过 URL/域名校验。不传则没有该订单回调。
notify_remark	string	选填	最多 255 字符，非空时在回调中原样返回。

签名计算见签名规则。

请求示例 · cURL

curl --request POST 'https://api.trpay2024.com/v1/api/disbursement/create_order' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tenant_id": "DEMO0001",
  "app_key": "demo_app_key",
  "timestamp": "1791199800",
  "tenant_order_no": "DEMO-PAYOUT-001",
  "amount": "500.00",
  "payment_type": 1,
  "payee_account_name": "Demo Beneficiary",
  "payee_account_no": "123456789012",
  "payee_bank_code": "DEMO0000000",
  "payee_bank_name": "Example Bank",
  "payee_phone": "9000000000",
  "notify_url": "https://merchant.example/webhooks/payout",
  "notify_remark": "demo-payout",
  "sign": "139ddb87748a935668a9a326a23de829"
}'

响应示例

{
  "request_id": "00000000-0000-4000-8000-000000000001",
  "path": "/v1/api/disbursement/create_order",
  "success": true,
  "code": 200,
  "message": "成功",
  "data": {
    "platform_order_no": "PRT202610051700DEMO0001",
    "tenant_order_no": "DEMO-PAYOUT-001",
    "amount": "500.00"
  }
}

data 字段

字段	类型	要求	说明
platform_order_no	string	必填	平台订单号。
tenant_order_no	string	必填	商户订单号。
amount	string	必填	订单金额；不代表付款成功。

异常处理

请参阅HTTP 处理、请求异常处理和错误码。

UPI 请求示例

{
  "tenant_id": "DEMO0001",
  "app_key": "demo_app_key",
  "tenant_order_no": "DEMO-UPI-PAYOUT-001",
  "amount": "500.00",
  "payment_type": 2,
  "payee_upi": "demo@upi",
  "notify_url": "https://merchant.example/webhooks/payout",
  "timestamp": "1791199800",
  "sign": "0d2a72eb003c96af405d897081fb3704"
}