Webhooks para tarjeta presente

29 octubre 2024

Recibe notificaciones de los eventos ocurridos en tu comercio a través de webhooks en tu sistema.

Los webhooks permiten suscribirte a eventos que puedan ocurrir, como por ejemplo, una transacción es aprobada o rechazada. Cuando un evento ocurra, te notificaremos a través de un endpoint que hayas configurado previamente, enviando una solicitud POST con un objeto JSON que contendrá toda la información necesaria sobre el evento. Los eventos disponibles varían por tipo de integración.

Cloud Terminal API, App to app y Terminal SDK

Descubre la lista de los eventos disponibles a través de integraciones Cloud terminal API, App to app y Terminal SDK:

Transacciones aprobadas
Transacciones rechazadas
Anulaciones

Transacciones aprobadas

A continuación, la lista de propiedades disponibles en el webhook. Ten en cuenta que algunas de las propiedades podrían no estar disponibles al momento de la notificación de acuerdo a la configuración de la operación y al método de pago.

Propiedad	Tipo	Descripción
result	String	Resultado de la transacción. Valores posibles: `aprobada` para transacciones aprobadas.
amount	String	Monto de la transacción.
tip	String	Se regresará el monto de la propina en caso de que exista.
payments	Integer	Se devolverá el número de meses en los que se difirió una transacción (cuando aplique).
authorizationTime	String	Fecha de autorización. Formato de fecha RFC 3339.
reference	String	Descripción de la transacción.
transactionid	String	Id de la transacción generado por Kushki.
authorization	String	Cadena de autorización de la transacción.
creditcard	String	Ultimos 4 dígitos de la tarjeta.
cardtype	String	Emisor de la tarjeta. Valores posibles: `VISA`, `MASTERCARD`, `CARNET`, `AMERICAN EXPRESS`.
arqc	String	Criptograma de solicitud de autorización (ARQC) de la transacción.
userID	Integer	Id del usuario que realizó la transacción.
aid	String	ID de la aplicación de chip.
applabel	String	Etiqueta de aplicación de chip.
url	String	Identificador único para acceder a un ticket de transacción.
email	String	Correo electrónico al que se envía el ticket de transacción.
phone	String	Número de teléfono al que se envía el ticket de transacción.
cardBrand	String	Red emisor de la tarjeta.
cardIssuer	String	Banco emisor de la tarjeta.
cardCountry	String	Código de país de la tarjeta (ISO 3166-1 alpha-2).
cardClass	String	Tarjeta de débito (`DEBIT`) o crédito (`CREDIT`).
launchTime	String	Hora en que se envió la transacción.
maskedPAN	String	Número de tarjeta enmascarado.
uniqueReference	String	Identificador único por transacción generado del lado del cliente para evitar duplicados. Por ejemplo, UUID.

Ejemplo.

{
    "cardBrand": "MASTERCARD",
    "cardIssuer": "SANTANDER",
    "cardCountry": "MX",
    "cardClass": "CREDIT",
    "launchTime": "2024-05-29T11:01:27.360-0600",
    "userID": 61000,
    "authorizationTime": "2024-05-29T11:01:27.360-0600",
    "result": "aprobada",
    "amount": "100.00",
    "payments": 0,
    "transactionid": "128010",
    "authorization": "BP3500",
    "creditcard": "0009",
    "cardtype": "MASTERCARD",
    "arqc": "A38051D19B2548E3",
    "aid": "A0000000041010",
    "applabel": "Mastercard",
    "url": "face3142cb4d32a545f42d278b8cf4ce5ea3d0b1",
    "maskedPAN": "500000******0009",
    "uniqueReference": "d6732f94-6cf2-4dfb-aed7-11b64b739407"
}

Transacciones rechazadas

