出款下单

接口地址

POST /v1/api/withdraw

请求

请求参数

变量名	必填	类型	示例值	描述
`mcode`	是	string	`M10086`	商户 ID
`tno`	是	string	`W202608020001`	商户订单号
`amt`	是	string	`500.26`	出款金额
`ntf_url`	是	string	`https://example.com/notify`	异步通知地址
`bank_code`	是	string	`PH_GCASH`	银行或钱包代码，建议通过银行列表接口获取
`bank_addr`	否	string	`Manila`	开户行地址
`acct_number`	是	string	`09959350888`	收款账号或卡号
`acct_name`	是	string	`BAOJUNTANG`	收款人姓名
`chnl`	是	string	`PHP_WD`	出款渠道 code
`extra`	否	string	`remark=demo`	原样返回
`data`	否	object	{}	扩展数据
`ts`	是	string	`1785138705251`	请求毫秒时间戳长度13位
`sign`	是	string	`c380be...`	签名值

请求示例

{
  "mcode": "M10086",
  "tno": "W202608020001",
  "amt": "500.26",
  "cur": "PHP",
  "ntf_url": "https://example.com/notify",
  "bank_code": "PH_GCASH",
  "bank_addr": "Manila",
  "acct_number": "09959350888",
  "acct_name": "BAOJUNTANG",
  "chnl": "PHP_WD",
  "extra": "",
  "ts": "1785138705251", 
  "sign": "9a9cba23f9075ff01b2ed2050f52f42d"
}

关于 data 字段

对于部分国家可能要求KYC的情况.会在现有的提现账户/银行的基础之上.补充一些额外的信息.可能如下

"data":{
    "first_name":"FIRSTNAME",
    "last_name":"LASTNAME",
    "phone":"phonenumber",
    "email":"email@email",
    "user_id":"u123"
}

关于上述user_id字段.长度限制64 位. 和入款处的user_id字段保持一致. 如果入款处user_id和对应的名称等信息与出款处的信息不一致.出款/代付将被锁定

返回参数

字段名	变量名	类型	描述
状态码	`code`	number	响应码，`0` 表示成功
响应数据	`data`	object	响应数据对象
─ 商户号	`data.mcode`	string	商户 ID
─ 平台订单号	`data.sn`	string	平台订单号
─ 商户订单号	`data.tno`	string	商户订单号
─ 金额	`data.amt`	string	订单金额
─ 手续费	`data.fee`	string	手续费
─ 货币	`data.cur`	string	货币代码
─ 订单状态	`data.sts`	string	订单状态
─ 渠道编码	`data.chnl`	string	渠道编码
─ 创建时间	`data.ctm`	string	创建时间
─ 签名	`data.sign`	string	返回签名

返回示例

{
  "code": 0,
  "data": {
    "mcode": "M10086",
    "sn": "W202608020001",
    "tno": "W202608020001",
    "amt": "500.26",
    "fee": "2.00",
    "cur": "PHP",
    "sts": "submit",
    "chnl": "PHP_WD",
    "ctm": "2026-08-02T12:00:01+08:00",
    "sign": "xxxx"
  }
}

代付自动测试特殊金额

处于测试分组时(上线前)，通过提交特殊金额来自动触发回调的不同状态.除了以下金额之外的满足条件的的金额都会自动回调成功

测试场景说明

场景	触发行为
Error Test	提交后立即返回系统错误（return error）
Callback Fail	提交成功受理，但异步回调通知时返回失败状态 `WS_FAIL`

各货币对应测试金额

货币代码	符号	Error Test	Callback Fail	说明
PHP	₱	123	321	菲律宾比索（默认值）
THB	฿	123	321	泰铢
INR	₹	12300	32100	印度卢比
BDT	৳	12300	32100	孟加拉塔卡
PKR	₨	12300	32100	巴基斯坦卢比