Refund

Testing

UAT Testing Env

https://api-uat.kushkipagos.com

POST

/terminal/v1/{terminalSerial}/sync/refund

Refunds a previously captured and settled transaction.

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

Can be executed days after the original charge. Partial refunds are supported.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

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/refund' \
--header 'Authorization: Basic 9f2c4e1b7a63d8f05c2e9b41a7d3086fbe15c4d29a7e0b38f6c1d52a94e7b3c0' \
--header 'timestamp: 1748476800' \
--header 'Content-Type: application/json' \
--data '{
    "amount": {
        "iva": -2053226,
        "subtotal_iva": -67887826,
        "subtotal_iva0": -67923621
    },
    "client_transaction_id": "withdrawal",
    "transaction_reference": "payment"
}'

Response Example

200 - default

{
    "hostRespond": true,
    "approved": true,
    "responseCode": "000",
    "message": "Approved or completed successfully.",
    "request": {
        "amount": {
            "currency": "MXN",
            "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
}

Modified at 2026-09-23 16:24:23

Sync

Charge

Refund

🚧 Beta — Early Access#

Request

Responses

🚧 Beta — Early Access