Propiedad	Tipo	Descripción
result	String	Resultado de la transacción. Valores posibles: `rechazadaProsa` para transacciones rechazadas.
amount	String	Monto de la transacción.
tip	String	Se regresará el monto de la propina en caso de que exista.
payments	Integer	Se devolverá el número de meses en los que se difirió una transacción (cuando aplique).
authorizationTime	String	Fecha de autorización. Formato de fecha RFC 3339.
reference	String	Descripción de la transacción.
transactionid	String	Id de la transacción generado por Kushki.
creditcard	String	Ultimos 4 dígitos de la tarjeta.
cardtype	String	Emisor de la tarjeta. Valores posibles: `VISA`, `MASTERCARD`, `CARNET`, `AMERICAN EXPRESS`.
arqc	String	Criptograma de solicitud de autorización (ARQC) de la transacción.
userID	Integer	Id del usuario que realizó la transacción.
aid	String	ID de la aplicación de chip.
applabel	String	Etiqueta de aplicación de chip.
cardBrand	String	Red emisor de la tarjeta.
cardIssuer	String	Banco emisor de la tarjeta.
cardCountry	String	Código de país de la tarjeta (ISO 3166-1 alpha-2).
cardClass	String	Tarjeta de débito (`DEBIT`) o crédito (`CREDIT`).
launchTime	String	Hora en que se envió la transacción.
maskedPAN	String	Número de tarjeta enmascarado.
uniqueReference	String	Identificador único por transacción generado del lado del cliente para evitar duplicados. Por ejemplo, UUID.

Ejemplo.

{
    "cardBrand": "MASTERCARD",
    "cardIssuer": "SANTANDER",
    "cardCountry": "MX",
    "cardClass": "CREDIT",
    "launchTime": "2024-05-29T10:46:52.221-0600",
    "userID": 61000,
    "authorizationTime": "2024-05-29T10:46:52.221-0600",
    "result": "rechazadaProsa",
    "amount": "99.00",
    "payments": 0,
    "transactionid": "128011",
    "creditcard": "0009",
    "cardtype": "MASTERCARD",
    "arqc": "6FEC34124C9AAEEB",
    "aid": "A0000000041010",
    "applabel": "Mastercard",
    "maskedPAN": "500000******0009",
    "uniqueReference": "d6732f94-6cf2-4dfb-aed7-11b64b739407"
}

Anulaciones

Propiedad	Tipo	Descripción
result	String	Resultado de la transacción. Valores posibles: `aprobada` para anulaciones aprobadas. `rechazadaRiesgo`, `rechazadaProsa` o `rechazada` para anulaciones rechazadas. `pendiente` para anulaciones pendientes.
amount	String	Monto de la transacción.
payments	Integer	Se devolverá el número de meses en los que se difirió una transacción (cuando aplique).
authorizationTime	String	Fecha de autorización. Formato de fecha RFC 3339.
transactionid	String	Id de la transacción generado por Kushki.
authorization	String	Cadena de autorización de la transacción.
creditcard	String	Ultimos 4 dígitos de la tarjeta.
cardtype	String	Emisor de la tarjeta. Valores posibles: `VISA`, `MASTERCARD`, `CARNET`, `AMERICAN EXPRESS`.
userID	Integer	Id del usuario que realizó la transacción.
url	String	Identificador único para acceder a un ticket de transacción.
cardBrand	String	Red emisor de la tarjeta.
cardCountry	String	Código de país de la tarjeta (ISO 3166-1 alpha-2).
cardClass	String	Tarjeta de débito (`DEBIT`) o crédito (`CREDIT`).
launchTime	String	Hora en que se envió la transacción.
maskedPAN	String	Número de tarjeta enmascarado.
uniqueReference	String	Identificador único por transacción generado del lado del cliente para evitar duplicados. Por ejemplo, UUID.
transactionType	String	Tipo de transacción. Valores posibles: `devolución` para anulaciones.
transactionRefundedId	String	Id de la transacción original.

Ejemplo.

