Authorize payments

POST

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

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 on an existing async card recurring charge, identified by its subscriptionId, created in the Init an async card recurring charge endpoint.

You authorize a credit 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

Path Params

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//authorize' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": {
        "currency": "CLP",
        "subtotalIva": 0,
        "subtotalIva0": 0,
        "iva": 0,
        "ice": 0,
        "extraTaxes": {
            "iac": 0,
            "tasaAeroportuaria": 0,
            "agenciaDeViaje": 0
        }
    },
    "name": "string",
    "lastName": "string",
    "email": "string",
    "orderDetails": {
        "siteDomain": "string",
        "shippingDetails": {
            "name": "string",
            "phone": "string",
            "address": "string",
            "city": "string",
            "region": "string",
            "country": "string",
            "zipCode": "string"
        },
        "billingDetails": {
            "name": "string",
            "phone": "string",
            "address": "string",
            "city": "string",
            "region": "string",
            "country": "string",
            "zipCode": "string"
        }
    },
    "fullResponse": "v2"
}'

Response Example

200 - Example 1

{
    "details": {
        "amount": {
            "currency": "CLP",
            "subtotalIva": 0,
            "subtotalIva0": 0,
            "iva": 0,
            "ice": 0,
            "extraTaxes": {
                "iac": 0,
                "tasaAeroportuaria": 0,
                "agenciaDeViaje": 0
            }
        },
        "approvalCode": "string",
        "approvedTransactionAmount": 0,
        "binInfo": {
            "bank": "string",
            "binCard": "string",
            "cardCountry": "string",
            "lastFourDigits": "string",
            "type": "string"
        },
        "created": 0,
        "merchantId": "string",
        "merchantName": "string",
        "paymentBrand": "string",
        "processorBankName": "string",
        "requestAmount": 0,
        "responseCode": "string",
        "responseText": "string",
        "transactionId": "string",
        "transactionReference": "string",
        "transactionStatus": "APPROVAL",
        "transactionType": "string",
        "maskedCreditCard": "string",
        "token": "string"
    },
    "ticketNumber": "string",
    "subscriptionId": "string"
}

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

Capture an authorized payment