Webhooks with Payment Button

When making payments through a Payment Button you will be notified of the following events for card, cash or wire payments:

Approved transaction

Declined transaction

Card Payments

The webhooks sent by Kushki will contain the headers listed here.

The following is a description of the possible variables delivered in the body of the webhook for credit card payments:

Method: POST

Body: Object

Variable	Tipo
`ticketNumber`	`string`
`approvalCode`	`string`
`metadata`	`object`
`metadata.key0`	`string`
`metadata.key1`	`string`
`responseText`	`string`
`binCard`	`string`
`smartLink`	`string`
`requestAmount`	`number`
`type`	`string`
`responseCode`	`string`
`bank`	`string`
`merchantId`	`string`
`syncMetadata`	boolean
`id`	`string`
`processorBankName`	`string`
`amount`	`object`
`amount.subtotalIva0`	`number`
`amount.iva`	`number`
`amount.subtotalIva`	`number`
`amount.currency`	`string`
`product`	`object`
`product.unitPrice`	`number`
`product.quantity`	`integer`
`product.name`	`string`
`product.description`	`string`
`cardCountry`	`string`
`cardHolderName`	`string`
`transactionReference`	`string`
`created`	`number (Unix Timestamp Format)`
`paymentBrand`	`string`
`contactDetails`	`object`
`contactDetails.email`	`string`
`token`	`string`
`publicMerchantId`	`string`
`transactionType`	"SALE"
`transactionChannel`	"WEBCHECKOUTPLUS"
`lastFourDigits`	`string`
`paymentMethod`	`string`
`binCard`	`string`
`approvedTransactionAmount`	`number`
`status`	`"approvedTransaction" "declinedTransaction"`

Examples

JSON

// Approved Transaction
{
   "ticketNumber":"916519657017985234",
   "approvalCode":"000000",
   "metadata":{
      "orderID":"6827",
      "contrato":"claro 123"
   },
   "responseText":"Transacción aprobada",
   "binCard":"545195",
   "smartLink":"3W95hy7fX",
   "requestAmount":257000,
   "type":"credit",
   "responseCode":"000",
   "bank":"Banco de la Produccion S.A. (PRODUBANCO)",
   "merchantId":"20000000106554380000",
   "syncMetadata":"false",
   "id":"24cf9b50-8b04-49fb-9d57-4be3bb7a1a5a",
   "processorBankName":"0032~BANCO INTERNACIONAL",
   "amount":{
      "subtotalIva0":0,
      "iva":19000,
      "subtotalIva":238000,
      "currency":"MXN"
   },
   "product":[
      {
         "unitPrice":100000,
         "quantity":2,
         "name":"runners",
         "description":"Tenis"
      }
   ],
   "cardCountry":"Ecuador",
   "cardHolderName":"deisy Leal",
   "transactionReference":"a6704c0b-4be5-468f-96a1-3e454cb574ca",
   "created":1722982829858,
   "paymentBrand":"Mastercard",
   "contactDetails":{
      "email":"user@example.com"
   },
   "token":"db3d08cd80454324a960a69cc1480d9c",
   "publicMerchantId":"017dc7108f0141e78ef4ca4694a2520f",
   "transactionType":"SALE",
   "transactionChannel":"WEBCHECKOUTPLUS",
   "lastFourDigits":"5480",
   "paymentMethod":"creditCard",
   "approvedTransactionAmount":257000,
   "status":"approvedTransaction"
}

Wire Transfer Payments

These are the possible variables provided in the body of the webhook for wire transfer payments:

Method: POST

Body: Object

Variable	Type
`ticketNumber`	`string`
`amount`	`object`
`amount.subtotalIva0`	`number`
`amount.iva`	`number`
`amount.subtotalIva`	`number`
`amount.currency`	`string`
`metadata`	`object`
`product`	`object`
`product.unitPrice`	`number`
`product.quantity`	`integer`
`product.name`	`string`
`product.description`	`string`
`redirectUrl`	`string`
`transactionReference`	`string`
`created`	`number (Unix Timestamp Format)`
`smartLink`	`string`
`contactDetails`	`object`
`contactDetails.firstName`	`string`
`contactDetails.lastName`	`string`
`contactDetails.documentType`	`string`
`contactDetails.documentNumber`	`string`
`contactDetails.email`	`string`
`token`	`string`
`publicMerchantId`	`string`
`merchantId`	`string`
`paymentMethod`	`string`
`syncMetadata`	`boolean`
`id`	`string`
`trazabilityCode`	`string`
`status`	`"approvedTransaction" "declinedTransaction"`

Examples

JSON

// Approved Transaction
{
  "ticketNumber": "8903880459904381",
  "amount": {
    "subtotalIva0": 0,
    "iva": 500,
    "subtotalIva": 500,
    "currency": "MXN"
  },
  "metadata": {},
  "product": [
    {
      "unitPrice": 1000,
      "quantity": 2,
      "name": "runners",
      "description": "Tenis"
    }
  ],
  "redirectUrl": "https://api-uat.kushkipagos.com/transfer/v1/agent?token=4e14347df70d4744b09ff9a6483e80a6&mid=20000000104096460000",
  "transactionReference": "6659910b-936e-4842-826f-82b0433af540",
  "created": 1678903884347,
  "smartLink": "cvIrvtx2j",
  "contactDetails": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@kushkipagos.com"
  },
  "token": "4e14347df70d4744b09ff9a6483e80a6",
  "publicMerchantId": "ef31f04f2c364080bd33162bfb360c81",
  "merchantId": "20000000104096460000",
  "paymentMethod": "transfer",
  "syncMetadata": "false",
  "id": "a277e170-3241-4e27-8d22-e21f66b879d4",
  "trazabilityCode": "564988596",
  "status": "approvedTransaction"
}

Cash Payments

These are the possible variables that are delivered in the body of the webhook for cash payments:

Method: POST

Body: Object

Variable	Type
`ticketNumber`	`string`
`amount`	`object`
`amount.subtotalIva0`	`number`
`amount.iva`	`number`
`amount.subtotalIva`	`number`
`amount.currency`	`string`
`metadata`	`object`
`metadata.firstTime`	`string`
`product`	`object`
`product.unitPrice`	`number`
`product.quantity`	`integer`
`product.name`	`string`
`product.description`	`string`
`transactionReference`	`string`
`created`	`number (Unix Timestamp Format)`
`smartLink`	`string`
`contactDetails`	`object`
`contactDetails.firstName`	`string`
`contactDetails.lastName`	`string`
`contactDetails.documentType`	`string`
`contactDetails.documentNumber`	`string`
`contactDetails.email`	`string`
`token`	`string`
`publicMerchantId`	`string`
`pdfUrl`	`string`
`pin`	`string`
`merchantId`	`string`
`paymentMethod`	`string`
`syncMetadata`	`boolean`
`id`	`string`
`status`	`"approvedTransaction" "expiredTransaction"`

Examples

JSON

// Approved Transaction
{
  "ticketNumber": "2378903288609109",
  "amount": {
    "subtotalIva0": 0,
    "iva": 50,
    "subtotalIva": 50,
    "currency": "USD"
  },
  "metadata": {
    "firstTime": "0"
  },
  "product": [
    {
      "unitPrice": 100,
      "quantity": 2,
      "name": "runners",
      "description": "Tenis"
    }
  ],
  "transactionReference": "225405a4-c300-4ea6-9952-406e0efcc5ee",
  "created": 1678903302137,
  "smartLink": "2aLhypwTL",
  "contactDetails": {
    "firstName": "John",
    "lastName": "Doe",
    "documentType": "CC",
    "documentNumber": "123456789",
    "email": "john.doe@kushkipagos.com"
  },
  "token": "2bb63390d18e4475adc4f8f0730f84f2",
  "publicMerchantId": "883ae5c3d47446d898dddc94dd76076f",
  "pdfUrl": "https://api-uat.kushkipagos.com/cash/v1/charges/2378903288609109/receipt",
  "pin": "8903296880",
  "merchantId": "20000000108692034000",
  "paymentMethod": "cash",
  "syncMetadata": "false",
  "id": "69bbf42d-7a17-4ff5-ad61-8b4bd156659c",
  "status": "approvedTransaction"
}

Webhooks with Payment Button

Card Payments#

Examples#

Wire Transfer Payments#

Examples#

Cash Payments#

Examples#

Card Payments

Examples

Wire Transfer Payments

Examples

Cash Payments

Examples