Webhooks — 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

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

Webhooks — Cloud Terminal API, App to app y Terminal SDK

Transacciones aprobadas#

Transacciones rechazadas#

Anulaciones#

Transacciones aprobadas

Transacciones rechazadas

Anulaciones