Webhooks
Una vez que te suscribes a notificaciones de transacciones, recibirás eventos cuando se creen nuevas transacciones en tus comercios.
URL de notificación: TU_URL, configurada en el alta de la suscripción
Esquema del cuerpo de la solicitud:
| Parámetros | Descripción |
|---|---|
| notification_type |
|
| merchant_id |
|
| user |
|
| datetime |
|
| detail |
|
Evento de operación creada
Tipo de evento: OPERATION_CREATED
Esquema del cuerpo de la solicitud:
| Parámetros | Descripción |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Evento de operación con cálculos impositivos
Tipo de evento: TAXED_OPERATION_CREATED
Esquema del cuerpo de la solicitud:
| Parámetros | Descripción |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esquema del detalle de la operación (operation_detail):
| Parámetros | Descripción |
|---|---|
reference_operation_id
|
|
reference_operation_number
|
|
qr_id
|
|
additional_info
|
|
card
|
|
holder_name
|
|
holder_document
|
|
description
|
|
tip_amount
|
|
wallet_name
|
|
input_mode
|
|
Esquema del detalle de la tarjeta (card):
| Parámetros | Descripción |
|---|---|
card_bin
|
|
card_mask
|
|
card_brand
|
|
is_international_card
|
|
Esquema de la información de impuestos (tax_info):
| Parámetros | Descripción |
|---|---|
| term |
|
| payment_date |
|
| net_amount |
|
| customer_term |
|
| customer_payment_date |
|
| customer_net_amount |
|
| tax_breakdown |
|
Esquema del desglose de impuestos (tax_breakdown):
| Parámetros | Descripción |
|---|---|
| tax_code |
|
| reference |
|
| amount |
|
rate
|
|
Códigos de desglose de impuestos (tax_code):
- MENTA_TO_CUSTOMER_COMMISSION: Comisión de Menta
- MENTA_TO_CUSTOMER_COMMISSION_VAT_TAX: IVA sobre la comisión de Menta
- MENTA_COMMISSION_DISCOUNT: Descuento de Menta
- ACQUIRER_TO_CUSTOMER_COMMISSION: Comisión de la condición comercial
- ACQUIRER_TO_CUSTOMER_COMMISSION_VAT_TAX: IVA sobre la comisión de adquiriente
- CUSTOMER_TO_MERCHANT_COMMISSION: Tasa del plan de pago que pone el cliente
- CUSTOMER_TO_MERCHANT_COMMISSION_VAT_TAX: IVA sobre la tasa del plan de pago
- FINANCIAL_COST: Costo financiero de la tarjeta
- FINANCIAL_COST_VAT_TAX: IVA sobre el costo financiero
- MERCHANT_VAT_TAX: IVA sobre el total del monto del comercio
- MERCHANT_INCOME_TAX: Impuesto a las ganancias del comercio
- CUSTOMER_VAT_TAX: IVA sobre el total del monto del cliente
- CUSTOMER_INCOME_TAX: Impuesto a las ganancias del cliente
- MERCHANT_IIBB_TAX: Ingresos brutos del comercio
Notificación base
{
"notification_type": "OPERATION_CREATED",
"merchant_id": "db3ae307-4a5c-4cbb-b48c-80bf1a3fde1d",
"user": "[email protected]",
"datetime": "2022-12-31T23:23:23Z",
"detail": {
...
}
}Notificación: OPERATION_CREATED
{
"notification_type": "OPERATION_CREATED",
"merchant_id": "db3ae307-4a5c-4cbb-b48c-80bf1a3fde1d",
"user": "[email protected]",
"datetime": "2022-12-31T23:23:23Z",
"detail": {
"terminal_id": "72171704-7806-4347-b08b-bc2d2d96e68e",
"operation_id": "2fce7d49-f3e2-4b1f-a7bb-7f16d3ea64a2",
"ticket_id": "111111111",
"operation_type": "PAYMENT",
"qr_id": null,
"operation_status": "APPROVED",
"currency": "ARS",
"operation_amount": "200000",
"operation_additional_info": "ABC1234",
"payment_method_type": "DEBIT",
"payment_method_detail": "VISA",
"transaction_id": "bbc7571f-750c-43b5-9baf-f5d1d9a4dc42",
"reference_operation_id": "50c7571f-750c-43b5-9baf-f5d1d9a4d022"
}
}Notificación: TAXED_OPERATION_CREATED
{
"notification_type": "TAXED_OPERATION_CREATED",
"merchant_id": "c2192cf8-e221-4ccc-83d4-1c2105d46b9a",
"user": "[email protected]",
"datetime": "2023-09-19T20:07:32Z",
"detail": {
"customer_id": "a9733025-9b74-4cf9-b4fb-f71eeb037054",
"merchant_id": "45b1d469-e3e5-4ac6-8fe2-2e620d00f9a8",
"terminal_id": "c08d4aa6-d560-41c1-acbf-b183eb3794dd",
"merchant_additional_info": "35701",
"transaction_id": "1b35e569-dc28-47be-897f-1c2a9e5a5305",
"operation_id": "6debca65-4faf-48fd-a065-faf32735a52a",
"operation_number": 183863925,
"operation_additional_info": "",
"serial_number": "98282329166214",
"operation_type": "PAYMENT",
"payment_method": "CREDIT",
"gross_amount": 21,
"currency": "ARS",
"datetime": "2024-03-05T20:21:03-03:00",
"status": "APPROVED",
"installments": 1,
"financing": "ESTANDAR",
"user": "[email protected]",
"operation_detail": {
"card": {
"card_bin": "47617390",
"card_mask": "XXXXXXXXXXXX0119",
"card_brand": "VISA",
"is_international_card": false
},
"holder_name": "Tarjetahabiente",
"holder_document": "",
"description": "APROBADO",
"input_mode": "CONTACTLESS",
"reference_operation_number": 394221095,
"reference_operation_id": "50c7571f-750c-43b5-9baf-f5d1d9a4d022"
},
"tax_info": {
"term": 2,
"payment_date": "2024-02-23T09:26:54-03:00",
"net_amount": 18.02,
"customer_term": 8,
"customer_payment_date": "2024-03-04T09:26:54-03:00",
"customer_net_amount": 20.54,
"tax_breakdown": [
{
"tax_code": "MENTA_TO_CUSTOMER_COMMISSION",
"reference": "Menta to customer commission",
"amount": 0.07,
"rate": 0.35
},
{
"tax_code": "MENTA_TO_CUSTOMER_COMMISSION_VAT_TAX",
"reference": "Menta to customer commission VAT Tax",
"amount": 0.02,
"rate": 0.21
},
{
"tax_code": "ACQUIRER_TO_CUSTOMER_COMMISSION",
"reference": "Acquirer to customer commission",
"amount": 0.38,
"rate": 1.8
},
{
"tax_code": "ACQUIRER_TO_CUSTOMER_COMMISSION_VAT_TAX",
"reference": "Acquirer to customer commission VAT Tax",
"amount": 0.08,
"rate": 0.21
},
{
"tax_code": "CUSTOMER_TO_MERCHANT_COMMISSION",
"reference": "Customer to merchant commission",
"amount": 1.26,
"rate": 5.99
},
{
"tax_code": "CUSTOMER_TO_MERCHANT_COMMISSION_VAT_TAX",
"reference": "Customer to merchant commission VAT Tax",
"amount": 0.26,
"rate": 0.21
},
{
"tax_code": "MERCHANT_VAT_TAX",
"reference": "Merchant VAT Tax",
"amount": 0.58,
"rate": 0.21
},
{
"tax_code": "MERCHANT_INCOME_TAX",
"reference": "Merchant Income Tax",
"amount": 0.19
},
{
"tax_code": "MERCHANT_IIBB_TAX",
"reference": "Merchant IIBB Tax",
"amount": 0.68
}
]
}
}
}