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 hay crédito suficiente en la tarjeta de crédito 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 la autorización se capture o expire.

En México, la autorización expira después de:

28 días para tarjetas de crédito

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 cancelarla, 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": "MXN"
    },
    "orderDetails": {
        "siteDomain": "example.com",
        "shippingDetails": {
            "name": "John Doe",
            "phone": "+667566314515",
            "address": "Av Mariscal Caceres",
            "city": "Ayacucho",
            "region": "Ayacucho",
            "country": "Mexico",
            "zipCode": "170402"
        },
        "billingDetails": {
            "name": "John Doe",
            "phone": "+593912345678",
            "address": "Av Mariscal Caceres",
            "city": "Ayacucho",
            "region": "Ayacucho",
            "country": "Mexico",
            "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": "MXN"
        },
        "approvalCode": "000000",
        "approvedTransactionAmount": 59,
        "binInfo": {
            "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
            "bindCard": "545195",
            "cardCountry": "Mexico",
            "lastFourDigits": "5480",
            "type": "credit"
        },
        "cardHolderName": "John Doe",
        "created": 1658360425000,
        "merchantId": "20000000104111374000",
        "merchantName": "Mi Comercio México",
        "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:57:00

Reembolsar una transacción

Preautorización (sin token)

Autorizar pagos

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

Request

Responses

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