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	string Tipo de notificación [OPERATION_CREATED, TAXED_OPERATION_CREATED]
merchant_id	string ID del comercio
user	string Usuario que realizó la operación
datetime	string Fecha y hora de la operación [2000-12-31T00:00:00Z]
detail	object Detalles del evento por cada operación

Evento de operación creada

Tipo de evento: OPERATION_CREATED

Esquema del cuerpo de la solicitud:

Parámetros	Descripción
detail. terminal_id	string ID del terminal
detail. operation_id	string ID de la operación
detail. qr_id (opcional)	string ID del qr
detail. ticket_id	string ID del ticket
detail. operation_type	string Tipo de operación [PAYMENT, REFUND, ANNULMENT]
detail. operation_status	string Estado de la operación [FAILED, APPROVED, REJECTED]
detail. currency	string Moneda de la operación [ARS, MEX]
detail. operation_amount	number Monto de la operación
detail. operation_additional_info	string Información adicional de la operación
detail. payment_method_type	string Tipo de método de pago [CREDIT, DEBIT, PREPAID, QR]
detail. payment_method_detail	string Detalle del método de pago
detail.	string
detail.	string

Evento de operación con cálculos impositivos

Tipo de evento: TAXED_OPERATION_CREATED

Esquema del cuerpo de la solicitud:

Parámetros	Descripción
detail. customer_id	string ID del cliente
detail. merchant_id	string ID del comercio
detail. terminal_id	string ID de la terminal
detail. merchant_additional_info	string Información adicional del comercio
detail. transaction_id	string ID de la transacción
detail. operation_id	string ID de la operación
detail. operation_number	string Número de la operación
detail. operation_additional_info	string Información adicional de la operación
detail. serial_number	string Número de serie
detail. operation_type	string Tipo de operación [PAYMENT, REFUND, ANNULMENT]
detail. payment_method	string Método de pago [CREDIT, DEBIT, PREPAID, QR]
detail. gross_amount	number Monto bruto de la operación
detail. currency	string Moneda de la operación [ARS, MEX]
detail. datetime	string Fecha de la operación
detail. status	string Estado de la operación [FAILED, APPROVED, REVERSED, REJECTED]
detail. installments	integer Número de cuotas
detail. operation_detail	object Detalles adicionales de la operación
detail. tax_info	object Información de impuestos

Esquema del detalle de la operación (operation_detail):

Parámetros	Descripción
reference_operation_id (opcional)	string ID de operación de pago de referencia (solo aplica para REFUND y ANNULMENT)
reference_operation_number (opcional)	string Número de operación de pago de referencia (solo aplica para REFUND y ANNULMENT)
qr_id (opcional)	string ID del código QR asociado a la transacción
additional_info (opcional)	string Información adicional sobre la operación
card (opcional)	object Detalles de la tarjeta utilizada en la operación
holder_name (opcional)	string Nombre del titular de la tarjeta
holder_document (opcional)	string Documento de identificación del titular de la tarjeta
description (opcional)	string Descripción de la operación
tip_amount (opcional)	number Monto de las propinas
wallet_name (opcional)	string Nombre de la billetera

Esquema del detalle de la tarjeta (card):

Parámetros	Descripción
card_bin (opcional)	string Número bin de la tarjeta
card_mask (opcional)	string Número enmascarado de la tarjeta
card_brand (opcional)	string Marca de la tarjeta
is_international_card (opcional)	boolean Si la tarjeta es internacional

Esquema de la información de impuestos (tax_info):

Parámetros	Descripción
term	integer Cantidad de dias
payment_date	string Fecha de pago [2000-12-31T00:00:00Z]
net_amount	number Monto neto
customer_term	integer Cantidad de dias del cliente
customer_payment_date	string Fecha de pago del cliente [2000-12-31T00:00:00Z]
customer_net_amount	number Monto neto del cliente
tax_breakdown	array Desglose de impuestos

Esquema del desglose de impuestos (tax_breakdown):

Parámetros	Descripción
tax_code	string Código de impuesto
reference	string Descripción del impuesto [2000-12-31T00:00:00Z]
amount	number Monto del impuesto
rate (opcional)	number Tasa del impuesto

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

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,
    "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"
    },
    "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
        }
      ]
    }
}
}

Crear notificación de prueba Obtener terminales