{
    "cardBrand": "VISA",
    "cardCountry": "US",
    "cardClass": "CREDIT",
    "uniqueReference": "d6732f94-6cf2-4dfb-aed7-11b64b739407",
    "launchTime": "2024-08-16T10:02:37.965-0600",
    "userID": 61000,
    "authorizationTime": "2024-08-16T10:02:37.965-0600",
    "result": "aprobada",
    "amount": "1018.0",
    "payments": 0,
    "transactionid": "128013",
    "authorization": "BP4160",
    "creditcard": "0002",
    "cardtype": "VISA",
    "url": "19c6f19bc1a7a00a1d76021aa5eaef2627aba950",
    "maskedPAN": "400000******0002",
    "transactionType": "devolucion",
    "transactionRefundedId": "128012"
}

Raw Card-Present API

Para conocer los pasos que debes seguir para consumir y configurar un Webhook en tu cuenta, por favor revisa las siguientes guías:

Descubre la lista de los eventos disponibles a través de integraciones Raw Card-Present API:

Transacciones aprobadas
Transacciones rechazadas
Autorizaciones
Captura de fondos
Anulaciones
Reversos
Consulta de saldo

Propiedad	Tipo	Descripción
country	String	País del comercio.
franchise	String	Franquicia de la tarjeta procesada.
available	boolean
channel	String	Canal por donde se realizó la venta.
public_credential_id	String	Llave pública del comercio.
client_transaction_id	String	Id generado por el comercio.
mcc	String	Código de categoría de comerciante (Merchant category code).
card_country	String	País de la tarjeta procesada.
processor_name	String	Nombre del procesador.
transaction_reference	String	Referencia única por transacción generada por Kushki.
payment_method	String	Método de pago.
card_details	Object	Objeto con información adicional de la tarjeta procesada.
card_details.prosa_info	String
card_details.reading_type	String	Tipo de lectura de la tarjeta procesada.
card_details.card_sequential	String
card_details.tlv	String
transaction_id	String	Id único por transacción generado por Kushki.
created	Integer	Fecha de creación de la transacción.
merchant_name	String	Nombre del comercio.
transaction_type	String	Tipo de operación.
processor	Object	Objeto con información adicional del procesador.
processor.code	String	Código de respuesta del procesador.
processor.message	String	Mensaje de respuesta del procesador.
reference_number	String	Número de referencia de la transacción.
tax_id	String
sync_mode	String
additional_info	Object
additional_info.f7	String
additional_info.f63	String
additional_info.f11	String
additional_info.f37	String
additional_info.f32	String
additional_info.f62s2	String
subtotal_iva0	Number	Monto sin impuestos de la transacción.
deferred	Object
deferred.months	String	Número de cuotas (si la transacción se difirió).
response_code	String	Código de respuesta.
transaction_status	String	Estado de la transacción.
social_reason	String	Razón social del comercio.
payment_brand	String	Marca de la tarjeta procesada.
acquirer_bank	String
request_amount	String	Monto solicitado.
merchant_id	String	Id del comercio.
merchant_category	String	Categoría del comercio.
acq_transaction_type	String
security	Object
security.ip	String
security.user_agent	String
masked_credit_card	String	Número de tarjeta enmascarado.
authorization_code	String	Código de autorización.
issuing_bank	String	Banco emisor de la tarjeta.
processor_id	String	Id del procesador.
foreign_card	Boolean
pos_details	Object
pos_details.model	String	Modelo de la terminal.
pos_details.location	Object
pos_details.location.latitude	Number
pos_details.location.longitude	Number
pos_details.version	String	Versión de la terminal.
pos_details.brand	String	Marca de la terminal.
pos_details.terminal_id	String	Id de la terminal.
last_four_digits	String	Últimos 4 dígitos de la tarjeta.
approval_code	String	Código de aprobación.
amount	Object
amount.extra_taxes	Object
amount.currency	String	Moneda de la transacción.
amount.subtotal_iva0	Number	Monto sin impuestos de la transacción.
rules_response	Object
rules_response.country	String
rules_response.commercial_executive	String
rules_response.business_category	String
rules_response.address	String
rules_response.city	String
rules_response.authorizer	Object
rules_response.authorizer.authorizer_name	String
rules_response.authorizer.soft_descriptor	String
rules_response.authorizer.authorizer_bank_id	String
rules_response.authorizer.commerce_code	String
rules_response.authorizer.authorizer_type	String
rules_response.authorizer.retailer_id	String
rules_response.authorizer.authorizer_acquirer_bin	String
rules_response.authorizer.category_model	String
rules_response.authorizer.url	String
rules_response.authorizer.authorizer_alias	String
rules_response.authorizer.terminal_id	String
rules_response.contact_person	String
rules_response.merchant_name	String
rules_response.telephone	String
rules_response.mcc	String
rules_response.url	String
rules_response.zip_code	String
rules_response.tax_id	String
rules_response.province	String
rules_response.business_registration_id	String
rules_response.tcc	String
rules_response.total	String
rules_response.business_line	String
rules_response.currency	String
rules_response.id	String
rules_response.acquirer_type	String
acq_transaction_scope	String
contact_details	Object
contact_details.document_number	String
contact_details.document_type	String
acq_transaction_mode	String
card_type	String	Tipo de tarjeta procesada.
ticket_number	String	Número de ticket.
card_country_code	String	Código de país de la tarjetas procesada.
credential_alias	String
bin_card	String	Bin de la tarjeta procesada.
credential_id	String
cvm_type	String
approved_transaction_amount	Number	Monto autorizado.
transaction_reference	String	Referencia única por transacción generada por Kushki.

