代收下单

接口说明

创建代收订单，成功后返回支付链接（payUrl）供用户完成支付。

请求

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

请求参数

参数名	类型	必填	说明
userCode	String	是	商户编号（alliesCode），也可用 alliesNo
orderNo	String	是	商户订单号，需保证唯一，也可用 tradeNo
amount	String	是	订单金额（如 "100.00"），也可用 totalAmount
paymentMethod	String	是	支付方式，传 tradeType 数字值：菲律宾 31(GCash)/32(Bank)/33(Maya)/34(QRPH)，泰国 1001(Your泰)
notifyUrl	String	是	支付结果回调通知地址
returnUrl	String	否	支付完成后前端跳转地址
productId	String	否	产品ID
productName	String	否	商品名称
payerName	String	否	付款人姓名
payerPhone	String	否	付款人手机号
clientIp	String	否	客户端IP
attach	String	否	附加数据，原样回调
remark	String	否	备注
signType	String	否	签名类型：RSA（默认）或 MD5
sign	String	是	签名值

sign 和 signType 不参与签名计算

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

请求示例

{
  "userCode": "IG20260622001",
  "orderNo": "ORD20260622001",
  "amount": "100.00",
  "paymentMethod": "31",
  "notifyUrl": "https://your-domain.com/callback/notify",
  "returnUrl": "https://your-domain.com/return",
  "attach": "custom_data",
  "signType": "RSA",
  "sign": "Base64编码的RSA签名值"
}

curl 示例

curl -X POST https://api.your-domain.com/api/alliesPay/order \
  -H "Content-Type: application/json" \
  -d '{
    "userCode": "IG20260622001",
    "orderNo": "ORD20260622001",
    "amount": "100.00",
    "paymentMethod": "31",
    "notifyUrl": "https://your-domain.com/callback/notify",
    "signType": "RSA",
    "sign": "xxxxx"
  }'

响应

响应参数

参数名	类型	说明
code	String	状态码，10000 表示成功
msg	String	状态描述
orderNo	String	商户订单号（请求时的 orderNo）
userCode	String	商户编号
outTradeNo	String	平台订单号
payUrl	String	支付链接，引导用户跳转支付
amount	String	订单金额
paymentMethod	String	支付方式（tradeType 数字）
bankCard	String	银行卡号（如有）
bankAccount	String	银行账户名（如有）
bankName	String	银行名称（如有）
bankAddress	String	银行地址（如有）
sign	String	响应签名（与请求 signType 一致）

成功响应示例

{
  "code": "10000",
  "msg": "success",
  "orderNo": "ORD20260622001",
  "userCode": "IG20260622001",
  "outTradeNo": "P2026062200001",
  "payUrl": "https://pay.channel.com/pay/xxx",
  "amount": "100.00",
  "paymentMethod": "31",
  "bankCard": "",
  "bankAccount": "",
  "bankName": "",
  "bankAddress": "",
  "sign": "响应签名值"
}

失败响应示例

{
  "code": "1003",
  "msg": "Below minimum limit 10.00元",
  "data": null
}

响应验签

响应中的 sign 字段使用与请求相同的签名方式生成：

• RSA：服务端用 RSA 私钥签名，商户用 RSA 公钥验签
• MD5：服务端用 MD5(params + &key=secretKey) 生成，商户用相同方式验证

WARNING

验证响应签名时，同样排除 sign 和 signType 字段。