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

Discover the list of events available through integrations Cloud terminal API, App to app and Terminal SDK:

Approved transactions

Below is the list of properties available in the webhook. Please note that some properties may not be available at the time of notification depending on the transaction settings and payment method.

Property	Type	Description
result	String	Transaction result. Possible values: `aprobada` for approved transactions.
amount	String	Transaction amount.
tip	String	If the transaction includes a tip, it will be returned.
payments	Integer	If the transaction has been deferred, the number of deferred installments will be returned.
authorizationTime	String	Authorization time. RFC 3339 date format.
reference	String	Transaction description.
transactionid	String	Transaction ID generated by Kushki.
authorization	String	Transaction authorization string.
creditcard	String	Last 4 digits of the card's Primary Account Number (PAN).
cardtype	String	Card issuer. Possible values: `VISA`, `MASTERCARD`, `CARNET`, `AMERICAN EXPRESS`.
arqc	String	EMV only. Authorization Request Cryptogram (ARQC) of the transaction.
userID	Integer	ID of the user who made the transaction.
aid	String	EMV only. Chip's Application ID.
applabel	String	EMV only. Chip's Application Label.
url	String	Unique identifier to access a transaction ticket.
email	String	Email to which the transaction ticket is sent.
phone	String	Phone number to which the transaction ticket is sent.
cardBrand	String	Card Issuer Network.
cardIssuer	String	Card Issuer Bank.
cardCountry	String	Card Country Code (ISO 3166-1 alpha-2).
cardClass	String	`DEBIT` or `CREDIT` card.
launchTime	String	Time the transaction was sent.
maskedPAN	String	Masked card number.
uniqueReference	String	Unique identifier per transaction generated on the client side to avoid duplicates. For example, UUID.

Example.

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

Rejected transactions

Below is the list of properties available in the webhook. Please note that some properties may not be available at the time of notification depending on the transaction settings and payment method.

Property	Type	Description
result	String	Transaction result. Possible values: `rechazadaProsa` for rejected transactions.
amount	String	Transaction amount.
tip	String	If the transaction includes a tip, it will be returned.
payments	Integer	If the transaction includes a tip, it will be returned.
authorizationTime	String	Authorization time. RFC 3339 date format.
reference	String	Transaction description.
transactionid	String	Transaction ID generated by Kushki.
creditcard	String	Last 4 digits of the card's Primary Account Number (PAN).
cardtype	String	Card issuer. Possible values:`VISA`, `MASTERCARD`, `CARNET`, `AMERICAN EXPRESS`.
arqc	String	EMV only. Authorization Request Cryptogram (ARQC) of the transaction.
userID	Integer	ID of the user who made the transaction.
aid	String	EMV only. Chip's Application ID.
applabel	String	EMV only. Chip's Application Label.
cardBrand	String	Card Issuer Network.
cardIssuer	String	Card Issuer Bank.
cardCountry	String	Card Country Code (ISO 3166-1 alpha-2).
cardClass	String	`DEBIT` or `CREDIT` card.
launchTime	String	Time the transaction was sent.
maskedPAN	String	Masked card number.
uniqueReference	String	Unique identifier per transaction generated on the client side to avoid duplicates. For example, UUID.

Example.

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

Voids/refunds

Below is the list of properties available in the webhook. Please note that some properties may not be available at the time of notification depending on the transaction settings and payment method.

Property	Type	Description
result	String	Transaction result. Possible values: `aprobada` for approved voids/refunds `rechazadaRiesgo`, `rechazadaProsa` o `rechazada` for rejected refunds. `pendiente` for pending refunds.
amount	String	Refund amount.
payments	Integer	If the transaction has been deferred, the number of deferred installments will be returned.
authorizationTime	String	Authorization time. RFC 3339 date format.
transactionid	String	Transaction ID generated by Kushki.
authorization	String	Transaction authorization string.
creditcard	String	Last 4 digits of the card's Primary Account Number (PAN).
cardtype	String	Card issuer. Possible values: `VISA`, `MASTERCARD`, `CARNET`, `AMERICAN EXPRESS`.
userID	Integer	ID of the user who made the transaction.
url	String	Unique identifier to access a transaction ticket.
cardBrand	String	Card Issuer Network.
cardCountry	String	Card Country Code (ISO 3166-1 alpha-2).
cardClass	String	`DEBIT` or `CREDIT` card.
launchTime	String	Time the request was sent.
maskedPAN	String	Masked card number.
uniqueReference	String	Unique identifier per transaction generated on the client side to avoid duplicates. For example, UUID.
transactionType	String	Transaction type. Possible values: `devolución` for voids/refunds.
transactionRefundedId	String	Original refunded transaction ID

Example.

{
    "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 and Terminal SDK

Approved transactions#

Rejected transactions#

Voids/refunds#

Approved transactions

Rejected transactions

Voids/refunds