5.1.2 Crear un retiro de moneda digital a cualquier billetera (tipo de cambio definido por el comerciante)

#Breve descripción: retire moneda digital a la interfaz comercial de retiro de la billetera, lo que permite a los usuarios transferir usdt a la dirección de billetera especificada (El tipo de cambio definido por el comerciante requiere iniciar sesión en el backend del comerciante para configurarlo)

Método de solicitud: POST
Interfaz de solicitud: https://gateway-domain/wallet-trade-merchant/v1/pay/blockchain/custom/rate/create
Solicitar tipo de medio (formato de datos JSON) Tipo de contenido: aplicación/json

Parámetros de solicitud

Nombre del parámetro	Tipo	Obligatorio	Significado del parámetro	Descripción del parámetro
`key`	`string`	Sí	Clave de comerciante	apiKey
`localOrderId`	`string`	Sí	Número de pedido local de la plataforma comercial	La plataforma comercial genera un número de pedido único a nivel local
`localUserId`	`string`	No	ID de usuario local de la plataforma comercial	ID de usuario local de la plataforma comercial
`notifyUrl`	`string`	No	Dirección de devolución de llamada	Una vez realizado el pedido con éxito, la dirección del comerciante será notificada mediante la solicitud de devolución de llamada API (los detalles de la devolución de llamada se encuentran en la parte inferior)
`successRedirectUrl`	`string`	No	Dirección	Saltar automáticamente a la dirección después del éxito
`currency`	`string`	Sí	Moneda	Moneda del pedido
`network`	`string`	Sí	Red principal	Mainnet (actualmente solo admite TRON, BSC, POLYGON, ETHEREUM)
`address`	`string`	Sí	Dirección de retiro	Dirección de retiro
`quoteCurrency`	`string`	Sí	Moneda de cotización del pedido	Moneda de cotización del pedido (debe iniciar sesión en el backend del comerciante para establecer el tipo de cambio de la moneda de cotización)
`quoteAmount`	`string`	Sí	Monto de la cotización	Monto de la cotización
`isBlockchain`	`boolean`	No	Ya sea para devolver información de blockchain (falso predeterminado)	Cuando sea verdadero, la solicitud de devolución de llamada llevará la información de la transacción en la cadena de pedidos
`expireSecond`	`Long`	No	Marca de tiempo de vencimiento (segundos)
`sign`	`string`	Sí	Firma	Consulte Algoritmo de firma para obtener más detalles

Solicitar muestra json

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

Ejemplo de respuesta 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"
     }
}

Descripción del parámetro de datos de respuesta

Nombre del parámetro	Tipo	Significado del parámetro	Observaciones
`orderId`	`string`	ID de pedido
`localUserId`	`string`	ID de usuario local del comerciante
`localOrderId`	`string`	Número de pedido local del comerciante
`orderType`	`enum`	Tipo de pedido	`PAYMENT：支付订单 \| WITHDRAW：提款订单`
`orderBizType`	`enum`	Tipo de negocio de pedido	La descripción del tipo orderBizType es la siguiente
`targetType`	`enum`	Tipo de objetivo	La descripción del tipo targetType es la siguiente
`network`	`string`	Tipo de red principal
`address`	`string`	Dirección	Dirección de pago en cadena
`currency`	`string`	Moneda del pedido
`userCurrency`	`string`	Moneda de llegada
`amount`	`string`	Importe del pedido
`userAmount`	`string`	Importe pagado por el usuario
`userReceivableAmount`	`string`	Importe por cobrar del usuario
`rate`	`string`	Tipo de cambio
`rateExpression`	`string`	Expresión del tipo de cambio

descripción del tipo orderBizType:

PAYMENT_WALLET_SCAN Pago con código de escaneo de billetera MINPAY
PAYMENT_TRANSFER depósito directo de dirección vinculante de moneda digital
PAYMENT_ANY_DIGITAL_SCAN Escanee el código QR para pagar cualquier cantidad de moneda digital
FROMDRAW_WALLET retirar dinero a la billetera MINPAY
FROMDRAW_ANY_DIGITAL_WALLET Retirar moneda digital a cualquier billetera
PAYMENT_FIXED_DIGITAL_SCAN pago con código de escaneo de cantidad limitada en moneda digital
BATCH_PAY pago por lotes

descripción del tipo targetType:

