Webhook

Webhook de Notificación al Comercio

Descripción: El propósito del webhook es notificar al comerciante sobre la actualización en tiempo real de los estados de los pagos entrantes. Recomendamos interpretar correctamente los tipos de estados para evitar comportamientos no deseados.

URL del Webhook: La URL de notificación proporcionada por el comerciante. Esta URL debe ser colocada en tu panel de administración en la configuración del dispositivo. Los webhooks se proporcionan por dispositivo.

Metodo API: POST

Header: Los siguientes campos están incluidos:

○ ‘X-NONCE’: Unix Timestamp.
○ ‘X-SIGNATURE’: hexadecimal(hmac_sha256(merchant_secret_key, nonce + body)).

Importante: Para verificar que la información del cuerpo es correcta, el comerciante debe crear una firma con la fórmula previamente mostrada y compararla con la X-SIGNATURE recibida en el encabezado. También se recomienda rechazar la información del cuerpo si ha transcurrido un tiempo de 15/20 segundos desde el Unix Timestamp.

Datos de salida: JSON con toda la información del pago. Ejemplo:

{  
   "fiat_amount": 5.0,
   "status": "AC",
   "crypto_amount": 0.06519511,
   "unconfirmed_amount": 0.770000002,
   "confirmed_amount": 0.0,
   "currency": "DASH",
   "identifier": "cc80e0b5-f779-4094-be65-fcee4b5bd041"
}

X-SIGNATURE verificación

Body ejemplo:

{ 
   "fiat_amount": 100.0,
   "status": "AC",
   "crypto_amount": 1.21461894,
   "unconfirmed_amount": 8.0,
   "confirmed_amount": 0.0,
   "currency": "DASH",
   "identifier": "1040095a-737d-41a2-a2e1-d031d19ec8cd"    
}

Nonce: "1645634942"

Merchant Secret Key:

bytes.fromhex("02d4b921007cad413e79731dd02b3267cd43a14d150a0ae6a1c651942122bb62")

• X-SIGNATURE hexadecimal(hmac_sha256(merchant_secret_key, nonce + body)):

"ff2ac6c50f09916783f1192c35e7f169a14a806e944827b9136bf1406ade8c9d"

Respuesta Webhook

En la respuesta del webhook recibirás múltiples parámetros. Los más importantes son:

• status (Los mas importantes son ‘AC’ + safe=True, ‘CO’ and ‘OC’).

• fiat_amount (Monto del pago en euros fiat)

• received_amount (Será menor que fiat_amount cuando el estado es 'OC')