Authorize payments

POST

/subscriptions/v1/card-async/preAuthorization

There is a maximum time of 7 calendar days to make the capture. After that time, the amount withheld from the credit card will be released. Transbank does not allow the release of the approved amount if it is not captured within 7 days.

Use this endpoint to request an authorization using a token provided by Kushki.

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.

WARNING

Got a suggestion on this documentation? Contact Us.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-uat.kushkipagos.com/subscriptions/v1/card-async/preAuthorization' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "subscriptionId": "string",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 0,
        "iva": 0
    },
    "metadata": {
        "key0": "value0",
        "key1": "value1",
        "key2": "value2"
    }
}'

Response Example

200 - Example 1

{
    "redirectUrl": "string",
    "transactionReference": "string"
}

Modified at 2026-04-15 21:33:57

Capture an authorized payment

Bin Info