> For the complete documentation index, see [llms.txt](https://bitnovo.gitbook.io/pay-es/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bitnovo.gitbook.io/pay-es/bitnovo-pay/integraciones/integracion-api/webhook.md).

# 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')