Charge
POST
/terminal/v1/{terminalSerial}/sync/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.
Standard flow for most retail merchants.
and blocks until the customer completes card interaction and the acquirer responds.
Save rawResponse.transaction_reference— required forvoidorrefund.
Request
Path Params
Header Params
Body Params application/jsonRequired
Responses
Request 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": "cliente@ejemplo.com",
"device": "SUNMI-P3"
}
}'Response 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",
"cardHolderName": "string",
"cardType": "UNKNOWN",
"entryMode": "ICC",
"showReciptSignature": false,
"cvm": "pin",
"aid": "A0000000031010",
"bin": "453985",
"isOnlinePinMandatory": false
},
"timestamp": 1772636209320
}Modified at 2026-06-09 20:27:34