Autorización y captura
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/pos/v1/transaction
Canales de lectura soportados
Hacer preautorizaciones (retener el saldo de una tarjeta)
Estructura
preAuth en el campo transaction_type y Authorization en el campo transaction_mode como parte del body de tu request. (Revisa el ejemplo completo al lado derecho de la pantalla).Make reauthorizations
NOTA: Una reautorización se puede anular. Después de anularla, no se pueden hacer más reautorizaciones sobre esa transacción.
Estructura
reAuthorization en el campo transaction_type y Authorization en el campo transaction_mode como parte del body de tu request. (Revisa el ejemplo completo al lado derecho de la pantalla).Descubre cómo hacer una reautorización sin tarjeta.
Capture a payment
Estructura
capture en el campo transaction_type, Authorization en el campo transaction_mode y el transaction_reference de la transacción a capturar como parte del body de tu request (el transaction_reference debe venir de una autorización, no de una reautorización). (Revisa el ejemplo completo al lado derecho de la pantalla).Descubre cómo hacer una captura sin tarjeta.
Cardless operations
NOTA: También puedes revisar la información de un reembolso sin tarjeta.
omit_card con el valor true en el request. Los campos obligatorios para una operación sin tarjeta son los siguientes:| PROPIEDAD | TIPO | Valores permitidos |
|---|---|---|
amount | Object | |
transaction_mode | String | Authorization, Void |
transaction_type | String | charge, reAuthorization, capture |
client_transaction_id | String | |
transaction_reference | String | |
omit_card | Boolean | true |
NOTA: Las operaciones sin tarjeta están disponibles para tarjetas de crédito y débito Visa y Mastercard en Chile y México.
Ejemplo de una operación sin tarjeta
omit_card con el valor true y omite los demás campos no obligatorios:{
"amount": {
"currency": "MXN",
"iva": 0.0,
"subtotal_iva": 0.0,
"subtotal_iva0": 600
},
"transaction_mode": "Authorization",
"transaction_type": "reAuthorization",
"client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a",
"transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7",
"omit_card": true
}{
"amount": {
"currency": "MXN",
"iva": 0.0,
"subtotal_iva": 0.0,
"subtotal_iva0": 600
},
"transaction_mode": "Authorization",
"transaction_type": "capture",
"client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a",
"transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7",
"omit_card": true
}{
"amount": {
"currency": "MXN",
"iva": 0.0,
"subtotal_iva": 0.0,
"subtotal_iva0": 600
},
"transaction_mode": "Void",
"transaction_type": "charge",
"client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a",
"transaction_reference": "f2f29080-0214-42c0-95a5-77ecf3434cd7",
"omit_card": true
}Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/pos/v1/transaction' \
--header 'Private-Credential-Id;' \
--header 'Content-Type: application/json' \
--data '{
"card": {
"card_holder_name": "John Doe"
},
"amount": {
"iva": 0,
"tip": 0,
"currency": "MXN",
"extra_taxes": {
"iac": 0,
"ice": 0,
"airport_tax": 0,
"travel_agency": 0
},
"subtotal_iva": 0,
"subtotal_iva0": 600
},
"country": "MEX",
"cvm_type": "none",
"is_cashback": false,
"pos_details": {
"brand": "SUNMI",
"model": "P2-EU",
"version": "Kushki SunmiV1.1.26",
"location": {
"latitude": -0.22480833333333333,
"longitude": -78.487955
},
"has_print": true,
"terminal_id": "PB04216R20537"
},
"card_details": {
"tracks": {
"track_ksn": "FFFF4357486333600002",
"enc_track2": "283587285CE10278E7FA50AD5C97CFFE87F472C9FE6406F8"
},
"enc_tlv": "CE447A062C49774934E42A7F826668C0C478E38402C158062EE794C0E471B43EA8CE49C256C2C8B157526B0B2BE74FC23F65E18D4F52B99A1A0910E6CCD9B11A32D6D537E2B6E2B011C89569DE6A3D53318080BC77E0E70B398ED3083FD7366CCF8FB4DBF34A116E6D52CFBEF26371878D842034E5029EF62DF235D2C427F04102E451773D9E8975978917E3BC531327702967052E239F8C592734AE14688E603C52B858FC1D97B763AE623603F1475FFFB065EC07AF7A29",
"pin_ksn": "FFFF4357486333600002",
"reading_type": "ICC"
},
"contact_details": {
"email": "",
"last_name": "",
"first_name": "",
"phone_number": "",
"document_type": "-1",
"document_number": "",
"second_last_name": ""
},
"transaction_mode": "Authorization",
"transaction_type": "preAuth",
"client_transaction_id": "6680eadc-6c8d-44aa-8ca0-18e061c1472a"
}'Response Response Example
200 - Approved preAuth transaction
{
"additional_amounts": {
"account_type": "",
"amount": 0,
"amount_type": "",
"card_type": "",
"currency_code": "MXN"
},
"authorized_amount": 601,
"card_type": "credit",
"cvm_type": "none",
"F11": "101658",
"franchise": "MASTERCARD",
"kushki_response": {
"code": "000",
"message": "Transacción Aprobada."
},
"message_fields": {
"F38": "890862",
"F39": "00"
},
"transaction_reference": "2aa48997-a545-4bdb-8e1c-a57546f03e5f",
"transaction_status": "APPROVAL",
"transaction_type": "preAuth",
"ticket_number": "111727462978861299"
}Modified at 2026-09-11 15:01:08