Ejemplos de webhooks para una transacción aprobada.

JSON
JSON
JSON

{
    "country": "Mexico",
    "franchise": "MASTERCARD",
    "available": true,
    "channel": "POS",
    "public_credential_id": "146cbf33c7fd45c4111cbf9d3f04478d",
    "client_transaction_id": "ae6dd41a-9173-4ec7-8734-3178454ef341",
    "mcc": "1234",
    "card_country": "CHL",
    "processor_name": "MASTERCARD",
    "transaction_reference": "718fa526-6f41-405f-a1f5-a71db52dfdd2",
    "payment_method": "card",
    "card_details": {
        "prosa_info": {},
        "reading_type": "MCR"
    },
    "transaction_id": "111663595155516279",
    "created": 1663895155240,
    "merchant_name": "Tu libreria",
    "transaction_type": "SALE",
    "processor": {
        "code": "000",
        "message": "Transacción Aprobada."
    },
    "reference_number": "226520101801",
    "tax_id": "7283839521223",
    "sync_mode": "online",
    "additional_info": {
        "f7": "0922200555",
        "f63": "MDS8TNCN9",
        "f11": "101883",
        "f37": "226520101883"
    },
    "subtotal_iva0": 101.99,
    "deferred": {
        "months": "1"
    },
    "response_code": "00",
    "transaction_status": "APPROVAL",
    "social_reason": "TU LIBRERIA",
    "payment_brand": "MASTERCARD",
    "acquirer_bank": "Kushki",
    "request_amount": 101.99,
    "merchant_id": "20000000305053342000",
    "approved_transaction_amount": 101.99,
    "merchant_category": "Medium",
    "acq_transaction_type": "charge",
    "security": {
        "ip": "187.212.254.148",
        "user_agent": "PostmanRuntime/7.29.2"
    },
    "masked_credit_card": "545195XXXXXX5480",
    "authorization_code": "533804",
    "issuing_bank": "BankACQ",
    "processor_id": "1652365464",
    "foreign_card": true,
    "pos_details": {
        "model": "P2-EU",
        "location": {
            "latitude": -0.1848534,
            "longitude": -78.4769761
        },
        "brand": "SUNMI",
        "version": "Kushki SunmiV1.1.13",
        "terminal_id": "PB04209860004"
    },
    "last_four_digits": "5480",
    "approval_code": "533804",
    "amount": {
        "extra_taxes": {},
        "currency": "MXN",
        "subtotal_iva0": 101.99
    },
    "rules_response": {
        "country": "MEX",
        "address": "Centro 123",
        "business_category": "0",
        "commercial_executive": "user@example.com",
        "authorizer": {
            "authorizer_name": "MASTERCARD",
            "soft_descriptor": "KSK*TEST",
            "authorizer_bank_id": "",
            "authorizer_type": "",
            "commerce_code": "353453",
            "retailer_id": "",
            "authorizer_acquirer_bin": "545195",
            "category_model": "0",
            "terminal_id": "1652365413",
            "authorizer_alias": "MASTERCARD",
            "url": "http://internal-k8s-acquirer-acquirer-83c4eec5cf-1220747559.us-east-1.elb.amazonaws.com/mc/"
        },
        "city": "Monterrey",
        "contact_person": "John Doe",
        "merchant_name": "Tu libreria",
        "telephone": "8100000001",
        "mcc": "1234",
        "tax_id": "asdf12345678",
        "url": "http://internal-k8s-acquirer-acquirer-83c4eec5cf-1220747559.us-east-1.elb.amazonaws.com/mc/",
        "zip_code": "64000",
        "province": "NUEVO LEON",
        "tcc": "H",
        "total_amount": "101.990000",
        "business_registration_id": "000000000001",
        "business_line": "37006",
        "currency": "MXN",
        "id": "1652365464",
        "acquirer_type": "kushki"
    },
    "acq_transaction_scope": "international",
    "contact_details": {
        "document_number": "123666",
        "document_type": "0"
    },
    "acq_transaction_mode": "Authorization",
    "card_type": "credit",
    "ticket_number": "111663890155240264",
    "card_country_code": "MEX",
    "credential_alias": "Tu libreria",
    "bin_card": "545195",
    "credential_id": "245c10532cd844e28e4ec9a83159d89b",
    "transactionReference": "718fa526-6f41-405f-a1f5-a71db52dfdd2"
}