INTERNO dirección interna
EXTERNA dirección externa
Dirección abstracta del usuario USUARIO

Detalles de devolución de llamada

El método de devolución de llamada es: aplicación POST/json

Ejemplo de jsonización de parámetros de devolución de llamada

{
"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"
}

Nombre del parámetro	Tipo	Firma participante	Significado del parámetro	Descripción del parámetro
`amount`	`decimal`	Sí	Monto del pedido
`bizType`	`enum`	Sí	Tipo de pedido	La descripción del tipo bizType es la siguiente
`currency`	`String`	Sí	Moneda
`key`	`String`	Sí	Clave de comerciante
`localOrderId`	`String`	Sí	Número de pedido local
`merchantActualAmount`	`decimal`	Sí	Monto de pago real del comerciante
`merchantCurrency`	`String`	Sí	Moneda de pago comercial	Moneda predeterminada
`merchantId`	`String`	Sí	Identificación del comerciante
`merchantPaidAmount`	`decimal`	Sí	Monto del pago al comerciante
`merchantUserId`	`String`	Sí	Identificación de usuario
`notifyTime`	`long`	Sí	Tiempo de devolución de llamada
`orderCreateTime`	`long`	Sí	Hora de creación del pedido
`orderId`	`String`	Sí	Número de pedido
`status`	`String`	Sí	Estado de pago
`type`	`String`	Sí	Tipo de pedido	`PAYMENT:支付 WITHDRAW：提款`
`userAmount`	`decimal`	Sí	Monto del pago del usuario
`userCurrency`	`String`	Sí	Moneda de pago del usuario
`sign`	`String`	No	firma md5	Ver algoritmo de firma para más detalles
`extra`	`object`	Sí	Contiene los siguientes parámetros
└Cantidad de cotización	`number`	Sí	Importe de la cotización del pedido
└citaMoneda	`number`	Sí	Moneda de cotización del pedido
└presupuestoPrecio	`string`	Sí	Precio de cotización del pedido
`userMinerFee`	`String`	Sí	Tarifa minera	Tarifa minera de retiro
`userReceivableAmount`	`String`	Sí	Importe por cobrar del usuario	Importe por cobrar del usuario
`blockchain`	`object`	Sí	Información de transacciones en cadena	Cuando el parámetro de solicitud de pedido esBlockchain es verdadero, la solicitud de devolución de llamada llevará la información de este objeto. (Cuando solo se trata de transacciones en cadena, el parámetro isBlockchain entrará en vigor)
└red	`String`	Sí	Red principal
└dirección del receptor	`String`	Sí	Dirección del destinatario
└Dirección del remitente	`decimal`	Sí	Dirección de envío
└txId	`String`	Sí	ID de transacción

descripción del tipo bizType:

PAYMENT_WALLET_SCAN Pago con código de escaneo de billetera MINPAY
PAYMENT_TRANSFER depósito directo de dirección vinculante de moneda digital
PAYMENT_ANY_DIGITAL_SCAN Escanee el código QR para pagar cualquier cantidad de moneda digital
FROMDRAW_WALLET retirar dinero a la billetera MINPAY
FROMDRAW_ANY_DIGITAL_WALLET Retirar moneda digital a cualquier billetera
PAYMENT_FIXED_DIGITAL_SCAN pago con código de escaneo de cantidad limitada en moneda digital
BATCH_PAY pago por lotes

Cuando reciba la notificación de devolución de llamada, devuelva directamente la cadena éxito después de que se complete el procesamiento, lo que indica que el mensaje se recibió y procesó exitosamente. Después de que el sistema reciba la respuesta exitosa, ya no enviará la devolución de llamada repetidamente. Si no se recibe la respuesta esperada (no se devuelve el éxito o se devuelve una excepción), el sistema reenviará la notificación de devolución de llamada de acuerdo con el mecanismo de reintento escalonado, reintentando hasta 14 veces. Los intervalos de reintento actuales son: 15, 15, 30, 180, 600, 1200, 1800, 1800, 1800, 3600, 10800, 10800, 21600, 21600

Parámetros de solicitud​

Solicitar muestra json​

Descripción del parámetro de datos de respuesta​

descripción del tipo orderBizType:​

descripción del tipo targetType:​

Detalles de devolución de llamada​

El método de devolución de llamada es: aplicación POST/json​

Ejemplo de jsonización de parámetros de devolución de llamada​

descripción del tipo bizType:​