Charge
Testing
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/terminal/v1/sync/charge
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.
completes card interaction and the acquirer responds.
Save rawResponse.transaction_reference— required forvoidorrefund.
Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/terminal/v1/sync/charge' \
--header 'Authorization: nRvpFJZHjqLU4k8Rz2YiDvxA3mQs9oB1cW7eT0=' \
--header 'timestamp: 1700000000000' \
--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 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-31 16:31:06