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
    • Functionalities by business model
    • Network Tokens
    • One-step Payments
      • How do Card Payments Work?
      • Accept a Card Payment
      • Direct charge (without token)
      • Accept One-Time Payments with OTP
      • OTP Authentication Error Codes
      • Error codes for single card payments
    • Two-steps Payments
      • How do one-time payments with authorization and capture work?
      • Receive payments with authorization and capture
    • Webpay Plus Payments
      • Accept Payments through Webpay Plus
      • Reserve funds with Webpay Plus
    • Refunds
      • Returns, cancellations, and refunds
    • 3DS Authentication
      • Introduction to 3DS
      • 3DS API integration
      • 3DS integration with kushki.js library
      • 3DS API integration plus kushki.js library
      • 3DS Error Codes
    • Apple Pay Payments
      • Apple Pay Configuration
      • Apple Pay Sandbox testing
  • Recurring Card Payments (Online)
    • Functionalities by business model
    • External subscriptions to Kushki
    • Authenticate your subscriptions with 3DS
    • Accept one-click payments with 3DS
    • Error codes in recurring charges
    • Apple Pay for Subscriptions
    • Scheduled payments
      • How do Credit or Debit Card Payment Recurring Charges Work?
      • Create a recurring charge
      • Manage your Scheduled Charges
    • OneClick Webpay Scheduled Payments
      • Recurring Payments through Webpay OneClick
      • Reserve funds in subscriptions with Webpay OneClick
    • One Click Payments with Webpay OneClick
      • Webpay OneClick Payments
      • Reserve funds in one click payments with Webpay OneClick
    • OneClick Payments
      • Accepting One-Click Payments
      • How does authorization and capture work in OneClick payments?
      • Receive OneClick payments with authorization and capture
  • Card-present payments
    • Accept card present payments
    • Test data
    • Webhooks for card present
    • Raw card-present API
      • Raw card-present API overview
      • Cryptographic key exchange
      • Sample script to encrypt information
      • Take Payments
      • Frequently Asked Questions
      • Error codes for card-present transactions
    • Transactions
      • Transactions
      • Cancel payments
    • Kushki One
      • First Steps
      • Autenticación y Cifrado de Requests
      • Accept payments with Kushki One
      • Amount Format
      • Async services and webhooks
      • Printing on SmartPOS terminal
      • Unified Error Catalog — Kushki ONE Connect
    • Kushki One Payment App
      • Overview
      • Process a payment
      • Split payment on the terminal
      • Refunds and PreAuth & Capture
      • Review Your Transactions
      • Terminal Setup
  • Wire Transfers
    • 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
  • Money Disbursement
    • Wire Transfer
      • How does the dispersion by means of bank transfer work?
      • Payment Distribution to Bank Accounts
      • Error codes for transfer dispersions
  • 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
      • Webhook for Payments Made with Webpay Plus
    • Recurring Payments Webhooks
      • Webhook for Recurring Payments Made with Card
      • Webhook for recurring payments with Webpay OneClick
    • Payment Distribution Webhooks
      • Webhook for payment disbursement through wire transfer
    • 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 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
VariableType
amountobject
amount.subtotalIva0integer
amount.ivainteger
amount.subtotalIvainteger
amount.icenumber
amount.currencystring
amount.extraTaxesobject
amount.extraTaxes.agenciaDeViajesnumber
amount.extraTaxes.propinanumber
amount.extraTaxes.iacnumber
amount.extraTaxes.tasaAeroportuarianumber
processorStatestring OK NOT_AUTHORIZED FAILED
documentTypestring
createdinteger (Unix Timestamp Format)
documentNumberstring
transactionCyclestring
paymentDescriptionstring
responseCodestring
responseTextstring
tokenstring
publicMerchantIdstring
returnCodestring
bankIdstring
userIpstring
userTypestring “Persona Natural” (0) o “Persona Jurídica” (1)
trazabilityCodestring
statusstring initializedTransaction approvedTransaction declinedTransaction expiredTransaction
completedAtnumber (Unix Timestamp Format)
countrystring
ticketNumberstring
metadataobject
metadata.key0string
metadata.key1string
metadata.key2string
serviceCodestring
processorTypestring
transferProcessorstring
entityCodestring
processorIdstring
bankurlstring
callbackUrlstring
currencystring
sessionIdstring
userIdstring
emailstring
processorTokenstring
signatureTokenstring
termsUrlstring

Examples#

JSON
JSON
// Approved Transaction
{
  "country": "Chile",
  "ticketNumber": "3134757343132887",
  "metadata": {
    "operationType": "online",
    "userId": "IB344"
  },
  "documentType": "RUT",
  "serviceCode": "0000",
  "documentNumber": "123456789",
  "processorType": "gateway",
  "transferProcessor": "ETPayPlus Processor",
  "processorAccountInfo": {
    "userBank": "Banco Itaú",
    "transferenceNumber": "oc1234566",
    "userAccount": "0212294689",
    "userAccountType": "Cuenta corriente",
    "userRut": "123456789"
  },
  "bankName": "Banco Itaú",
  "requestAmount": 1000,
  "navigationFlow": {
    "lastStep": "selectAuthentication",
    "lastActivity": 1683134931791
  },
  "merchantName": "Chile",
  "credentialAlias": "Chile",
  "processorId": "6000000000165289175393283621088",
  "credentialInfo": {
    "alias": "Chile",
    "credentialId": "31b1b436455049e0a43012821000ff8e",
    "publicCredentialId": "6641b4238ae94e778cb92884df74c2ae"
  },
  "bankurl": "https://uat-transfer.kushkipagos.com/test/payment?token=fa4f6d874f1f4eb89ec2fcfd808678bc&bankId=cl_itau",
  "callbackUrl": "https://kushki.com",
  "currency": "CLP",
  "email": "user@example.com",
  "amount": {
    "subtotalIva0": 0,
    "iva": 0,
    "subtotalIva": 1000,
    "extraTaxes": {
      "agenciaDeViajes": 0,
      "iac": 0,
      "tasaAeroportuaria": 0
    }
  },
  "completedAt": 1683134939358,
  "entityCode": "0000",
  "transactionReference": "35d41149-2936-47d8-9d44-bd41a1f0a608",
  "created": 1683134737152,
  "userAgent": "PostmanRuntime/7.29.2",
  "sessionId": "-",
  "processor": {},
  "publicCredentialId": "6641b4238ae94e778cb92884df74c2ae",
  "userId": "-",
  "paymentDescription": "Description of the payment.",
  "token": "fa4f6d874f1f4eb89ec2fcfd808678bc",
  "publicMerchantId": "20000000101195395000",
  "signatureToken": "70enhkdY3fz9wMDKPjxcsfNbxJIneteLQ13NLiSaOYmc3DckFITs4QlsxdD2vpaO",
  "bankId": "cl_itau",
  "credentialId": "31b1b436455049e0a43012821000ff8e",
  "userIp": "187.207.13.51",
  "userType": "1",
  "approvedTransactionAmount": 1000,
  "config": {
    "region": "us-east-1"
  },
  "status": "approvedTransaction"
}
Modificado en 2026-10-14 19:52:45
Anterior
Webhook for One-Time Payments made with a card
Siguiente
Webhook for One-Time Payments in Cash
Built with