Webhook for One-Time Payments by Wire Transfer

Wire Transfers

As the final phase of the wire transfer payment reception process, Kushki offers you the possibility of sending events to the webhook notifying your application when a wire transfer payment is completed.

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
`amount`	`object`
`amount.subtotalIva0`	`integer`
`amount.iva`	`integer`
`amount.subtotalIva`	`integer`
`amount.ice`	`number`
`amount.currency`	`string`
`amount.extraTaxes`	`object`
`amount.extraTaxes.agenciaDeViajes`	`number`
`amount.extraTaxes.propina`	`number`
`amount.extraTaxes.iac`	`number`
`amount.extraTaxes.tasaAeroportuaria`	`number`
`processorState`	`string` `OK` `NOT_AUTHORIZED` `FAILED`
`documentType`	`string`
`created`	`integer (Unix Timestamp Format)`
`documentNumber`	`string`
`transactionCycle`	`string`
`paymentDescription`	`string`
`responseCode`	`string`
`responseText`	`string`
`token`	`string`
`publicMerchantId`	`string`
`returnCode`	`string`
`bankId`	`string`
`userIp`	`string`
`userType`	`string` “Persona Natural” (0) o “Persona Jurídica” (1)
`trazabilityCode`	`string`
`status`	`string` `initializedTransaction` `approvedTransaction` `declinedTransaction` `expiredTransaction`
`completedAt`	`number (Unix Timestamp Format)`
`country`	`string`
`ticketNumber`	`string`
`metadata`	`object`
`metadata.key0`	`string`
`metadata.key1`	`string`
`metadata.key2`	`string`
`serviceCode`	`string`
`processorType`	`string`
`transferProcessor`	`string`
`entityCode`	`string`
`processorId`	`string`
`bankurl`	`string`
`callbackUrl`	`string`
`currency`	`string`
`sessionId`	`string`
`userId`	`string`
`email`	`string`
`processorToken`	`string`
`signatureToken`	`string`
`termsUrl`	`string`

Examples

JSON

// Approved Transaction
{
  "country": "Ecuador",
  "ticketNumber": "3135260111086030",
  "metadata": {
    "userId": "IB344"
  },
  "documentType": "RUC",
  "serviceCode": null,
  "documentNumber": "123456789",
  "processorType": "gateway",
  "transferProcessor": "SafetyPay Processor",
  "requestAmount": 90,
  "merchantName": "TuComercioEC",
  "credentialAlias": "Ecuador",
  "processorId": "6000000000165342923107252372111",
  "credentialInfo": {
    "alias": "Ecuador",
    "credentialId": "f3a4b1cbe9194566b4077e61203a1109",
    "publicCredentialId": "3d862f80fb4c4527a0ecce6992dec918"
  },
  "bankurl": "https://uat-sandbox.kushkipagos.com/checkout/transfer?status=pending&identificationType=RUC&identificationNumber=123456789&description=&referenceNumber=3135260111086030&bankName=&bankCode=null&amount=90&cus=178076753&ticketNumber=3135260111086030&processor=SafetyPay Processor",
  "callbackUrl": "https://kushki.com",
  "currency": "USD",
  "trazabilityCode": "178076753",
  "email": "user@example.com",
  "amount": {
    "subtotalIva0": 90,
    "iva": 0,
    "subtotalIva": 0,
    "ExtraTaxes": {
      "agenciaDeViajes": 0,
      "iac": 0,
      "tasaAeroportuaria": 0
    }
  },
  "completedAt": 1683135264404,
  "entityCode": null,
  "transactionReference": "faa94a40-50c5-4dc8-b252-d433d6513519",
  "created": 1683135239810,
  "userAgent": "PostmanRuntime/7.29.2",
  "sessionId": "-",
  "publicCredentialId": "3d862f80fb4c4527a0ecce6992dec918",
  "userId": "-",
  "paymentDescription": "Description of the payment.",
  "token": "4bbb0c8db0fa433cb7f6179189d67d7a",
  "publicMerchantId": "20000000104536895000",
  "bankId": null,
  "credentialId": "f3a4b1cbe9194566b4077e61203a1109",
  "userIp": "187.207.13.51",
  "config": {
    "region": "us-east-1"
  },
  "status": "approvedTransaction"
}

Webhook for One-Time Payments by Wire Transfer

Structure#

Examples#

Structure

Examples