Webhook for Recurring Payments Made with Card

Kushki can send events to your webhook notifying your application at the time when one of the following events occurs:

When a subscription is created (subscriptionApproved). If it is created through Smartlink, the status will be approvedTransaction.

When a charge is successfully made (succesfullCharge)

When a scheduled subscription charge retry failed (failedRetry)

When all the scheduled subscription charge retries have failed (lastRetry)

When a charge of a on-demand subscription is declined (declinedCharge)

When a subscription is removed (subscriptionDelete)

Structure

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

These are the possible variables that are submitted in the webhook body:

Method: POST

Body: Object

Variable	Type	Description
`name`	`"succesfullCharge" "failedRetry" "lastRetry" "declinedCharge" "subscriptionDelete"` `"subscriptionApproved"`
`event`	`Object`
`event.id`	`string`
`event.metadata`	`Object`
`event.metadata.key0`	`string`
`event.metadata.key1`	`string`
`event.metadata.key2`	`string`
`event.subscriptionId`	`number`
`event.cardHolderName`	`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.amount.extraTaxes.agenciaDeViaje`	`number`
`event.amount.extraTaxes.iac`	`number`
`event.amount.extraTaxes.propina`	`number`
`event.amount.extraTaxes.tasaAeroportuaria`	`number`
`event.periodicity`	`string`
`event.contactDetails`	`Object`
`event.contactDetails.firstName`	`string`
`event.contactDetails.lastName`	`string`
`event.contactDetails.email`	`string`
`event.token`	`string`
`event.merchantId`	`string`
`event.startDate`	`number (Unix Timestamp Format)`
`event.endDate`	`number (Unix Timestamp Format)`
`event.created`	`number (Unix Timestamp Format)`
`event.planName`	`string`
`event.binInfo`	`Object`
`event.binInfo.bank`	`string`
`event.binInfo.type`	`string`
`event.binInfo.processor`	`string`
`event.binInfo.brand`	`string`
`event.dayOfMonth`	`number`
`event.month`	`string`
`event.dayOfWeek`	`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.active`	`boolean`
`event.lastFourDigits`	`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.retryConfiguration`	`object`
`event.retryConfiguration.retryType`	`string`
`event.retryConfiguration.value`	`array`
`event.retryConfiguration.value.items`	`integer`
`event.nextAttemptDay`	`number`
`event.lastRetryDate`	`number`
`event.url`	`string`
`event.approvalCode`	`string`
`event.ticketNumber`	`string`
`event.lastChargeDate`	`number`
`responseCode`	`string`	Response code. Only for declines.
`responseText`	`string`	Response text. Only for declines.
`processor.code`	`string`	Processor code. Only for declines.
`processor.message`	`string`	Processor message. Only for declines.
`messageFields.f38`	`string`	Field specific to declines by issuer or brand.
`messageFields.f48`	`object`	Response codes. Only for Mastercard.
`messageFields.f48.s22`	`string`	Corresponds to the citMit code sent in the request. Only for Mastercard.
`messageFields.f48.s84`	`string`	MAC code (Merchant Advice Code) from Mastercard for declined transactions.
`messageFields.f39`	`string`	Field specific to declines by issuer or brand.

Examples

JSON

Codigo

// Approved charge
{
  "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 for Recurring Payments Made with Card

Structure#

Examples#

Structure

Examples