6.3.2 创建数字币限定金额扫码支付订单（商户自定义汇率）

#简要描述：数字币充值业务接口，用户通过扫描二维码的方式将 USDT（Tether）充值到他们的数字钱包账户

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

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	平台分配商户 key
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户ID	商户平台本地用户ID
notifyUrl	string	否	回调地址	下单成功后，由 API 回调通知商户的地址（回调详情说明在最下方）
successRedirectUrl	string	否	跳转地址	成功后自动跳转地址
userCurrency	string	是	币种	需要用户支付的币种(钱包支持数字币种)
quoteCurrency	string	是	自定义报价币种	自定义报价币种（需商户登录后台设置报价币种汇率）
quoteAmount	number	是	自定义报价金额	订单计价金额
isBlockchain	boolean	否	是否返回区块链信息（默认false）	当为true时，回调请求会携带订单链上交易信息
sign	string	是	签名	详情见签名算法

请求 json 样例

{
"key": "dNNTJZpgFVWlYrVv",
"localOrderId":"1112211112222",
"userCurrency":"USDT",
"quoteCurrency":"CNY",
"quoteAmount":"5",
"sign":"1d3c83050070c7303198d924eca997c2"
}

支付返回 json 格式

返回 data 示例

{
"code": 0,
"success": true,
"message": null,
"data": {
"orderId": 273719658252612,
"localUserId": null,
"localOrderId": "1112211112222",
"orderType": "PAYMENT",
"orderBizType": "PAYMENT_FIXED_DIGITAL_SCAN",
"paymentUrl": "https://walletapi.minpayapp.com/fixed-amount-pay/NE6SAVpD9Fpa7ArsYh5yBvpkgmGxHNoHBWqB43sQNabFD4w191prwJFGryyN",
"publicKey": "NE6SAVpD9Fpa7ArsYh5yBvpkgmGxHNoHBWqB43sQNabFD4w191prwJFGryyN",
"addresses": {
              "BSC": "0x57137b3dB3a583e15A9Fb39685cd770FEd7FC464",
              "TRON": "TYyVvtfuzREyFkDUfJ75rFL9SaXSKyRbCB"
              }
         }
}

返回的 paymentUrl 弹出支付页面，如下图：

data 参数说明

参数名称	类型	必填	参数含义	备注
orderId	string	是	订单 ID
localUserId	string	是	商户本地用户 ID
localOrderId	string	是	商户本地订单号
orderType	enum	是	订单类型	`PAYMENT:支付订单 \| WITHDRAW:提款订单`
orderBizType	enum	是	订单业务类型	orderBizType 类型说明如下
paymentUrl	string	是	支付地址
publicKey	string	是	密钥	公共访问密钥
addresses	object	是	链地址

orderBizType 类型说明：

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

回调详情说明

回调的方式是：POST application/json

回调参数 json 化示例

{
  "amount": 1,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "blockchain":{
      "network":"TRON",
      "receiverAddress":"TA1jptT16DssYWVGdVyFWxonku6hWK7En3",
      "senderAddress":"TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
      "txId":"24d0d0e5d417bd2195c45d64724760ae47fc3b359ee31c5fedf25b40f3584b36"
       },
  "currency": "USDT",
  "extra": {
    "quoteAmount": 10,
    "quoteCurrency": "CNY",
    "quotePrice": 10
  },
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 22.72,
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 7.33,
  "notifyTime": 1736744168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "WITHDRAW",
  "userAmount": 1,
  "userCurrency": "USDT"
}

参数名称	类型	参与签名	参数含义	参数说明
amount	decimal	是	订单金额
bizType	enum	是	订单类型	bizType 类型说明如下
blockchain	object	是	链交易信息	当下单请求参数isBlockchain为true，回调请求会携带此对象信息。（只涉及链上交易时，isBlockchain参数会生效）
└network	String	是	主网
└receiverAddress	String	是	接收地址
└senderAddress	decimal	是	发送地址
└txId	String	是	交易ID
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	是	订单报价价格

bizType 类型说明：

如果您接受到了回调信息，只需要返回success，即表示消息已处理，本条回调不再会发送，否则会尝试重复发送直到获得期望的响应，目前的重试频率为15s, 15s, 30s, 180s, 600s, 1200s, 1800s，都无响应后，不再重复发送。

请求参数​

请求 json 样例​

返回 data 示例​

data 参数说明​

orderBizType 类型说明：​

回调详情说明​

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

回调参数 json 化示例​

bizType 类型说明：​