Gate Pay Documentación de la API de Notificación de Callback: https://docs.gate.com/api-reference/version/100/en/common/asyncNotification
Interpretación de la información de estado en los callbacks de pago
Tipo de dirección dinámica
1. Notificación de abono de fondos por pago a dirección dinámica (biztype = TRANSFER_ADDRESS)
TRANSFERRED_ADDRESS_IN_TERM: Los fondos se abonan al instante dentro del periodo de validez del pedido.
TRANSFERRED_ADDRESS_DELAY: Si el pago se abona después del periodo de validez, el importe realmente pagado se abonará en la cuenta de saldo del comerciante (abono instantáneo tras el periodo de validez).
2. Notificación de cambio de estado de pedido por pago a dirección dinámica (biztype = PAY_ADDRESS)
PAY_SUCCESS: Pago realizado con éxito.
PAY_CLOSE: Pedido expirado.
PAY_EXPIRED_IN_PROCESS: Pendiente de confirmación de fondos en la blockchain.
Tipo de dirección estática
1. Pago exitoso a dirección estática (biztype=PAY_FIXED_ADDRESS)
PAY_SUCCESS: Pago realizado con éxito y fondos abonados.
2. Dirección estática marcada como dirección de riesgo (biztype=FIXED_ADDRESS_RISK)
RISK_ADDRESS: La dirección estática ha sido marcada como dirección de riesgo.
Tipo de pago a dirección anómala
Para cada transacción de pago anómala, Gate Pay enviará una notificación webhook al comerciante correspondiente.
El bizType para este tipo de pago será siempre PAY_UNRESOLVED.
Los comerciantes deben identificar el problema de facturación según el campo errorType en los datos y consultar la Guía de gestión de pagos anómalos de Gate Pay o contactar con su gestor de cuenta de Gate Pay.
- address_risk_address
— Dirección dinámica de alto riesgo - address_error_currency
— Moneda incorrecta para dirección dinámica - address_error_chain
— Red blockchain incorrecta para dirección dinámica - fix_error_currency
— Moneda incorrecta para dirección estática - fix_error_chain
— Red blockchain incorrecta para dirección estática - fix_risk_address
— Dirección estática de alto riesgo - fix_delete
— Dirección estática eliminada - fix_partial_delete
— Dirección estática eliminada parcialmente
Sobre la información de callback para pagos a direcciones dinámicas
¿Por qué existen dos tipos de información de callback de pago?
- Notificación de abono de fondos (TRANSFER_ADDRESS): Notifica el importe realmente abonado.
- Notificación de cambio de estado del pedido (PAY_ADDRESS): Notifica los cambios en el estado del pedido.
Los comerciantes deben utilizar ambos tipos de información para determinar si un pedido se ha completado correctamente y así proceder con la entrega o gestionar pedidos fallidos.
¿Cuándo se envían las notificaciones de callback?
- Notificación de abono de fondos: Tras la confirmación en la blockchain de un pago exitoso, los fondos se abonan en tiempo real al comerciante y se envía un callback.
- Notificación de cambio de estado del pedido: Se activa cuando cambia el estado del pedido.
Escenarios de pago con dirección dinámica y determinación del estado del pedido
1. Pago único completo o superior dentro del periodo de validez
Descripción: Siempre que el usuario pague la totalidad o más del importe del pedido dentro del periodo de validez, se envía un callback en tiempo real tras la confirmación en la blockchain.
Estado del pedido: Inicialmente, el sistema espera la confirmación de fondos en la blockchain y envía un callback con un estado intermedio: bizStatus es PAY_EXPIRED_IN_PROCESS. Tras la confirmación en la blockchain, el pedido se considera exitoso y se envía un callback con bizStatus como PAY_SUCCESS y el importe abonado en doneAmountOnChain.
Notificación de abono de fondos: bizStatus es TRANSFERRED_ADDRESS_IN_TERM, importe abonado en transferAmount.
2. Pago inferior al importe del pedido dentro del periodo de validez
Descripción: Si el usuario paga menos del importe del pedido dentro del periodo de validez, tras la confirmación en la blockchain, el importe realmente pagado se abona al comerciante y se envía un callback de abono de fondos en tiempo real.
Estado del pedido: Dentro del periodo de validez, el estado del pedido no cambia y no se envía callback de estado de pedido.
Notificación de abono de fondos: bizStatus es TRANSFERRED_ADDRESS_IN_TERM, importe abonado en transferAmount.
3. Pago inferior al importe del pedido dentro del periodo de validez, sin completar el importe
Descripción: Si el usuario paga menos del importe del pedido dentro del periodo de validez y no completa la diferencia durante dicho periodo.
Estado del pedido: Al finalizar el periodo de validez, se envía un callback de estado de pedido. bizStatus es PAY_CLOSE, importe abonado en doneAmountOnChain.
Notificación de abono de fondos: El callback de abono de fondos ya se envió tras el pago y no se enviará de nuevo.
4. Pago inferior al importe del pedido dentro del periodo de validez, luego se completa el importe
4.1 Completar el pago dentro del periodo de validez:
Tras completar el usuario el importe restante:
Estado del pedido: El sistema espera la confirmación en la blockchain y envía un callback con estado intermedio: bizStatus es PAY_EXPIRED_IN_PROCESS.
Notificación de abono de fondos: No se envía notificación de abono de fondos mientras se espera la confirmación en la blockchain del pago complementario.
Tras la confirmación en la blockchain:
Estado del pedido: Una vez confirmados los fondos en la blockchain y el importe total es suficiente, el pedido se considera exitoso. bizStatus es PAY_SUCCESS, importe abonado en doneAmountOnChain (suma de todos los pagos).
Notificación de abono de fondos: bizStatus es TRANSFERRED_ADDRESS_IN_TERM, importe abonado en transferAmount.
4.2 Completar el pago después del periodo de validez:
Estado del pedido: Como no se pagó el importe completo dentro del periodo de validez, al finalizar dicho periodo se envía un callback de estado de pedido. bizStatus es PAY_CLOSE, importe abonado en doneAmountOnChain.
Notificación de abono de fondos: El callback de abono de fondos ya se envió tras el pago y no se enviará de nuevo.
Si el usuario completa el importe restante después del periodo de validez: se envía un callback de abono de fondos con bizStatus como TRANSFERRED_ADDRESS_DELAY, importe abonado en transferAmount. (En este caso, no se envía ningún callback adicional de estado de pedido y el callback final no incluye el campo doneAmountOnChain. Si el usuario completa el pago mediante varias transacciones, el comerciante debe sumar todos los valores de transferAmount de los callbacks para confirmar el importe total abonado).
5. Pago expirado
Descripción: Si el usuario paga después del periodo de validez del pedido, ya sea parcial, total o en exceso, los fondos se abonan en tiempo real tras la confirmación en la blockchain.
Cambio de estado del pedido: Como no se realizó ningún pago durante el periodo de validez, se envía un callback con bizStatus como PAY_CLOSE al finalizar dicho periodo.
Abono de fondos: No hay notificación de abono de fondos.
Pago tras la expiración: Después de la expiración, por cada pago realizado, se envía una notificación de abono de fondos con bizStatus como TRANSFERRED_ADDRESS_DELAY, importe abonado en transferAmount. (En este caso, no se envía ningún callback adicional de estado de pedido y el callback final no incluye el campo doneAmountOnChain. Si el usuario completa el pago mediante varias transacciones, el comerciante debe sumar todos los valores de transferAmount de los callbacks para confirmar el importe total abonado).
Los comerciantes deben utilizar tanto la información de estado de pedido como la de abono de fondos en los callbacks para determinar si el pedido fue exitoso.
6. Información de callback de pedido anómalo para pagos a direcciones dinámicas
6.1 Pago con una moneda o red blockchain diferente a la del pedido
El comerciante recibirá un callback con Biztype=PAY_UNRESOLVED y data.errorType=address_error_currency o address_error_chain.
6.2 Fondos marcados como de riesgo e interceptados
El comerciante recibirá un callback con biztype=PAY_UNRESOLVED y data.errorType=address_risk_address.
Sobre la información de callback para direcciones estáticas
1. Pago exitoso abonado
Se recibirá una notificación PAY_SUCCESS, indicando que el pago fue exitoso y los fondos han sido abonados.
2. Callback de pago anómalo
2.1 Pago con una moneda/red diferente a la del pedido
El comerciante recibirá un callback con biztype=PAY_UNRESOLVED y data.errorType=fix_error_currency o fix_error_chain.
2.2 Fondos de riesgo
El comerciante recibirá un callback con biztype=PAY_UNRESOLVED y data.errorType=fix_risk_address.
2.3 Pago enviado a una dirección estática eliminada
El comerciante recibirá un callback con biztype=PAY_UNRESOLVED y data.errorType=fix_delete o fix_partial_delete.
3. Notificación de riesgo de dirección estática
Se recibirá una notificación con bizType=FIXED_ADDRESS_RISK y bizStatus=RISK_ADDRESS, indicando que la dirección estática de recepción vinculada al comerciante ha sido identificada como dirección de riesgo. Los comerciantes deben eliminar inmediatamente la dirección estática correspondiente. Si los usuarios siguen realizando pagos a esta dirección, los fondos no serán abonados.
Descargo de responsabilidad
El contenido aquí proporcionado es solo para fines de referencia y educativos, y no constituye asesoramiento financiero, de inversión, comercial ni legal, ni constituye una oferta o solicitud para comprar o vender activos digitales. Gate no realiza declaraciones ni garantías, expresas o implícitas, sobre la exactitud, integridad o actualidad de la información contenida en este documento. Las características del producto, interfaces, normas y estructuras de tarifas pueden actualizarse o modificarse en cualquier momento. Consulta los comunicados más recientes y la información que aparece en la plataforma de Gate para obtener los detalles más precisos.
Las inversiones en activos digitales implican un riesgo significativo y los precios pueden fluctuar considerablemente. Podrías perder la totalidad de tu inversión. Toma decisiones con cautela en función de tu situación financiera y tolerancia al riesgo, una vez que hayas comprendido plenamente los riesgos asociados. Si es necesario, te recomendamos consultar con un asesor financiero o legal independiente.
Para más información sobre los posibles riesgos, consulta la Divulgación de riesgos y el Acuerdo de usuario de Gate.
