Appearance
申请提现
说明:提现只能提资金账户里面的余额 (FUND_ACCOUNT),提现前请先查询账户余额是否充足以及核算好当前流水是否正确
公共参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| mch_no | String | 是 | 32 | 商户号 | 2014072300007148 |
| sub_mch_no | String | 否 | 32 | 子商户号 | 100123456 |
| method | String | 是 | 128 | 接口名称,固定传 trade.apply.withdraw | trade.apply.withdraw |
| charset | String | 是 | 10 | 调用的接口版本,固定为:utf-8 | utf-8 |
| sign_type | String | 是 | 10 | 商户生成签名字符串所使用的签名算法类型,目前支持 RSA | RSA 或 rsa |
| sign | String | 是 | 344 | 商户请求参数的签名串 | 详见示例 |
| timestamp | String | 是 | 19 | 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" | 2014-07-24 03:07:50 |
| version | String | 是 | 3 | 调用的接口版本,固定为:1.0 | 1.0 |
| notify_url | String | 否 | 200 | 提现的通知,异步通知地址,200 个字符之内,建议必传 | http://localhost/notify.html |
| biz_content | String | 是 | 业务参数 |
业务参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| withdraw_out_trade_no | String | 是 | 64 | 商户提现请求号,唯一 | 20150320010101001 |
| bank_account_no | String | 是 | 64 | 提现账号 (查询提现卡接口面的 accountNo 参数) | 28566151621 |
| type | String | 是 | 64 | 类型:REAL_TIME 实时,TWO_HOUR 2 小时,NEXT_DAY 次日上午 7 点左右;合利宝只接收REAL_TIME类型 | REAL_TIME |
| amount | String | 是 | 12 | 提现金额,2 位小数,单位元 | 100.22 |
| institution_code | String | 否 | 64 | 机构编码,例如鲲鹏传 KunPeng;申请合利宝机构的提现传 HeLiBao | KunPeng |
| third_merchant_no | String | 否 | 64 | 机构编码使用HeLiBao时,该参数为必填项,传值为合利宝账户余额查询接口中返回的account参数值 | E1809288888 |
返回信息
json
返回结果示例:
{
"code": 20000,
"msg": "success",
"withdraw_out_trade_no": "111111",
"withdraw_trade_no": 626015783370903553,
"merchant_no": "21796110752682",
"withdraw_status": "WITHDRAW_SUCCESS",
"withdraw_type": "REAL_TIME",
"withdraw_create_time": 1710213793,
"withdraw_amount": "1.00",
"receive_amount": "1.00",
"debit_amount": "1.50",
"finish_time": "2024-03-12 11:23:15",
"sign": "cJBwabpleVdXUgJuEb9kvGTQSWg6ByL6dC3IFamxaB/TrfCxyT4q8s+RJHgL6Cdzp4f81678d+PKJiG/+nIKJ0Zl1+I7PGIcDWfIukVFz/uAb2JCMqoU0ggmWfNErs4Zi67wYciKoP1rnr5A7lhAOqhPGQRJlX7Mytyykoaf/vf4ePYpIymridP/49k3THFuFm1ECLEw/olLXSrsyPewoE7cEl8DbqUYxlPjpJYL+0PBkU0aSXHdpiwVnfQ8GOjCgA2v6UmVB1Jt7CwjMRSULN0pWJSJKrUNFFr7YnjcQQbTR6srsj3Srouv1K/WjfNIEnSqjSBlwuCfJkc9FG69lQ=="
}返回字段说明
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 20000 |
| msg | String | success |
| status | String | WITHDRAW_REMITING (处理中), WITHDRAW_FAILED (提现失败),WITHDRAW_ACCEPT(已受理), WITHDRAW_PENDING(等待中),WITHDRAW_SUCCESS(提现成功,已到卡);除了失败状态可以再次申请提现,其他状态不要再次申请提现,等待这次申请走完流程,另外提现是否到账在提现通知接口通知或者主动查询提现接口。 |
| withdraw_out_trade_no | String | 商户的提现单号 |
| withdraw_trade_no | String | 鸿闻的提现单号 |
| withdraw_amount | String | 申请的提现金额 |
| receive_amount | String | 到账金额 |
| debit_amount | String | 扣款金额(扣款金额 = 到账金额 + 手续费) |
| finish_time | String | 提现成功或者失败的时间 |
| sign | String | 签名字符串 |
