Authorize payments

POST

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

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.

In México, 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?*

Make sure you include the threeDomainSecure object in your request.

* Applies in Mexico 🇲🇽.

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": "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-07-10 20:43:55

Add a temporary charge or discount

Capture an authorized payment

Authorize payments

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

Request

Responses

Do you have your own 3DS authentication engine?*