Autorizar pagos

https://api-uat.kushkipagos.com

POST

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

Tienes un máximo de 7 días calendario para hacer la captura. Pasado ese plazo, se libera el monto retenido en la tarjeta de crédito. Transbank no permite liberar el monto aprobado si no se captura dentro de los 7 días.

Usa este endpoint para solicitar una autorización sobre un cargo recurrente con tarjeta asíncrono existente, identificado por su subscriptionId, creado en el endpoint Init an async card recurring charge.

Autorizas un pago con tarjeta de crédito cuando quieres verificar que la tarjeta de crédito del cliente tiene crédito suficiente antes de procesar la venta. El cupo de crédito del tarjetahabiente se reduce en el monto de la autorización hasta que la autorización se captura o vence.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Authorize payments

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

Modified at 2026-10-22 14:13:15

Iniciar un cargo recurrente con tarjeta asíncrono

Capturar un pago autorizado