跳到主要内容

出金申请

用于发起出金

请求地址

  • 接口地址(requestURI): /openapi/v1/withdrawal/request

请求参数

参数名称类型出现要求描述
trackingIdStringR商户跟踪id, 各个商户的每次交易操作应保证唯一
assetTypeIntegerR资产类型,[0:加密货币,1:法定货币]
userSelectableIntegerR已作废,默认为0,不用传输 用户是否可选,[0:否,1:是]. 可选时:金额,资产名称/币种,网络类型/支付类型等字段可先不填,由收银页提交时指定
assetNameStringR资产名称/币种
netProtocolStringR网络类型/支付类型
bankCodeStringC银行代码, 某些币种的支付类型需要
bankNameStringC银行名称, IDR币种需要
accountNameStringC持卡人姓名, IDR币种需要
bankNumStringCIFSCcode, INR币种需要,叫印度金融系统代码
amountBigDecimalR金额
addressStringR出金地址, 要把钱支付给谁,如BTC地址、ETH地址、银行卡号等
webhookUrlStringR通知回调地址/webhook url
remarkStringO交易备注,不能超过255, 在交易中加入一些额外的数据或标识,如订单号等,接口会原样返回
text1StringO文本1, 仅用于收银页面显示,不参与支付, 例: 1000
text2StringO文本2, 仅用于收银页面显示,不参与支付, 例: $1000
text3StringO文本3, 仅用于收银页面显示,不参与支付, 例: Mfedfring
text4StringO文本4, 仅用于收银页面显示,不参与支付, 例: 1USD = 1038KRW
userIdStringR用户id
userIpStringO用户ip地址

请求示例

{
"trackingId": "20220408123456789",
"assetType": 1,
"assetName": "USD",
"netProtocol": "bank",
"bankCode": "BOC",
"bankName": "中国银行",
"accountName": "张三",
"bankNum": "123456",
"amount": 100,
"address": "123456",
"webhookUrl": "https://yourdomain.com/webhook",
"remark": "Withdrawal",
"text1": "100",
"text2": "$100",
"text3": "Mfedfring",
"text4": "1USD = 1038KRW",
"userId": "123456",
"userIp": "127.0.0.1"
}

响应参数

参数名称类型出现要求描述
trackingIdStringR商户跟踪id
redirectPageUrlStringO重定向的支付页面地址, 如果有,请跳转到该地址进行出金/提款
remarkStringO交易备注, 在交易中加入一些额外的数据或标识,如订单号等,接口会原样返回

响应示例

{
"code": 200,
"msg": "操作成功",
"data": {
"trackingId": "20220408123456789",
"redirectPageUrl": "https://yourdomain.com/withdrawal",
"remark": "Withdrawal"
}
}