Autorizar pagos

https://api-uat.kushkipagos.com

POST

/card/v1/preAuthorization

Usa este endpoint para solicitar una autorización con un token entregado por Kushki.

Autorizas un pago con tarjeta cuando quieres verificar que existe crédito suficiente en la tarjeta del cliente antes de procesar una venta. El límite de crédito del tarjetahabiente se reducirá por el monto de la autorización hasta que esta se capture o expire.

La autorización expira a los 28 días para tarjetas de crédito y a los 7 días para tarjetas de débito, contados desde el momento de la solicitud.

NOTA: Una autorización se puede cancelar con el endpoint Void a transaction. Después de la cancelación, no se pueden hacer reautorizaciones sobre la transacción cancelada.

¿Tienes tu propio motor de autenticación 3DS?*

Asegúrate de incluir el objeto threeDomainSecure en tu request.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Created

Bodyapplication/json

🟠400Bad Request

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location '/card/v1/preAuthorization' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "token": "8b91be6433c94a98b2b8db6a3e7e564d",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 39,
        "ice": 0,
        "iva": 0,
        "currency": "PEN"
    },
    "orderDetails": {
        "siteDomain": "example.com",
        "shippingDetails": {
            "name": "John Doe",
            "phone": "+51912345678",
            "address": "Av Mariscal Caceres",
            "city": "Ayacucho",
            "region": "Ayacucho",
            "country": "Peru",
            "zipCode": "170402"
        },
        "billingDetails": {
            "name": "John Doe",
            "phone": "+51912345678",
            "address": "Av Mariscal Caceres",
            "city": "Ayacucho",
            "region": "Ayacucho",
            "country": "Peru",
            "zipCode": "170402"
        }
    },
    "months": 3,
    "fullResponse": "v2",
    "metadata": {
        "key0": "value0",
        "key1": "value1",
        "key2": "value2"
    }
}'

Response Example

201 - fullResponse v2

{
    "details": {
        "amount": {
            "subtotalIva": 0,
            "subtotalIva0": 59,
            "ice": 0,
            "iva": 0,
            "currency": "PEN"
        },
        "approvalCode": "000000",
        "approvedTransactionAmount": 59,
        "binInfo": {
            "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
            "bindCard": "545195",
            "cardCountry": "Peru",
            "lastFourDigits": "5480",
            "type": "credit"
        },
        "cardHolderName": "John Doe",
        "created": 1658360425000,
        "merchantId": "20000000104111374000",
        "merchantName": "Mi Comercio Perú",
        "paymentBrand": "Master Card",
        "processorBankName": "0032~BANCO INTERNACIONAL",
        "requestAmount": 59,
        "responseCode": "000",
        "responseText": "Transacción aprobada",
        "transactionId": "985906214634267722",
        "transactionReference": "8a42f3a2-fa30-4019-b8f6-9bfc7c78e669",
        "transactionStatus": "APPROVAL",
        "transactionType": "PREAUTHORIZATION"
    },
    "ticketNumber": "073884255559778896",
    "transactionReference": "8a42f3a2-fa30-4019-b8f6-9bfc7c78e669"
}

Modified at 2026-09-11 14:53:08

Solicitar opciones de diferido

Reautorizar pagos

Autorizar pagos

¿Tienes tu propio motor de autenticación 3DS?*#

Request

Responses

¿Tienes tu propio motor de autenticación 3DS?*