Authorize payments

POST

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

This functionality is available for the following models:
☑ Acquirer
☐ Aggregator

Use this endpoint to request an authorization on an existing one-click or scheduled payment, identified by its subscriptionId, created in the Create a recurring charge endpoint.

You authorize a card payment when you want to verify that sufficient credit exists on a customer's credit card before processing a sale. The cardholder's credit limit will be reduced by the amount of the authorization until the authorization is captured or expires.

The authorization will expire after 28 days for credit cards and after 7 days for debit cards from the time of request.

Do you have your own 3DS authentication engine?*

This functionality is available for the following models:
☑ Acquirer
☑ Aggregator

Make sure you include the threeDomainSecure object in your request.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Bodyapplication/json

🟠400

🔴500

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-07-29 01:33:16

Add a temporary charge or discount

Capture an authorized payment

Authorize payments

This functionality is available for the following models:#

Do you have your own 3DS authentication engine?*#

This functionality is available for the following models:#

Request

Responses

This functionality is available for the following models:

Do you have your own 3DS authentication engine?*

This functionality is available for the following models: