Webhooks con Smartlinks

Cuando se hacen pagos a través de un Smartlink podrás recibir notificaciones de los siguientes eventos para pagos con tarjetas.

Transacción aprobada

Transacción declinada

Estructura

Los webhooks enviados por Kushki contendrán los encabezados (headers) aquí listados.

Pago con Tarjeta

A continuación se describen las posibles variables que se entregan en el cuerpo del webhook para pagos con tarjeta de crédito:

Método: POST

Body: Object

Variable	Tipo
`publicMerchantId`	`string`
`amount`	`object`
`amount.subtotalIva0`	`integer`
`amount.iva`	`integer`
`amount.subtotalIva`	`integer`
`amount.currency`	`string`
`metadata`	`object`
`metadata.total`	`string`
`metadata.nombreApellido`	`string`
`metadata.cedula`	`string`
`metadata.direccion`	`string`
`metadata.productos`	`string`
`metadata.email`	`string`
`created`	`integer (Unix Timestamp Format)`
`syncMetadata`	`string`
`smartLink`	`string`
`id`	`string`
`status`	`string`
`paymentMethod`	`string`
`ticketNumber`	`string`
`approvalCode`	`string`
`approvedTransactionAmount`	`number`
`bank`	`string`
`binCard`	`string`
`cardCountry`	`string`
`cardHolderName`	`string`
`lastFourDigits`	`string`
`paymentBrand`	`string`
`paymentConfigType`	`fixed` `open`
`processorBankName`	`string`
`requestAmount`	`number`
`responseCode`	`string`
`responseText`	`string`
`transactionType`	`string`
`type`	`string`
`transactionReference`	`string`

Ejemplos

JSON

// Transacción aprobada
{
 "id": "d5d2da2b-9213-4193-b72e-89508deec554",
 "amount": {
  "currency": "USD",
  "iva": 27.6,
  "subtotalIva": 230,
  "subtotalIva0": 0
 },
 "approvalCode": "000000",
 "approvedTransactionAmount": 257.6,
 "bank": "BANK NAME",
 "binCard": "424242",
 "cardCountry": "Ecuador",
 "cardHolderName": "Jhon Doe",
 "contactDetails": {},
 "created": 1689093048576,
 "lastFourDigits": "4242",
 "merchantId": "20000000108216107000",
 "metadata": {},
 "paymentBrand": "Visa",
 "paymentConfigType": "fixed", 
 "paymentMethod": "creditCard",
 "processorBankName": "0032~BANCO INTERNACIONAL",
 "publicMerchantId": "2ce2008060b146ed964692cc1fad8957",
 "requestAmount": 257.6,
 "responseCode": "000",
 "responseText": "Transacción aprobada",
 "smartLink": "0saIIYkDB",
 "status": "approvedTransaction",
 "syncMetadata": "false",
 "ticketNumber": "634537651430879765",
 "token": "d4c0ae7db80d4520b99eaa1e7a600c97",
 "transactionReference": "6487061f-8b90-47e2-a728-6b229300e73b",
 "type": "credit"
}

Pago con Transferencia

Estas son las posibles variables que se entregan en el cuerpo del webhook para pagos con transferencia bancaria:

Método: POST

Body: Object

Header	Header
`publicMerchantId`	`string`
`amount`	`object`
`amount.properties`	`integer`
`amount.iva`	`integer`
`amount.subtotalIva`	`integer`
`amount.currency`	`string`
`metadata`	`object`
`metadata.total`	`string`
`metadata.nombreApellido`	`string`
`metadata.cedula`	`string`
`metadata.direccion`	`string`
`metadata.productos`	`string`
`metadata.email`	`string`
`created`	`integer (Unix Timestamp Format)`
`syncMetadata`	`string`
`smartLink`	`string`
`id`	`string`
`status`	`string`
`paymentMethod`	`string`
`redirectUrl`	`string`
`description`	`string`
`bankName`	`string`
`bankId`	`string`
`trazabilityCode`	`string`
`email`	`string`

Ejemplos

JSON

