代付下单

接口说明

创建代付订单，将资金从商户钱包打款到指定的银行卡/电子钱包。

前置条件

• 商户需开启代付功能（dfStatus = 1）
• 商户钱包余额充足
• IP 需在白名单内（如已配置）

请求

• URL: POST /api/peerPay/order
• Content-Type: application/json

请求参数

参数名	类型	必填	说明
userCode	String	是	商户编号，也可用 alliesNo
orderNo	String	是	商户订单号，需保证唯一，也可用 tradeNo
amount	String	是	代付金额（如 "1000.00"），也可用 orderAmount
paymentMethod	String	否	支付方式，传 tradeType 数字值：菲律宾 31(GCash)/32(Bank)/33(Maya)/34(QRPH)，泰国 1001(Your泰)。不传时默认 31
notifyUrl	String	是	代付结果回调通知地址
attach	String	是	附加数据（必填），原样回调
bankName	String	是	银行名称（如 GCASH、BPI）
bankCode	String	是	银行卡号/账号，也可用 bankCard
bankHost	String	是	收款人姓名，也可用 bankAccount
bankMark	String	否	银行标识/联行号
bankProv	String	否	开户省份
bankCity	String	否	开户城市
bankBranch	String	否	开户支行
productId	String	否	产品ID
clientIp	String	否	客户端IP
signType	String	否	签名类型：RSA（默认）或 MD5
sign	String	是	签名值

sign 和 signType 不参与签名计算

签名时排除 sign 和 signType 两个字段，对其余非空参数按 ASCII 字典序拼接。

请求示例

{
  "userCode": "IG20260622001",
  "orderNo": "PAY20260622001",
  "amount": "1000.00",
  "paymentMethod": "31",
  "notifyUrl": "https://your-domain.com/callback/payout",
  "attach": "payout_order_001",
  "bankName": "GCASH",
  "bankCode": "09123456789",
  "bankHost": "Juan Dela Cruz",
  "signType": "RSA",
  "sign": "Base64编码的RSA签名值"
}

curl 示例

curl -X POST https://api.your-domain.com/api/peerPay/order \
  -H "Content-Type: application/json" \
  -d '{
    "userCode": "IG20260622001",
    "orderNo": "PAY20260622001",
    "amount": "1000.00",
    "paymentMethod": "31",
    "notifyUrl": "https://your-domain.com/callback/payout",
    "attach": "payout_order_001",
    "bankName": "GCASH",
    "bankCode": "09123456789",
    "bankHost": "Juan Dela Cruz",
    "signType": "RSA",
    "sign": "xxxxx"
  }'

响应

响应参数

参数名	类型	说明
code	String	状态码，10000 表示成功
msg	String	状态描述
orderNo	String	商户订单号（请求时的 orderNo）
userCode	String	商户编号
outTradeNo	String	平台结算单号
amount	String	代付金额
paymentMethod	String	支付方式（tradeType 数字）
sign	String	响应签名（与请求 signType 一致）

成功响应示例

{
  "code": "10000",
  "msg": "success",
  "orderNo": "PAY20260622001",
  "userCode": "IG20260622001",
  "outTradeNo": "DF2026062200001",
  "amount": "1000.00",
  "paymentMethod": "31",
  "sign": "响应签名值"
}

失败响应示例

{
  "code": "3001",
  "msg": "Insufficient wallet balance",
  "data": null
}

备注

• 代付下单后，订单进入 审核中（0） 状态
• 如果配置了自动代付通道，系统将自动处理
• 如果是金额超过 TG 确认阈值的大额订单，需管理员在 Telegram 确认后才会继续处理
• 可通过 订单查询接口 查看代付进度