Charge (Async)

UAT Testing Env

https://api-uat.kushkipagos.com

POST

/terminal/v1/async/charge

Non-blocking variant of Charge.

In addition to the sync body, this operation accepts events_webhook_url, amount.tip, cashback_amount and query_deferred. The last three only take effect when the matching capability is enabled in the DMS; otherwise the terminal ignores them.

Returns 200 with a TERMINAL_ACKNOWLEDGED event as soon as the terminal accepts the payment intent. That acknowledgement is not the transaction result — the outcome, and every intermediate state, arrives as a POST to the events_webhook_url you supply. Omit the URL and the transaction still runs, but you never learn how it ended.

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

Callbacks

transactionEvents

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Accepted by the terminal. Returns a TERMINAL_ACKNOWLEDGED event immediately — this is not the transaction result. The outcome arrives via webhook.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠409

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/terminal/v1/async/charge' \
--header 'Authorization: nRvpFJZHjqLU4k8Rz2YiDvxA3mQs9oB1cW7eT0=' \
--header 'timestamp: 1700000000000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "events_webhook_url": "https://api.negocio.pe/webhook/terminal-events",
    "amount": {
        "iva": 0,
        "subtotal_iva": 0,
        "subtotal_iva0": 12000,
        "extra_taxes": {
            "airport_tax": 0,
            "iac": 0,
            "ice": 0,
            "travel_agency": 0
        },
        "tip": 0
    },
    "client_transaction_id": "c5a3f3be-9d6f-4d39-8af5-58dbb589af79",
    "metadata": {
        "reference": "ORD-20240317-001",
        "customer_email": "user@example.com",
        "device": "SUNMI-P3"
    },
    "cashback_amount": 0,
    "query_deferred": false
}'

Response Example

200 - TERMINAL_ACKNOWLEDGED

{
    "event_id": "c08211a1-344c-4f1c-850b-41e33fb08cca",
    "previous_status": "",
    "occurred_at": "2026-08-03T20:53:34.859Z",
    "status": "TERMINAL_ACKNOWLEDGED",
    "merchant_id": "20000000103802320000",
    "client_transaction_id": "c5a3f3be-9d6f-4d39-8af5-58dbb589af79",
    "terminal": {
        "serialNumber": "TJ54241P20911",
        "model": "P2SE-BPKT",
        "wifiMac": "",
        "room": "3.0.10"
    },
    "operation": {
        "type": "charge",
        "amount": {
            "extraTaxes": {
                "airportTax": 0,
                "iac": 0,
                "ice": 0,
                "travelAgency": 0
            },
            "iva": 0,
            "subtotalIva": 0,
            "subtotalIva0": 12000
        },
        "clientTransactionId": "c5a3f3be-9d6f-4d39-8af5-58dbb589af79",
        "eventsWebHook": "https://api.negocio.pe/webhook/terminal-events",
        "metadata": {
            "customerEmail": "user@example.com",
            "device": "SUNMI-P3",
            "reference": "ORD-20240317-001"
        }
    }
}

Modified at 2026-08-21 18:04:05

Async

Authorization — Pre-auth (Async)

Charge (Async)

🚧 Beta — Early Access#

Callbacks

transactionEvents

Request

Responses

🚧 Beta — Early Access