Void

UAT Testing Env

https://api-uat.kushkipagos.com

POST

/terminal/v1/sync/void

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.

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

Approximate cutoff in Peru: 23:59 local time.. Confirm the exact cutoff with your Kushki integration
team — once it passes, the transaction must be reversed with refund instead.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

Transaction voided successfully.

This response does not have a body.

🟠400Bad Request

🟠401Unauthorized

🟠409

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/terminal/v1/sync/void' \
--header 'Authorization: nRvpFJZHjqLU4k8Rz2YiDvxA3mQs9oB1cW7eT0=' \
--header 'timestamp: 1700000000000' \
--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. Expected: PEN"
}

Modified at 2026-08-25 14:30:11

Post-tip

Refund

Void

🚧 Beta — Early Access#

Request

Responses

🚧 Beta — Early Access