Refund

Testing

https://api-uat.kushkipagos.com

POST

/terminal/v1/sync/refund

Refunds a previously captured and settled transaction.
Can be executed days after the original charge. Partial refunds are supported.

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

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

Refund processed successfully.

This response does not have a body.

🟠400Bad Request

🟠401Unauthorized

🟠409

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/terminal/v1/sync/refund' \
--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-58dbb589af99",
    "transaction_reference": "da2d050f-1b15-43cf-9759-6a880519efb2"
}'

Response Example

400 - parameter_error

{
    "type": "PARAMETER",
    "code": "2001",
    "message": "Invalid currency. Expected: PEN"
}

Modified at 2026-08-31 16:18:45

Void

Abort

Refund

🚧 Beta — Early Access#

Request

Responses

🚧 Beta — Early Access