Charge

POST

/charge

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

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

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

Save rawResponse.transaction_reference — required for void or refund.

v1.2.0: tip and cashback_amount have been removed from this endpoint.
Both features are now handled by the terminal automatically when enabled in DMS.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Transaction approved.

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠409Conflict

🟠422UnprocessableEntity

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/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": "cliente@ejemplo.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 Accepted and processed.",
    "rawResponse": {
        "authorized_amount": 12000,
        "card_type": "prepaid",
        "cvm_type": "pin",
        "franchise": "VISA",
        "kushki_response": {
            "code": "000",
            "message": "Approval and completed successfully Accepted and processed."
        },
        "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",
        "entryMode": "ICC",
        "showReciptSignature": false,
        "cvm": "pin",
        "aid": "A0000000031010",
        "bin": "453985",
        "isOnlinePinMandatory": false
    },
    "timestamp": 1772636209320
}

Modified at 2026-06-02 16:30:37

Payment Local

Authorization (Pre-auth)

Charge

🚧 Beta — Early Access#

Request

Responses

🚧 Beta — Early Access