{
    "country": "Mexico",
    "franchise": "MASTERCARD",
    "available": true,
    "channel": "POS",
    "public_credential_id": "146cbf33c7fd45c4111cbf9d3f04478d",
    "client_transaction_id": "6610eadc-6c1d-44aa-8ca0-18e061c1472a",
    "mcc": "1234",
    "card_country": "CHL",
    "processor_name": "MASTERCARD",
    "transaction_reference": "a1c8ccb4-0bbc-4661-8b22-7355bd1a2701",
    "payment_method": "card",
    "card_details": {
        "prosa_info": {},
        "reading_type": "MCR"
    },
    "transaction_id": "151663895657169613",
    "created": 1663895657169,
    "merchant_name": "Tu libreria",
    "transaction_type": "PREAUTH",
    "processor": {
        "code": "000",
        "message": "Transacción Aprobada."
    },
    "reference_number": "226520101814",
    "tax_id": "7283839425223",
    "sync_mode": "online",
    "additional_info": {
        "f7": "0922201417",
        "f63": "MDS8TNCN9",
        "f11": "101884",
        "f37": "226520101884"
    },
    "subtotal_iva0": 601,
    "deferred": {
        "months": "1"
    },
    "response_code": "00",
    "transaction_status": "APPROVAL",
    "social_reason": "TU LIBRERIA",
    "payment_brand": "MASTERCARD",
    "acquirer_bank": "Kushki",
    "request_amount": 601,
    "merchant_id": "20000000505013348000",
    "approved_transaction_amount": 601,
    "merchant_category": "Medium",
    "acq_transaction_type": "preAuth",
    "security": {
        "ip": "187.212.254.148",
        "user_agent": "PostmanRuntime/7.29.2"
    },
    "masked_credit_card": "222300XXXXXX0018",
    "authorization_code": "918762",
    "issuing_bank": "BankACQ",
    "processor_id": "1652365464",
    "cvm_type": "none",
    "foreign_card": true,
    "pos_details": {
        "location": {
            "latitude": -0.22480833333333333,
            "longitude": -78.487955
        },
        "model": "P2-EU",
        "version": "Kushki SunmiV1.1.26",
        "brand": "SUNMI",
        "terminal_id": "PB04016R20519"
    },
    "last_four_digits": "0018",
    "approval_code": "918762",
    "amount": {
        "extra_taxes": {},
        "currency": "MXN",
        "subtotal_iva0": 601
    },
    "rules_response": {
        "country": "MEX",
        "address": "Centro 123",
        "business_category": "0",
        "commercial_executive": "user@example.com",
        "city": "Monterrey",
        "authorizer": {
            "authorizer_name": "MASTERCARD",
            "soft_descriptor": "KSK*TEST",
            "authorizer_bank_id": "",
            "authorizer_type": "",
            "commerce_code": "353453",
            "retailer_id": "",
            "authorizer_acquirer_bin": "24477",
            "category_model": "0",
            "url": "http://internal-k8s-acquirer-acquirer-83c4eec5cf-1220747559.us-east-1.elb.amazonaws.com/mc/",
            "terminal_id": "1632369464",
            "authorizer_alias": "MASTERCARD"
        },
        "contact_person": "John Doe",
        "merchant_name": "Tu libreria",
        "telephone": "8100000001",
        "mcc": "1234",
        "zip_code": "64000",
        "tax_id": "asdf12345678",
        "url": "http://internal-k8s-acquirer-acquirer-83c4eec5cf-1220747559.us-east-1.elb.amazonaws.com/mc/",
        "province": "NUEVO LEON",
        "tcc": "H",
        "total_amount": "601.000000",
        "business_registration_id": "000000000001",
        "business_line": "37006",
        "currency": "MXN",
        "id": "1652365464",
        "acquirer_type": "kushki"
    },
    "acq_transaction_scope": "international",
    "contact_details": {
        "document_type": "-1"
    },
    "acq_transaction_mode": "Authorization",
    "card_type": "credit",
    "ticket_number": "111663895707169666",
    "card_country_code": "MEX",
    "credential_alias": "Tu libreria",
    "bin_card": "222300",
    "credential_id": "245c10532cd544e28e4eb9a70659d89b",
    "transactionReference": "a1c8ccb4-0bbc-4661-8b22-7355bd1a2701"
}

