Void

Cancels a transaction within the same calendar day, before the 23:59 cutoff.
The amount is never debited from the cardholder's account.

Wait at least 1 minute after the original transaction before calling void.

🚧 Beta — Early Access
This API is in early access. Endpoints, parameters, and response structures
may change without prior notice. Do not deploy to production without
coordinating with the Kushki integration team.

Cutoff: 23:59 local time. Within the same calendar day the reversal is a cancellation; from midnight onwards the same /void call enters the refund cycle and takes business days.

What you encrypt

The body you send is the encrypted envelope. This is the plaintext object you encrypt — the field contract, not what travels on the wire:

{
    "amount": {
        "iva": 0,
        "subtotal_iva": 0,
        "subtotal_iva0": 12000
    },
    "client_transaction_id": "c5a3f3be-9d6f-4d39-8af5-58dbb589af69",
    "transaction_reference": "bdf6fcc3-7131-49cb-9436-087f9c09ad16",
    "omit_card": false
}

omit_card is optional and applies to capture, re_authorization and void, in sync and async — the six combinations. With true the terminal completes the operation without asking for the card again, which is what makes the hotel check-out case work.

See Authentication and request encryption for the derivation chain and the seven steps.

curl --location 'https://api-uat.kushkipagos.com/terminal/v1/sync/void' \ --header 'Authorization: Basic 9f2c4e1b7a63d8f05c2e9b41a7d3086fbe15c4d29a7e0b38f6c1d52a94e7b3c0' \ --header 'timestamp: 1748476800' \ --header 'encrypted_http_communication: true' \ --header 'Content-Type: application/json' \ --data '{ "data": "a3f14c7e9b02d85fbc1e46a9d370f28b:9e0d7f21c4a8b653e17d902fac48b5d6e83c1704a9f26db8" }'

{ "hostRespond": true, "approved": true, "responseCode": "000", "message": "Approved or completed successfully.", "request": { "amount": { "currency": "CLP", "iva": 0, "subtotal_iva": 0, "subtotal_iva0": 100000, "extra_taxes": { "airport_tax": 0, "iac": 0, "ice": 0, "travel_agency": 0 } }, "transaction_type": "charge", "transaction_mode": "Void", "client_transaction_id": "843e884a-f2b3-4df7-bd21-f1bd31c8d51c", "transaction_reference": "a2127f9b-c946-4ea5-9ca2-5406bb84f872", "omit_card": true, "show_decimal_places": true, "is_async": false, "events_webhook_url": "", "is_smart_void": false }, "rawResponse": { "additional_amounts": { "account_type": "", "amount": 0, "amount_type": "", "card_type": "", "currency_code": "" }, "authorized_amount": 100000, "card_type": "credit", "cvm_type": "none", "F11": "108093", "franchise": "MASTERCARD", "kushki_response": { "code": "000", "message": "Approved or completed successfully." }, "message_fields": { "F38": "123456", "F39": "00" }, "transaction_reference": "f1ac82b6-7418-4fc2-9379-36ebdd6a44e3", "transaction_status": "APPROVAL", "transaction_type": "charge", "ticket_number": "117152704170980755" }, "timestamp": 1788901286620, "needReversal": false }

🚧 Beta — Early Access

What you encrypt

Request

Responses

Void

🚧 Beta — Early Access#

What you encrypt#

Request

Responses

🚧 Beta — Early Access

What you encrypt