Charge

POST

/terminal/v1/sync/charge

Single-step payment: authorization + capture in one operation.
Standard flow for most retail and restaurant merchants.

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

The terminal activates the card reader and blocks until the customer
completes card interaction and the acquirer responds.

Save rawResponse.transaction_reference — required for void or refund.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Transaction approved.

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/sync/charge' \
--header 'Authorization;' \
--header 'timestamp;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": {
        "iva": 0,
        "subtotal_iva": 0,
        "subtotal_iva0": 12000,
        "extra_taxes": {
            "airport_tax": 0,
            "iac": 0,
            "ice": 0,
            "travel_agency": 0
        }
    },
    "client_transaction_id": "c5a3f3be-9d6f-4d39-8af5-58dbb589af79",
    "metadata": {
        "reference": "ORD-20240317-001",
        "customer_email": "user@example.com",
        "device": "SUNMI-P3"
    }
}'

Response Example

200 - Example 1

{
    "approved": true,
    "responseCode": "00",
    "authCode": "123456",
    "issuerAuthenticationData": "663cddbc3ec72e76",
    "issuerScript1": "string",
    "issuerScript2": "string",
    "message": "Approval and completed successfully.",
    "rawResponse": {
        "authorized_amount": 12000,
        "card_type": "prepaid",
        "cvm_type": "pin",
        "franchise": "VISA",
        "kushki_response": {
            "code": "000",
            "message": "Approval and completed successfully."
        },
        "transaction_reference": "983a7480-6d97-41c3-bdd8-d3cde6685c17",
        "transaction_status": "APPROVAL",
        "transaction_type": "charge",
        "ticket_number": "110993659310263283",
        "F11": "147009",
        "message_fields": {
            "F38": "123456",
            "F39": "00",
            "F55": "string"
        }
    },
    "cardData": {
        "pan": "**** **** **** 0043",
        "cardHolderName": "string",
        "cardType": "VISA",
        "entryMode": "ICC",
        "showReciptSignature": false,
        "cvm": "pin",
        "aid": "A0000000031010",
        "bin": "453985",
        "isOnlinePinMandatory": false
    },
    "timestamp": 1772636209320
}

Modified at 2026-08-20 16:56:16

Sync

Authorization (Pre-auth)

Charge

🚧 Beta — Early Access#

Request

Responses

🚧 Beta — Early Access