Autorizar pagos

https://api-uat.kushkipagos.com

POST

/subscriptions/v1/card/{subscriptionId}/authorize

Usa este endpoint para solicitar una autorización sobre un pago one-click o programado existente, identificado por su subscriptionId, creado en el endpoint Create a recurring charge.

Autorizas un pago con tarjeta cuando quieres verificar que la tarjeta del cliente tiene crédito suficiente antes de procesar una venta. El límite de crédito del tarjetahabiente se reduce por el monto de la autorización hasta que la autorización se captura o expira.

En México, la autorización expira después de 28 días para tarjetas de crédito y después de 7 días para tarjetas de débito, contados desde el momento de la solicitud.

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

Asegúrate de incluir el objeto threeDomainSecure en tu petición.

* Aplica en México 🇲🇽.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Bodyapplication/json

🟠400Bad Request

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

AuthorizationWith antifraud checkPE-Deferred

curl --location '/subscriptions/v1/card//authorize' \
--header 'Private-Merchant-Id;' \
--header 'Idempotency-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": {
        "ice": 0,
        "iva": 0,
        "subtotalIva": 0,
        "subtotalIva0": 600,
        "currency": "MXN"
    },
    "name": "John",
    "lastName": "Doe",
    "email": "user@example.com",
    "fullResponse": "v2"
}'

Response Example

201 - Authorize payments

{
    "ticketNumber": "627388610047090811",
    "transactionReference": "998ba5fd-e590-4615-a84a-83b734437c57"
}

Modified at 2026-09-11 14:57:46

Agregar un cargo o descuento temporal

Capturar un pago autorizado

Autorizar pagos

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

Request

Responses

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