{
    "country": "Mexico",
    "franchise": "MASTERCARD",
    "available": true,
    "channel": "POS",
    "public_credential_id": "146caf33c7fd45c4941cbf9d3f04478d",
    "client_transaction_id": "ae6dd91a-9173-4ec7-8934-3178454ef341",
    "mcc": "1234",
    "card_country": "CHL",
    "processor_name": "MASTERCARD",
    "transaction_reference": "777fea10-24f2-4bb9-8d0c-8ae717fce2e8",
    "payment_method": "card",
    "card_details": {
        "prosa_info": {},
        "reading_type": "MCR"
    },
    "transaction_id": "111663895948960466",
    "created": 1663895948960,
    "merchant_name": "Tu libreria",
    "transaction_type": "CAPTURE",
    "processor": {
        "code": "000",
        "message": "Transacción Aprobada."
    },
    "reference_number": "226601101885",
    "tax_id": "7283839421223",
    "sync_mode": "online",
    "additional_info": {
        "f7": "0923011908",
        "f63": "MDS8TNCN9",
        "f11": "101885",
        "f37": "226601101885"
    },
    "subtotal_iva0": 2000,
    "deferred": {
        "months": "1"
    },
    "response_code": "00",
    "transaction_status": "APPROVAL",
    "social_reason": "TU LIBRERIA",
    "payment_brand": "MASTERCARD",
    "acquirer_bank": "Kushki",
    "request_amount": 2000,
    "merchant_id": "20000000105053348000",
    "approved_transaction_amount": 2000,
    "merchant_category": "Medium",
    "acq_transaction_type": "capture",
    "security": {
        "ip": "187.252.251.248",
        "user_agent": "PostmanRuntime/7.29.2"
    },
    "masked_credit_card": "222300XXXXXX0018",
    "authorization_code": "423101",
    "issuing_bank": "BankACQ",
    "processor_id": "1652365464",
    "foreign_card": true,
    "pos_details": {
        "model": "P2-EU",
        "location": {
            "latitude": -0.1848534,
            "longitude": -78.4769761
        },
        "version": "Kushki SunmiV1.1.13",
        "brand": "SUNMI",
        "terminal_id": "PB04209860189"
    },
    "last_four_digits": "0018",
    "approval_code": "423101",
    "amount": {
        "extra_taxes": {},
        "currency": "COP",
        "subtotal_iva0": 2000
    },
    "rules_response": {
        "country": "MEX",
        "commercial_executive": "marco@kushkipagos.com",
        "address": "Direccion prueba",
        "business_category": "0",
        "city": "Guanajuato",
        "authorizer": {
            "authorizer_name": "MASTERCARD",
            "soft_descriptor": "KSK*TEST",
            "authorizer_bank_id": "",
            "authorizer_type": "",
            "commerce_code": "353453",
            "authorizer_acquirer_bin": "24477",
            "retailer_id": "",
            "category_model": "0",
            "authorizer_alias": "MASTERCARD",
            "url": "http://internal-k8s-acquirer-acquirer-83c4eec5cf-1220747559.us-east-1.elb.amazonaws.com/mc/",
            "terminal_id": "1652365464"
        },
        "contact_person": "Person Contact 1",
        "merchant_name": "Tu libreria",
        "telephone": "0987654321",
        "mcc": "1234",
        "tax_id": "asdf12345678",
        "zip_code": "12345",
        "url": "http://internal-k8s-acquirer-acquirer-83c4eec5cf-1220747559.us-east-1.elb.amazonaws.com/mc/",
        "province": "AGUASCALIENTES",
        "total_amount": "2000.000000",
        "tcc": "H",
        "business_registration_id": "000000000001",
        "business_line": "37006",
        "currency": "MXN",
        "id": "1652365464",
        "acquirer_type": "kushki"
    },
    "acq_transaction_scope": "international",
    "contact_details": {
        "document_number": "123666",
        "document_type": "0"
    },
    "acq_transaction_mode": "Authorization",
    "card_type": "credit",
    "ticket_number": "111663895948960466",
    "card_country_code": "MEX",
    "credential_alias": "Tu libreria",
    "bin_card": "222300",
    "credential_id": "245c10532cd844e28e4ec9a70659d89b",
    "transactionReference": "777fea10-24f2-4bb9-8d0c-8ae717fce2e8"
}

