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. Después de ese plazo, el monto retenido en la tarjeta de crédito se libera. Transbank no permite liberar el monto aprobado si no se captura dentro de 7 días.

Usa este endpoint para solicitar una autorización sobre un cargo recurrente con tarjeta async 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 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.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Bodyapplication/json

🟠400Bad Request

🔴500Server Error

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-09-11 15:09:08

Agregar un cargo o descuento temporal

Capturar un pago autorizado