1. One-time Payments Webhooks
Kushki Docs
English
  • Español
  • English
  • Home
  • Quick Start
    • Frequently Asked Questions
    • Moving to Production
    • Policy for Important API Changes
    • Test Data
    • Error Codes
    • Latest Features
  • Payment Glossary
    • Payments Glossary
  • One-time card payments (Online)
    • Supported card brands
    • Introduction to 3DS
    • Functionalities by business model
    • How do third party commissions work?
    • Integration guide Third Party Commissions
    • One-step Payments
      • How do Card Payments Work?
      • Accept a Card Payment
      • Accept One-Time Payments with OTP
      • OTP Authentication Error Codes
      • Error codes for single card payments
    • Scheduled payments
      • How do Credit or Debit Card Payment Recurring Charges Work?
      • Create a recurring charge
      • Manage your Scheduled Charges
    • Refunds
      • Returns, cancellations, and refunds
    • 3DS Authentication
      • 3DS API integration
      • 3DS integration with kushki.js library
      • 3DS API integration plus kushki.js library
      • 3DS Error Codes
  • Recurring Card Payments (Online)
    • Functionalities by business model
    • Error codes in recurring charges
    • Authenticate your subscriptions with 3DS
    • External subscriptions to Kushki
    • OneClick Payments
      • Accepting One-Click Payments
  • Wire Transfers
    • How do Payments by Wire Transfers Work?
    • Banks and transaction details for bank transfer payments
    • Receive Wire Transfers
    • Check the Status of a Transaction
  • Cash Payments
    • How do Cash Payments Work?
    • Accept a Cash Payment
    • Authorized locations
    • Error Codes for declined cash transaction
  • Plugins
    • Shopify
      • Shopify
      • Plugin Operation
    • VTEX
      • VTEX Integration Guide
  • Payment Links
    • Smartlinks
  • Payment forms and buttons
    • Kajita
      • How Does it Work?
      • Payment Kajitas
    • Payment Button
      • Overview
      • Generate a payment button
  • Branch Offices Management
    • How to Onboard Submerchants via API
  • Notifications
    • Good Practices
    • Check your Webhooks
    • One-time Payments Webhooks
      • Webhook for One-Time Payments made with a card
      • Webhook for One-Time Payments by Wire Transfer
      • Webhook for One-Time Payments in Cash
    • Recurring Payments Webhooks
      • Webhook for Recurring Payments Made with Card
    • Payment button Webhooks
      • Webhooks with Payment Button
    • Smartlinks Webhooks
      • Webhooks with Smartlinks
    • Refunds Webhooks
      • Webhook for Voids and Refunds
      • Chargeback Webhooks
HomeMexico 🇲🇽Ecuador 🇪🇨
Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
HomeMexico 🇲🇽Ecuador 🇪🇨
Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
Status
Soporte / Support
English
  • Español
  • English
  1. One-time Payments Webhooks

Webhook for One-Time Payments in Cash

Cash
Kushki can send events to the webhook notifying your application in case an authorization is required for accepting a payment made after the deadline (Preauthorization) or to notify the time when your customer made a payment correctly (Payment Notification).

Payment Notification#

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
VariableType
ticketNumberstring
tokenstring
totalAmountnumber
amountobject
amount.ivanumber
amount.subtotalIvanumber
amount.subtotalIva0number
amount.extraTaxesobject
amount.extraTaxes.agenciaDeViajesnumber
amount.extraTaxes.iacnumber
amount.extraTaxes.propinanumber
amount.extraTaxes.tasaAeroportuarianumber
currencystring
creatednumber (Unix Timestamp Format)
expirationnumber (Unix Timestamp Format)
status"approvedTransaction" "declinedTransaction" "expiredTransaction"
identificationstring
namestring
lastNamestring
merchantIdstring
merchantNamestring
processorNamestring
processorIdstring
transactionIdstring
completedAtnumber (Unix Timestamp Format)
metadataobject
metadata.key0string
metadata.key1string
descriptionstring
pinstring
emailstring
documentTypestring

Examples#

JSON
JSON
// Approved Transaction
{
  "country": "Colombia",
  "lastName": "Castro",
  "ticketNumber": "2302011714922359",
  "amount": {
    "subtotalIva0": 49.99,
    "iva": 0,
    "subtotalIva": 0
  },
  "completedAt": 1602011733626,
  "documentType": "CC",
  "created": 1602011714779,
  "processorType": "gateway",
  "description": "Description of the payment",
  "transactionId": "aaa6c0ce-bd05-4df2-9012-833fa32efa84",
  "merchantName": "Tu Gran Empresa",
  "token": "150af7fa762246cc96572d825e3771f6",
  "totalAmount": 49.99,
  "identification": "123456789",
  "processorId": "6000000000XXXXXXXXXXXX50336197",
  "pin": "2011731304",
  "merchantId": "20000000*******2000",
  "name": "Juan",
  "currency": "COP",
  "expiration": 1602025005000,
  "processorName": "Banco Bogota Processor",
  "email": "kushki@kushkipagos.com",
  "status": "approvedTransaction",
  "transactionReference": "aaa6c0ce-bd05-4df2-9012-833fa32efa84"
}
Modificado en 2026-10-14 19:48:35
Anterior
Webhook for One-Time Payments by Wire Transfer
Siguiente
Recurring Payments Webhooks
Built with