5.1.2 创建提款数字币至任意钱包（商户自定义汇率）

#简要描述：将数字币提现到钱包的提现业务接口，让用户能够将 usdt 转移到指定的钱包地址（商户自定义汇率，需登录商户后台设置）

请求方式: POST
请求接口: https://网关域名/wallet-trade-merchant/v1/pay/blockchain/custom/rate/create
请求媒体类型( JSON 数据格式 )Content-Type: application/json

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	apiKey
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户ID	商户平台本地用户ID
notifyUrl	string	否	回调地址	下单成功后，由 API 回调请求通知商户的地址 (回调详情说明在最下方）
successRedirectUrl	string	否	地址	成功后自动跳转地址
currency	string	是	币种	订单币种
network	string	是	主网	主网(目前仅支持TRON、BSC、POLYGON、ETHEREUM)
address	string	是	提款地址	提款地址
quoteCurrency	string	是	订单报价币种	订单报价币种（需登录商户后台设置报价币种汇率）
quoteAmount	string	是	报价金额	报价金额
isBlockchain	boolean	否	是否返回区块链信息（默认false）	当为true时，回调请求会携带订单链上交易信息
expireSecond	Long	否	过期时间戳（秒）
sign	string	是	签名	详情见签名算法

请求 json 样例

{
  "key": "9yUreYgTRtit39Dy",
  "localOrderId":"conantest0128",
  "localUserId":"996",
  "currency":"USDT",
  "network":"TRON",
  "address":"TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
  "quoteCurrency":"CNY",
  "quoteAmount":"20",
  "sign":"f0ef4f925b899734727b77975ff9c0a3"
}

响应 json 示例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
     "orderId": 473228783386885,
     "localUserId": "996",
     "localOrderId": "conantest0128",
     "orderType": "WITHDRAW",
     "orderBizType": "WITHDRAW_ANY_DIGITAL_WALLET",
     "targetType": "EXTERNAL",
     "network": "TRON",
     "address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
     "currency": "CNY",
     "userCurrency": "USDT",
     "amount": "20",
     "userAmount": "20",
     "userReceivableAmount": "20",
     "rate": "1",
     "rateExpression": "1USDT≈1CNY"
     }
}

响应data 参数说明

参数名称	类型	参数含义	备注
orderId	string	订单 ID
localUserId	string	商户本地用户 ID
localOrderId	string	商户本地订单号
orderType	enum	订单类型	`PAYMENT：支付订单 \| WITHDRAW：提款订单`
orderBizType	enum	订单业务类型	orderBizType 类型说明如下
targetType	enum	目标类型	targetType 类型说明如下
network	string	主网类型
address	string	地址	链上收款地址
currency	string	订单币种
userCurrency	string	到账币种
amount	string	订单金额
userAmount	string	用户实收金额
userReceivableAmount	string	用户应收金额
rate	string	汇率
rateExpression	string	汇率表达式

orderBizType 类型说明：

1、PAYMENT_WALLET_SCAN VAPY钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至VAPY钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付

targetType 类型说明：

1、INTERNAL 内部地址
2、EXTERNAL 外部地址
3、USER 用户抽象地址

回调详情说明

回调的方式是：POST application/json

回调参数 json 化示例

{
"amount":"10",
"bizType":"WITHDRAW_ANY_DIGITAL_WALLET",
"currency":"CNY",
"extra":{
     "quoteAmount":"10",
     "quoteCurrency":"CNY",
     "quotePrice":"1"
        },
"localOrderId":"conantest0132",
"merchantActualAmount":"94.63",
"merchantCurrency":"CNY",
"merchantId":302992856974,
"merchantPaidAmount":"66.84",
"merchantUserId":"996",
"notifyTime":1772266852130,
"orderCreateTime":1772266745032,
"orderId":"473284157243653",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"8.5",
"userCurrency":"USDT",
"userMinerFee":"1.5",
"userReceivableAmount":"10",
"sign":"78ef83b365e77c66b0cc3a283f8ebae4",
"key":"9yUreYgTRtit39Dy"
}

参数名称	类型	参与签名	参数含义	参数说明
amount	decimal	是	订单金额
bizType	enum	是	订单类型	bizType 类型说明如下
currency	String	是	币种
key	String	是	商户 key
localOrderId	String	是	本地订单号
merchantActualAmount	decimal	是	商户实际收款金额
merchantCurrency	String	是	商户收款币种	默认币种
merchantId	String	是	商户号
merchantPaidAmount	decimal	是	商户收款金额
merchantUserId	String	是	用户 id
notifyTime	long	是	回调时间
orderCreateTime	long	是	订单创建时间
orderId	String	是	订单号
status	String	是	支付状态
type	String	是	订单类型	`PAYMENT:支付 WITHDRAW：提款`
userAmount	decimal	是	用户付款金额
userCurrency	String	是	用户支付币种
sign	String	否	md5 签名	详情看签名算法
extra	object	是	包含一下参数
└quoteAmount	number	是	订单报价金额
└quoteCurrency	number	是	订单报价币种
└quotePrice	string	是	订单报价价格
userMinerFee	String	是	矿工费	提款矿工费
userReceivableAmount	String	是	用户应收金额	用户应收金额
blockchain	object	是	链交易信息	当下单请求参数isBlockchain为true，回调请求会携带此对象信息。（只涉及链上交易时，isBlockchain参数会生效）
└network	String	是	主网
└receiverAddress	String	是	接收地址
└senderAddress	decimal	是	发送地址
└txId	String	是	交易ID

bizType 类型说明：

当您收到回调通知后，请在处理完成后直接返回字符串 success，表示已成功接收并处理该消息。系统在收到 success 响应后，将不再对该笔回调进行重复发送。若未收到期望响应（未返回 success 或返回异常），系统将按照阶梯式重试机制重新发送回调通知，最多重试 14 次。当前重试时间间隔依次为： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s

请求参数​

请求 json 样例​

响应data 参数说明​

orderBizType 类型说明：​

targetType 类型说明：​

回调详情说明​

回调的方式是：POST application/json​

回调参数 json 化示例​

bizType 类型说明：​