Ejemplos de webhooks para un reembolso.

JSON

{
    "country": "Mexico",
    "franchise": "VISA",
    "available": true,
    "channel": "POS",
    "public_credential_id": "146cbf33c7fd45c0271cbf9d31d4478d",
    "client_transaction_id": "6681eadc-6d8d-44ba-8ca0-18e061c1172a",
    "mcc": "1234",
    "card_country": "MEX",
    "processor_name": "VISA",
    "transaction_reference": "daa8583d-f18c-419a-840e-be5c95011eb6",
    "payment_method": "card",
    "card_details": {
        "card_sequential": "11",
        "prosa_info": {},
        "reading_type": "ICC",
        "tlv": "9F2701809F1A0206049A032208309F02060000000120005F2A0206044F07A00000000310109F0607A00000000310109F26085DE291D252397F709F100706010A03A020009F37044A05C99750095649534120544553549F6E009F5B009F3602008C9F330360F8C89F03009C010082021C008407A00000000310105F34011195058080048000"
    },
    "transaction_id": "111663896831621702",
    "created": 1663896831738,
    "merchant_name": "Tu libreria",
    "transaction_type": "REFUND",
    "processor": {
        "code": "000",
        "message": "Transacción Aprobada."
    },
    "reference_number": "226520105211",
    "tax_id": "7283839421223",
    "sync_mode": "online",
    "additional_info": {
        "f7": "0922203351",
        "f32": "408210",
        "f11": "100611",
        "f62s2": "40000000000000000302145412649612",
        "f37": "226520100611"
    },
    "subtotal_iva0": 60,
    "deferred": {
        "months": "1"
    },
    "response_code": "00",
    "transaction_status": "APPROVAL",
    "social_reason": "TU LIBRERIA",
    "payment_brand": "VISA",
    "acquirer_bank": "Kushki",
    "request_amount": 60,
    "merchant_id": "20000000105850418000",
    "approved_transaction_amount": 0.6,
    "merchant_category": "Medium",
    "acq_transaction_type": "Refund",
    "security": {},
    "masked_credit_card": "476134XXXXXX0043",
    "authorization_code": "120606",
    "issuing_bank": "VISA",
    "processor_id": "1652365464",
    "cvm_type": "none",
    "foreign_card": true,
    "pos_details": {
        "location": {
            "latitude": -0.22480833333333333,
            "longitude": -78.487955
        },
        "model": "P2-EU",
        "version": "Kushki SunmiV1.1.26",
        "brand": "SUNMI",
        "terminal_id": "PB04216R24337"
    },
    "last_four_digits": "0043",
    "approval_code": "120606",
    "amount": {
        "extra_taxes": {},
        "currency": "MXN",
        "subtotal_iva0": 60
    },
    "rules_response": {
        "country": "MEX",
        "commercial_executive": "user@example.com",
        "business_category": "0",
        "address": "Centro 123",
        "contact_person": "Jhon Doe",
        "authorizer": {
            "authorizer_name": "VISA",
            "soft_descriptor": "KSK*TEST",
            "authorizer_bank_id": "",
            "authorizer_type": "",
            "commerce_code": "353453",
            "authorizer_acquirer_bin": "408210",
            "retailer_id": "",
            "category_model": "0",
            "terminal_id": "1652365464",
            "authorizer_alias": "VISA",
            "url": "http://internal-k8s-acquirer-acquirer-83c4eec5cf-1220747559.us-east-1.elb.amazonaws.com/visa/"
        },
        "city": "Monterrey",
        "merchant_name": "Tu libreria",
        "telephone": "8100000001",
        "mcc": "1234",
        "url": "http://internal-k8s-acquirer-acquirer-83c4eec5cf-1220747559.us-east-1.elb.amazonaws.com/visa/",
        "zip_code": "64000",
        "tax_id": "asdf12345678",
        "province": "NUEVO LEON",
        "total_amount": "60.000000",
        "business_registration_id": "000000000001",
        "tcc": "H",
        "business_line": "37006",
        "currency": "MXN",
        "id": "1652365464",
        "acquirer_type": "kushki"
    },
    "acq_transaction_scope": "international",
    "contact_details": {
        "document_type": "-1"
    },
    "acq_transaction_mode": "Authorization",
    "card_type": "credit",
    "ticket_number": "111663896831738702",
    "card_country_code": "MEX",
    "credential_alias": "Tu libreria",
    "bin_card": "476134",
    "credential_id": "245c10502cd844ebae4ec9a70610d89b",
    "transactionReference": "daa8583d-f18c-419a-840e-be5c95011eb6"
}