Pago único
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/pos/v1/transaction
Canales de lectura soportados
Recibir pagos
Estructura
Cargo único
charge en el campo transaction_type y Authorization en el campo transaction_mode como parte del body de tu solicitud.Cargos en diferido
https://api-uat.kushkipagos.com
/pos/v1/transaction en el body de la solicitud, incluye charge en el campo transaction_type y Authorization en el campo transaction_mode. Además, incluye el valor de is_deferred en true, envía el objeto deferred y enmonths incluye el total de meses en los que se diferirá el pago de tu cliente.Colombia 🇨🇴
months dentro del objeto deferred. El parámetro credit_type no es requerido en estos escenarios porque no aplica aquí."deferred": {
"months": "10"
}Aceptar pagos con propina
https://api-uat.kushkipagos.com
/pos/v1/transaction e incluye el monto de la propina en el campo tip. Envía Authorization en el campo transaction_mode y Charge en el campo transaction_type como parte del body de la solicitud.El monto de la propina es adicional al monto total de la transacción enviado en los campos subtotal_ivaosubtotal_iva0
Aceptar pagos con cashback
https://api-uat.kushkipagos.com /pos/v1/transaction y envía el valor del parámetro is_cashback en true y especifica el monto del cashback en cashback_amount.Importante
Ten en cuenta que el cashback solo funciona con tarjetas locales. El cashback no está soportado en transacciones contactless. Asegúrate de que reading_typeno tenga el valorNFC.
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api-uat.kushkipagos.com/pos/v1/transaction' \
--header 'Private-Credential-Id;' \
--header 'Content-Type: application/json' \
--data '{
"amount": {
"currency": "COP",
"iva": 0,
"subtotal_iva": 0,
"subtotal_iva0": 60000,
"tip": 0,
"extra_taxes": {
"airport_tax": 0,
"iac": 0,
"ice": 0,
"travel_agency": 0
}
},
"card_details": {
"enc_tlv": "CE447A062C49774934E42A7F826668C0C478E38402C158062EE794C0E471B43EA8CE49C256C2C8B157526B0B2BE74FC23F65E18D4F52B99A1A0910E6CCD9B11A32D6D537E2B6E2B011C89569DE6A3D53318080BC77E0E70B398ED3083FD7366CCF8FB4DBF34A116E6D52CFBEF26371878D842034E5029EF62DF235D2C427F04102E451773D9E8975978917E3BC531327702967052E239F8C592734AE14688E603C52B858FC1D97B763AE623603F1475FFFB065EC07AF7A29",
"pin_ksn": "FFFF4357486333600002",
"reading_type": "ICC",
"tracks": {
"enc_track2": "283587285CE10278E7FA50AD5C97CFFE87F472C9FE6406F8",
"track_ksn": "FFFF4357486333600002"
}
},
"card": {
"card_holder_name": "John Doe"
},
"contact_details": {
"document_number": "",
"document_type": "-1",
"email": "",
"first_name": "",
"last_name": "",
"second_last_name": "",
"phone_number": ""
},
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"terminal_id": "PB04216R20537",
"version": "Kushki SunmiV1.1.26",
"has_print": true,
"location": {
"latitude": -0.22480833333333333,
"longitude": -78.487955
},
"user": "juan.perez",
"friendly_name": "Caja principal",
"serial": "SN123456",
"type": "COUNTERTOP",
"connectivity": "WIFI"
},
"country": "COL",
"is_deferred": false,
"client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a",
"merchant_id": 987654321,
"transaction_type": "charge",
"transaction_mode": "Authorization",
"is_cashback": false,
"cvm_type": "none"
}'Response Response Example
200 - Approved charge transaction
{
"additional_amounts": {
"account_type": "",
"amount": 0,
"amount_type": "",
"card_type": "",
"currency_code": ""
},
"authorized_amount": 611,
"card_type": "credit",
"cvm_type": "none",
"F11": "101619",
"franchise": "MASTERCARD",
"kushki_response": {
"code": "000",
"message": "Transacción Aprobada."
},
"message_fields": {
"F38": "121866",
"F39": "00"
},
"transaction_reference": "fb1d8f34-31fc-4d9d-ab7e-375d7f0801a5",
"transaction_status": "APPROVAL",
"transaction_type": "charge",
"ticket_number": "111727462978861299"
}Modified at 2026-09-11 15:07:22