Webhook para devoluciones

Anulaciones y reembolsos

Kushki puede enviar eventos a tu webhook que notifiquen a tu aplicación en el momento en que uno de los siguientes eventos ocurra:

Cuando una anulación (void) es aprobada.

Cuando un reembolso (refund) es aprobado.

También puedes consultar el estado de las devoluciones desde tu Consola.

Estructura

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

Estas son las posibles variables que se entregan en el webhook:

Método: POST

Body: Object

Variable	Tipo
`country`	`string`
`integrationMethod`	`string`
`metadata`	`object`
`contractID`	`string`
`credentialMetadata`	`string`
`aurusTicketNumber`	`string`
`processorType`	`string`
`merchantName`	`string`
`responseCode`	`string`
`credentialAlias`	`string`
`mccCode`	`string`
`saleTransactionType`	`string`
`uniqueCode`	`string`
`merchantId`	`string`
`nit`	`string`
`syncMode`	`string`
`id`	`string`
`socialReason`	`string`
`isSandboxTransaction`	`boolean`
`foreignCard`	`boolean`
`visibility`	`string`
`transactionReference`	`string`
`created`	`number (Timestamp format)`
`voidTicketNumber`	`string`
`transactionId`	`string`
`saleTicketNumber`	`string`
`lastFourDigits`	`string`
`taxId`	`string`
`credentialId`	`string`
`paymentMethod`	`string`
`saleApprovalCode`	`string`
`privateProcessorId`	`string`
`ticketNumber`	`string`
`forceRefund`	`boolean`
`responseText`	`Transacción aprobada`, `Transacción rechazada por el procesador`
`partialVoid`	`boolean`
`contactPerson`	`string`
`binCard`	`string`
`terminalId`	`string`
`requestAmount`	`number`
`categoryMerchant`	`string`
`processorId`	`string`
`processorMerchantId`	`string`
`processorName`	`string`
`saleTransactionReference`	`string`
`email`	`string`
`amount`	`object`
`amount.subtotalIva0`	`number`
`amount.subtotalIva`	`number`
`amount.iva`	`number`
`amount.extraTaxes`	`object`
`currency`	`string`
`ice`	`number`
`cardCountry`	`string`
`cardHolderName`	`string`
`transactionStatus`	"APPROVAL"``"DECLINED"
`paymentBrand`	`string`
`cardType`	`string`
`publicCredentialId`	`string`
`saleCreated`	`number (Timestamp format)`
`token`	`string`
`transactionType`	`"VOID" "REFUND"`
`cardCountryCode`	`string`
`consortiumName`	`string`
`approvedTransactionAmount`	`number`
`currencyCode`	`string`

Ejemplo

JSON

// anulación (void) aprobada
{
  "country": "Mexico",
  "integrationMethod": null,
  "metadata": {
    "contractID": "157AB"
  },
  "credentialMetadata": null,
  "aurusTicketNumber": "300765709982529055",
  "processorType": "aggregator_formal",
  "merchantName": "Tu Comercio MX",
  "responseCode": "000",
  "credentialAlias": "Tu Comercio",
  "mccCode": "5399",
  "saleTransactionType": "SALE",
  "uniqueCode": null,
  "merchantId": "20000000104096460000",
  "nit": "1209120000000",
  "syncMode": "online",
  "id": "f319be20-27d5-4faa-a4d4-b70b6ca55e0d",
  "socialReason": "TU COMERCIO",
  "isSandboxTransaction": true,
  "foreignCard": true,
  "visibility": "hidden",
  "transactionReference": "f319be20-27d5-4faa-a4d4-b70b6ca55e0d",
  "created": 1660062967307,
  "voidTicketNumber": "661660062966165887",
  "transactionId": "532095824159012674",
  "saleTicketNumber": "300765709982529055",
  "lastFourDigits": "5480",
  "taxId": "1209120000000",
  "credentialId": "c15718524c994d0dbc50c1bd03453cc2",
  "paymentMethod": "card",
  "saleApprovalCode": "000000",
  "privateProcessorId": "6000000000165643753487118743",
  "ticketNumber": "661660062966165887",
  "forceRefund": false,
  "responseText": "Transacción aprobada",
  "partialVoid": false,
  "contactPerson": "John Doe",
  "binCard": "545195",
  "terminalId": "1656437534581",
  "requestAmount": 99.97,
  "categoryMerchant": "Medium",
  "processorId": "6000000000165643753414808509",
  "processorMerchantId": "6000000000165643753448883050",
  "processorName": "Kushki Acquirer Processor",
  "saleTransactionReference": "f33a3887-d63d-42f0-8d57-3851942c100d",
  "email": "test@test.com",
  "amount": {
    "subtotalIva0": 99.97,
    "iva": 0,
    "subtotalIva": 0,
    "extraTaxes": {
      "agenciaDeViaje": 0,
      "iac": 0,
      "tasaAeroportuaria": 0
    },
    "currency": "MXN",
    "ice": 0
  },
  "cardCountry": "Ecuador",
  "cardHolderName": "John Doe",
  "transactionStatus": "APPROVAL",
  "paymentBrand": "Master Card",
  "cardType": "credit",
  "publicCredentialId": "da2f03f0600e4a1d9e702c6096ae733e",
  "saleCreated": 1660062956000,
  "token": "c9192a20afd14cf885d339d772c8ca57",
  "transactionType": "VOID",
  "cardCountryCode": "EC",
  "consortiumName": null,
  "approvedTransactionAmount": 99.97,
  "currencyCode": "MXN"
}

Webhook para devoluciones

Estructura#

Ejemplo#

Estructura

Ejemplo