Void

POST

/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.

Cancels a transaction on the same business day, before the processor cutoff.
The amount is never debited from the cardholder's account.

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

Approximate cutoff times (confirm with your Kushki integration team):
Country Cutoff
Colombia 23:59 local
Chile 23:59 local
Mexico 22:00 local
Peru 20:59 local

Country	Cutoff
Colombia	23:59 local
Chile	23:59 local
Mexico	22:00 local
Peru	20:59 local

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

Transaction voided successfully.

This response does not have a body.

🟠400BadRequest

🟠401Unauthorized

🟠409Conflict

🟠422UnprocessableEntity

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/void' \
--header 'Authorization;' \
--header 'timestamp;' \
--header 'Content-Type: application/json' \
--data '{
    "amount": {
        "iva": 0,
        "subtotal_iva": 0,
        "subtotal_iva0": 12000
    },
    "client_transaction_id": "c5a3f3be-9d6f-4d39-8af5-58dbb589af69",
    "transaction_reference": "bdf6fcc3-7131-49cb-9436-087f9c09ad16"
}'

Response Example

400 - parameter_error

{
    "type": "PARAMETER",
    "code": "2001",
    "message": "Invalid currency: CLsP. Expected one of: [PEN, USD]"
}

Modified at 2026-06-02 16:31:03

Post-tip

Refund

Void

🚧 Beta — Early Access#

Request

Responses

🚧 Beta — Early Access