创建代付订单

WARNING

必看：姓名+手机号+邮箱+金额为判定不同客户发起依据，所以建议商户对接中注意以下问题，否则容易产生风控误判。

1. 不建议姓名、手机号、邮箱都写死
2. 同一客户使用同一个姓名+手机号+邮箱

接口

POST /cashout/php/order/create

请求参数

字段	类型	必填	说明
name	string	是	客户名 — 越真实，成功率越高，触发风控系数越低，长度要求大于5
phone	string	是	客户手机号 — 通常以0开头，11位数字的菲律宾格式，越真实，成功率越高，触发风控系数越低
email	string	是	客户邮箱 — 越真实，成功率越高，触发风控系数越低
bankCode	string enum	是	代付方式编码 — 请查看BankCode编码章节 — UPI, BANK_IN
account	string	是	账号 — 根据bankCode不同，填写相应的账号，手机号以0开头，11位数字
amount	number	是	金额 — 最多小数点后两位，超过则四舍五入,带小数点的情况,注意如果是浮点型签名前的拼接中amount的值会省略小数点后末尾的0
notifyUrl	string	是	通知地址 — 测试环境上支持自动回调，请求参数手机号最后一位奇数回调成功，偶数回调失败
sign	string	是	签名
appId	string	是	商户appId
mchOrderNo	string	是	商户订单号
mchId	integer	是	商户号
txChannel	string	是	交易通道
timestamp	integer	是	当前时间戳 — 秒级时间戳

请求示例

{
  "mchId": 364295370188661,
  "txChannel": "TX_PHP_001",
  "appId": "7acG5KbHUAxC3EJNxG",
  "timestamp": 1662450012,
  "mchOrderNo": "payout_26622128134",
  "name": "Matthew Clark",
  "phone": "09818970682",
  "email": "test@gmail.com",
  "bankCode": "BPI",
  "account": "09818970682",
  "amount": "50",
  "notifyUrl": "http://xmevj.kg/obp",
  "sign": "xxxxxxxx"
}

响应参数

字段	类型	必填	说明
status	integer	是	状态 — 200成功
msg	string	是	信息
data	object	是
data.applyTime	integer	是	申请时间
data.amount	number	是	到账金额
data.platOrderNo	string	是	平台订单号
data.mchOrderNo	string	是	商户订单号
data.orderStatus	string enum	是	订单状态 — PENDING, SUCCESS, FAILED, REFUND

响应示例

{
  "status": 200,
  "msg": null,
  "data": {
    "mchOrderNo": "payout_1662104438",
    "platOrderNo": "wussXUCOoXO3yptr7rQV",
    "applyTime": 1662104742,
    "amount": 180.34,
    "orderStatus": "PENDING"
  }
}

相关文档

• 菲律宾
• 签名与验签
• 代付 Webhook