Preautorización (sin token)
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/card/v2/preAuthorization
Este es un servicio On-demand disponible solo para empresas con PCI DSS compliance.
Esta funcionalidad está disponible para los siguientes modelos:
☑ Acquirer
☐ Aggregator
Limitaciones
¿Tienes tu propio motor de autenticación 3DS?*
threeDomainSecure en tu request.¿Tienes tu propio motor de suscripciones?*
Esta funcionalidad está disponible para los siguientes modelos:
☑ Acquirer
☐ Aggregator
1.
initialRecurrence en el parámetro transactionMode y procesa la preautorización. En esta transacción inicial debes enviar el CVV.2.
3.
subsequentRecurrence en el parámetro transactionMode e incluye el número transactionReference en el campo initialRecurrenceReference. Ahora ya puedes omitir el CVV.Otra opción para procesar suscripciones externas es enviar el parámetro externalSubscriptionID. Haz clic aquí para más información.
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/card/v2/preAuthorization' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"card": {
"name": "Catalina Fuentes",
"number": "4259078012341233",
"expiryMonth": "03",
"expiryYear": "30",
"cvv": "123"
},
"amount": {
"subtotalIva": 0,
"subtotalIva0": 4000,
"ice": 0,
"iva": 0,
"currency": "CLP"
},
"metadata": {
"Referencia": "99999"
},
"contactDetails": {
"documentType": "RUT",
"documentNumber": "12345678-9",
"email": "user@example.com",
"firstName": "Catalina",
"lastName": "Fuentes",
"phoneNumber": "+56912345678"
},
"orderDetails": {
"siteDomain": "example.com",
"shippingDetails": {
"name": "Catalina Fuentes",
"phone": "+56912345678",
"address1": "Av. Apoquindo 4501",
"address2": "centro 123",
"city": "Santiago",
"region": "Región Metropolitana",
"country": "Chile"
},
"billingDetails": {
"name": "Catalina Fuentes",
"phone": "+56912345678",
"address1": "Av. Apoquindo 4501",
"address2": "centro 123",
"city": "Santiago",
"region": "Región Metropolitana",
"country": "Chile"
}
},
"productDetails": {
"product": [
{
"id": "198952AB",
"title": "eBook Digital Services",
"price": 10000,
"sku": "10101042",
"quantity": 1
}
]
},
"fullResponse": "v2"
}'Response Response Example
201 - fullResponse v2
{
"details": {
"amount": {
"subtotalIva": 0,
"subtotalIva0": 4000,
"ice": 0,
"iva": 0,
"currency": "CLP",
"isDeferred": false
},
"approvalCode": "123456",
"approvedTransactionAmount": 4000,
"binInfo": {
"bank": "WELLSFARGO",
"binCard": "425907",
"cardCountry": "United States of America",
"lastFourDigits": "1233",
"type": "credit"
},
"cardHolderName": "Catalina Fuentes",
"created": 1712159361000,
"merchantId": "20000000101835540000",
"merchantName": "CENTRALIZADA NUEVA PRUEBA GOB",
"messageFields": {
"f38": "123456",
"f39": "00"
},
"paymentBrand": "Visa",
"processorBankName": "Kushki",
"recap": "409415159483",
"requestAmount": 4000,
"responseCode": "000",
"responseText": "Approval and completed successfully Accepted and processed.",
"transactionId": "821712159361453407367",
"transactionReference": "ba48f90b-43ef-4cff-b842-7bc34c41f78e",
"transactionStatus": "APPROVAL",
"transactionType": "PREAUTHORIZATION"
},
"ticketNumber": "821712159361453410",
"transactionReference": "ba48f90b-43ef-4cff-b842-7bc34c41f78e"
}Modified at 2026-09-11 15:08:22