Webhook para pagos recurrentes con tarjeta

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

Cuando se crea una suscripción (subscriptionApproved). Si se crea mediante smartlink el status será approvedTransaction.

Cuando un cobro de una suscripción es exitoso (succesfullCharge)

Cuando un cobro de una suscripción bajo demanda es declinado (declinedCharge)

Cuando un intento de cobro de la suscripción calendarizada falló (failedRetry)

Cuando todos los intentos de cobro de la suscripción calendarizada fallan (lastRetry)

Cuando se elimina una suscripción (subscriptionDelete)

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étodod: Post

Body: Object

Variable	Tipo
`event`	`Object`
`event.metadata`	`Object`
`event.metadata.key0`	`string`
`event.metadata.key1`	`string`
`event.metadata.key2`	`string`
`event.endDate`	`number (Unix Timestamp Format)`
`event.maxCount`	`number`
`event.contactDetails`	`Object`
`event.contactDetails.firstName`	`string`
`event.contactDetails.lastName`	`string`
`event.contactDetails.email`	`string`
`event.contactDetails.phoneNumber`	`string`
`event.contactDetails.documentType`	`string`
`event.contactDetails.documentNumber`	`string`
`event.lastFourDigits`	`string`
`event.subscriptionStatus`	`string`
`event.active`	`boolean`
`event.dayOfMonth`	`number`
`event.token`	`string`
`event.binInfo`	`Object`
`event.binInfo.bank`	`string`
`event.binInfo.type`	`string`
`event.binInfo.processor`	`string`
`event.binInfo.brand`	`string`
`event.binInfo.bin`	`string`
`event.startDate`	`number (Unix Timestamp Format)`
`event.provider`	`string`
`event.id`	`string`
`event.credentialAlias`	`string`
`event.subscriptionId`	`string`
`event.created`	`number (Unix Timestamp Format)`
`event.credentialMetadata`	`string`
`event.ip`	`string`
`event.lastChargeDate`	`number`
`event.paymentBrand`	`string`
`event.callbackUrl`	`string`
`event.cardType`	`string`
`event.periodicity`	`string`
`event.count`	`number`
`event.retryConfiguration`	`object`
`event.retryConfiguration.retryType`	`string`
`event.retryConfiguration.value`	`array`
`event.retryConfiguration.value.items`	`integer`
`event.month`	`string`
`event.planName`	`string`
`event.dayOfWeek`	`string`
`event.amount`	`Object`
`event.amount.subtotalIva`	`number`
`event.amount.subtotalIva0`	`number`
`event.amount.iva`	`number`
`event.amount.ice`	`number`
`event.amount.currency`	`string`
`event.amount.extraTaxes`	`Object`
`event.tbkUser`	`string`
`event.credentialId`	`string`
`event.publicCredentialId`	`string`
`event.merchantId`	`string`
`event.transactionMetadata`	`Object`
`event.transactionReference`	`string`
`event.convertedAmount`	`Object`
`event.convertedAmount.totalAmount`	`number`
`event.convertedAmount.amount`	`Object`
`event.convertedAmount.amount.subtotalIva`	`number`
`event.convertedAmount.amount.subtotalIva0`	`number`
`event.convertedAmount.amount.iva`	`number`
`event.convertedAmount.amount.ice`	`number`
`event.convertedAmount.amount.currency`	`string`
`event.convertedAmount.amount.extraTaxes`	`Object`
`event.approvalCode`	`string`
`event.binCard`	`string`
`event.issuingBank`	`string`
`event.recap`	`string`
`event.ticketNumber`	`string`
`event.retry.type`	`Object`
`event.retry.attempts`	`number`
`event.retry.max`	`number`
`event.retry.firstAttemptDate`	`number`
`event.retry.periodicity`	`number`
`event.retry.daysLeft`	`array`
`event.retry.daysLeft.items`	`integer`
`event.retryCount`	`number`
`event.expirationTime`	`number`
`event.cardHolderName`	`string`
`event.adjustment`	`object`
`event.adjustment.amount`	`object`
`event.adjustment.amount.subtotalIva`	`number`
`event.adjustment.amount.subtotalIva0`	`number`
`event.adjustment.amount.iva`	`number`
`event.adjustment.amount.ice`	`number`
`event.adjustment.amount.currency`	`string`
`event.adjustment.amount.extraTaxes`	`object`
`event.adjustment.amount.extraTaxes.agenciaDeViaje`	`number`
`event.adjustment.amount.extraTaxes.iac`	`number`
`event.adjustment.amount.extraTaxes.propina`	`number`
`event.adjustment.amount.extraTaxes.tasaAeroportuaria`	`number`
`event.adjustment.periods`	`number`
`event.nextAttemptDay`	`number`
`event.lastRetryDate`	`number`
`event.url`	`string`
`name`	`"succesfullCharge" "failedRetry" "lastRetry" "declinedCharge" "subscriptionDelete"` `"subscriptionApproved"`

Ejemplos

succesfullCharge

declinedCharge

failedRetry

subscriptionDelete

subscriptionApproved

// Transacción aprobada
{
  "name": "succesfullCharge",
  "event": {
    "userAgent": "Go-http-client/1.1",
    "metadata": {
      "plan": {
        "fitness": {
          "pool": "include",
          "rumba": "include",
          "cardio": "include"
        }
      }
    },
    "subscriptionId": "1602024113521000",
    "created": 1602024113,
    "ip": "35.193.164.95",
    "lastChargeDate": 1602024176,
    "contactDetails": {
      "firstName": "Diego",
      "lastName": "Cadena",
      "phoneNumber": "+593988734644",
      "documentType": "CC",
      "documentNumber": "1009283738",
      "email": "test@test.com"
    },
    "periodicity": "monthly",
    "lastFourDigits": "4242",
    "active": true,
    "dayOfMonth": 6,
    "token": "da44953475f74c02abca31c5371e1792",
    "binInfo": {
      "bank": null,
      "brand": "VISA",
      "processor": "NA",
      "bin": "424242",
      "info": {
        "country": {
          "emoji": "🇺🇸",
          "latitude": 38,
          "alpha2": "US",
          "name": "United States of America",
          "numeric": "840",
          "currency": "USD",
          "longitude": -97
        },
        "number": {},
        "bank": {},
        "scheme": "visa",
        "type": "credit"
      }
    },
    "cardHolderName": "Pruebas",
    "maskedCardNumber": "424242XXXXXX4242",
    "month": "*",
    "planName": "Premium",
    "dayOfWeek": "?",
    "startDate": 1601942400,
    "amount": {
      "currency": "USD",
      "ice": 0,
      "subtotalIva0": 0,
      "iva": 0.14,
      "subtotalIva": 1
    },
    "id": "160202411352100020000000XXXXXXXX2000",
    "plccMetadataId": "187169a42eed456a9964dab5e7ec9468",
    "merchantId": "20000000XXXXXXXX2000",
    "transactionReference": "9eb4ec3d-5e83-4450-8d90-5047121bddbf",
    "approvalCode": "000000",
    "binCard": "424242",
    "issuingBank": null,
    "ticketNumber": "646245907500066871"
  }
}

Webhook para pagos recurrentes con tarjeta

Ejemplos#

Ejemplos