// Transacción aprobada
{
  "ticketNumber": "1602089881960155",
  "amount": {
    "subtotalIva0": 49000,
    "iva": 0,
    "subtotalIva": 0,
    "currency": "COP"
  },
  "metadata": {
    "email": null
  },
  "redirectUrl": "https://api-uat.kushkipagos.com/transfer/v1/agent?token=4e85ec6daee54468919654c796e7bf74&mid=20000000XXXXXXX2000",
  "transactionReference": "0d3905a2-f30c-4d22-8106-d291f3afbbab",
  "created": 1602089886565,
  "bankName": "Kushki bank Colombia",
  "smartLink": "QG02kRklU",
  "contactDetails": {
    "email": "test@kushki.com"
  },
  "token": "4e85ec6daee54468919654c796e7bf74",
  "publicMerchantId": "20000000XXXXXXX2000",
  "bankId": "0001",
  "merchantId": "20000000XXXXXXX2000",
  "paymentMethod": "transfer",
  "syncMetadata": "false",
  "id": "b33ad9c2-9587-483d-9200-2f3ac7b3f883",
  "trazabilityCode": "823086197",
  "status": "approvedTransaction"
}

Suscripciones

Estas son las posibles variables que se entregan en el cuerpo del webhook para pagos de suscripciones:

Método: POST

Body: Object

Header	Header
`publicMerchantId`	`string`
`amount`	`object`
`amount.subtotalIva0`	`integer`
`amount.iva`	`integer`
`amount.subtotalIva`	`integer`
`amount.currency`	`string`
`metadata`	`object`
`metadata.total`	`string`
`metadata.nombreApellido`	`string`
`metadata.cedula`	`string`
`metadata.direccion`	`string`
`metadata.productos`	`string`
`metadata.email`	`string`
`created`	`(Unix Timestamp Format)`
`syncMetadata`	`string`
`smartLink`	`string`
`id`	`string`
`status`	`string`
`paymentMethod`	`string`
`subscriptionDetails`	`object`
`subscriptionDetails.amount`	`object`
`subscriptionDetails.amount.subtotalIva0`	`integer`
`subscriptionDetails.amount.subtotalIva`	`integer`
`subscriptionDetails.amount.iva`	`integer`
`subscriptionDetails.amount.currency`	`string`
`subscriptionDetails.endDate`	`string "yyyy-mm-dd"`
`subscriptionDetails.terms`	`string`
`subscriptionDetails.periodicity`	`string`
`subscriptionDetails.planName`	`string`
`subscriptionDetails.startDate`	`string "yyyy-mm-dd"`
`subscriptionId`	`string`
`contactDetails`	`object`
`contactDetails.firstName`	`string`
`contactDetails.lastName`	`string`
`contactDetails.email`	`string`

Ejemplo

// Transacción aprobada
{
  "amount": {
    "subtotalIva0": 49000,
    "iva": 0,
    "subtotalIva": 0,
    "currency": "COP"
  },
  "metadata": {
    "email": "test@kushki.com"
  },
  "created": 1602090156792,
  "smartLink": "QG02kRklU",
  "contactDetails": {
    "firstName": null,
    "lastName": null,
    "email": "test@kushki.com"
  },
  "token": "00efa6b6484c412b84271d59c2dacd8e",
  "publicMerchantId": "2200000000XXXXXXX200",
  "subscriptionDetails": {
    "amount": {
      "subtotalIva0": 15,
      "iva": 0,
      "subtotalIva": 0,
      "currency": "COP"
    },
    "terms": "<p>Acepto!</p>",
    "periodicity": "monthly",
    "planName": "Subscription-SmartLink",
    "startDate": "2020-10-07"
  },
  "merchantId": "2200000000XXXXXXX200",
  "paymentMethod": "subscription",
  "syncMetadata": "false",
  "id": "ba6f7ad1-0623-417a-93fc-74b2d4b98efc",
  "subscriptionId": "1602090156474000",
  "status": "approvedTransaction"
}

Webhooks con Smartlinks

Estructura#

Pago con Tarjeta#

Ejemplos#

Pago con Transferencia#

Ejemplos#

Suscripciones#

Ejemplo#

Estructura

Pago con Tarjeta

Ejemplos

Pago con Transferencia

Ejemplos

Suscripciones

Ejemplo