6. Authorize payments

POST

/card/v1/preAuthorization

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Body

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/card/v1/preAuthorization' \
--header 'Private-Merchant-Id: {{CL-Private-Merchant-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "{{token}}",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 5000,
        "ice": 0,
        "iva": 0,
        "currency": "CLP"
    },
    "orderDetails": {
        "siteDomain": "example.com",
        "shippingDetails": {
            "name": "John Doe",
            "phone": "+563912345678",
            "address1": "Av. Pedro Aguirre Cerda 6100",
            "address2": "Los Cerrillos",
            "city": "Santiago",
            "region": "Metropolitana",
            "country": "Chile",
            "zipcode": "9200000"
        },
        "billingDetails": {
            "name": "John Doe",
            "phone": "+563912345678",
            "address1": "Av. Pedro Aguirre Cerda 6100",
            "address2": "Los Cerrillos",
            "city": "Santiago",
            "region": "Metropolitana",
            "country": "Chile",
            "zipcode": "9200000"
        }
    },
    "months": 3,
    "fullResponse": true
}'

Response Example

201 - 201 - fullResponse true

{
    "ticketNumber": "921320744545583210",
    "details": {
        "token": "98773545474f4f209b49514ac0313b24",
        "orderDetails": {
            "siteDomain": "example.com",
            "shippingDetails": {
                "name": "John Doe",
                "phone": "+563912345678",
                "address1": "Av. Pedro Aguirre Cerda 6100",
                "address2": "Los Cerrillos",
                "city": "Santiago",
                "region": "Metropolitana",
                "country": "Chile",
                "zipcode": "9200000"
            },
            "billingDetails": {
                "name": "John Doe",
                "phone": "+563912345678",
                "address1": "Av. Pedro Aguirre Cerda 6100",
                "address2": "Los Cerrillos",
                "city": "Santiago",
                "region": "Metropolitana",
                "country": "Chile",
                "zipcode": "9200000"
            }
        },
        "months": 3,
        "fullResponse": true,
        "ip": "187.191.8.203",
        "maskedCardNumber": "545195XXXXXX5480",
        "secureId": "31079707-f1a7-4013-b769-fe2f60b90476",
        "secureService": "KushkiOTP",
        "currencyCode": "CLP",
        "buyOrder": "21580704242",
        "approvedTransactionAmount": 5000,
        "acquirerBank": "Transbank",
        "subtotalIva": 0,
        "subtotalIva0": 5000,
        "created": 1657328995000,
        "responseCode": "000",
        "transactionType": "PREAUTHORIZATION",
        "approvalCode": "000000",
        "transactionStatus": "APPROVAL",
        "syncMode": "online",
        "merchantId": "20000000108297093000",
        "processorType": "aggregator_formal",
        "transactionId": "796244432475943456",
        "responseText": "Transacción aprobada",
        "cardHolderName": "John Doe",
        "lastFourDigits": "5480",
        "binCard": "545195",
        "paymentBrand": "Master Card",
        "cardType": "credit",
        "numberOfMonths": 3,
        "iceValue": 0,
        "requestAmount": 5000,
        "ivaValue": 0,
        "merchantName": "Merchant CL",
        "processorName": "Transbank Processor",
        "processorBankName": "0032~BANCO INTERNACIONAL",
        "transactionReference": "5eaaa9c3-f256-40f1-a6e8-21459c7d0f16",
        "issuingBank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
        "country": "Chile",
        "foreignCard": true,
        "socialReason": "Merchant CL",
        "categoryMerchant": "Medium",
        "binInfo": {
            "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
            "type": "credit"
        },
        "cardCountry": "Ecuador",
        "rules": []
    },
    "transactionReference": "5eaaa9c3-f256-40f1-a6e8-21459c7d0f16"
}

Modified at 2026-01-06 19:33:02

5. Request deferred options

7. Capture an authorized payment