6. Authorize payments
POST
/card/v1/preAuthorization
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-uat.kushkipagos.com/card/v1/preAuthorization' \
--header 'Private-Merchant-Id: ' \
--header 'Content-Type: application/json' \
--data-raw '{
"token": "",
"amount": {
"subtotalIva": 0,
"subtotalIva0": 1000,
"ice": 0,
"iva": 0,
"currency": "MXN"
},
"orderDetails": {
"siteDomain": "example.com",
"shippingDetails": {
"name": "John Doe",
"phone": "+523912345678",
"address1": "Eloy Alfaro 139 y Catalina Aldaz",
"address2": "centro 123",
"city": "Querétaro",
"region": "Centro",
"country": "México",
"zipCode": "170402"
},
"billingDetails": {
"name": "John Doe",
"phone": "+523912345678",
"address1": "Eloy Alfaro 139 y Catalina Aldaz",
"address2": "centro 123",
"city": "Querétaro",
"region": "Centro",
"country": "México",
"zipCode": "170402"
}
},
"fullResponse": "v2"
}'Response Response Example
201 - 201 - fullResponse true
{
"ticketNumber": "573118394633955756",
"details": {
"token": "84a233a4145e43d0acc2d5db87c4f50f",
"orderDetails": {
"siteDomain": "example.com",
"shippingDetails": {
"name": "John Doe",
"phone": "+593912345678",
"address1": "Eloy Alfaro 139 y Catalina Aldaz",
"address2": "centro 123",
"city": "Querétaro",
"region": "Centro",
"country": "México",
"zipCode": "170402"
},
"billingDetails": {
"name": "John Doe",
"phone": "+593912345678",
"address1": "Eloy Alfaro 139 y Catalina Aldaz",
"address2": "centro 123",
"city": "Querétaro",
"region": "Centro",
"country": "México",
"zipCode": "170402"
}
},
"fullResponse": true,
"currencyCode": "MXN",
"ip": "186.28.11.9",
"maskedCardNumber": "545195XXXXXX5480",
"approvedTransactionAmount": 1000,
"acquirerBank": "BANJERCITO",
"subtotalIva": 0,
"subtotalIva0": 1000,
"created": 1650899159000,
"responseCode": "000",
"transactionType": "PREAUTHORIZATION",
"approvalCode": "000000",
"transactionStatus": "APPROVAL",
"syncMode": "online",
"merchantId": "20000000104111374000",
"processorType": "gateway",
"transactionId": "479187459268487764",
"responseText": "Transacción aprobada",
"cardHolderName": "John Doe",
"lastFourDigits": "5480",
"binCard": "545195",
"paymentBrand": "Master Card",
"cardType": "credit",
"iceValue": 0,
"requestAmount": 1000,
"ivaValue": 0,
"merchantName": "Merchant MX",
"processorName": "Elavon Processor",
"processorBankName": "0032~BANCO INTERNACIONAL",
"transactionReference": "095f4bfe-5334-4012-8289-d0c058d108c5",
"issuingBank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
"country": "Mexico",
"foreignCard": true,
"binInfo": {
"bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
"type": "credit"
},
"cardCountry": "Ecuador",
"rules": []
},
"transactionReference": "095f4bfe-5334-4012-8289-d0c058d108c5"
}Modified at 2026-04-15 21:23:36