Autorizar pagos

https://api-uat.kushkipagos.com

POST

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

Esta funcionalidad está disponible para los siguientes modelos:
☑ Adquirencia
☐ Agregador

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 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 reduce por el monto de la autorización hasta que la autorización se captura o expira.

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

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

Esta funcionalidad está disponible para los siguientes modelos:
☑ Adquirencia
☑ Agregador

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

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 'https://api-uat.kushkipagos.com/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": "COP"
    },
    "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 15:05:01

Agregar un cargo o descuento temporal

Capturar un pago autorizado

Autorizar pagos

Esta funcionalidad está disponible para los siguientes modelos:#

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

Esta funcionalidad está disponible para los siguientes modelos:#

Request

Responses

Esta funcionalidad está disponible para los siguientes modelos:

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

Esta funcionalidad está disponible para los siguientes modelos: