Authorize payments

POST

/card/v1/preAuthorization

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.

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

NOTE: An authorization can be canceled through the Void a transaction endpoint. After performing the cancellation, no reauthorizations can be made on the canceled transaction.

Do you have your own 3DS authentication engine?*

Make sure you include the threeDomainSecure object in your request.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Created

Bodyapplication/json

🟠400Bad Request

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/card/v1/preAuthorization' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "token": "8b91be6433c94a98b2b8db6a3e7e564d",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 39,
        "ice": 0,
        "iva": 0,
        "currency": "PEN"
    },
    "orderDetails": {
        "siteDomain": "example.com",
        "shippingDetails": {
            "name": "John Doe",
            "phone": "+51912345678",
            "address": "Av Mariscal Caceres",
            "city": "Ayacucho",
            "region": "Ayacucho",
            "country": "Peru",
            "zipCode": "170402"
        },
        "billingDetails": {
            "name": "John Doe",
            "phone": "+51912345678",
            "address": "Av Mariscal Caceres",
            "city": "Ayacucho",
            "region": "Ayacucho",
            "country": "Peru",
            "zipCode": "170402"
        }
    },
    "months": 3,
    "fullResponse": "v2",
    "metadata": {
        "key0": "value0",
        "key1": "value1",
        "key2": "value2"
    }
}'

Response Example

201 - fullResponse v2

{
    "details": {
        "amount": {
            "subtotalIva": 0,
            "subtotalIva0": 59,
            "ice": 0,
            "iva": 0,
            "currency": "PEN"
        },
        "approvalCode": "000000",
        "approvedTransactionAmount": 59,
        "binInfo": {
            "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
            "bindCard": "545195",
            "cardCountry": "Peru",
            "lastFourDigits": "5480",
            "type": "credit"
        },
        "cardHolderName": "John Doe",
        "created": 1658360425000,
        "merchantId": "20000000104111374000",
        "merchantName": "Mi Comercio Perú",
        "paymentBrand": "Master Card",
        "processorBankName": "0032~BANCO INTERNACIONAL",
        "requestAmount": 59,
        "responseCode": "000",
        "responseText": "Transacción aprobada",
        "transactionId": "985906214634267722",
        "transactionReference": "8a42f3a2-fa30-4019-b8f6-9bfc7c78e669",
        "transactionStatus": "APPROVAL",
        "transactionType": "PREAUTHORIZATION"
    },
    "ticketNumber": "073884255559778896",
    "transactionReference": "8a42f3a2-fa30-4019-b8f6-9bfc7c78e669"
}

Modified at 2026-07-27 14:49:26

Request deferred options

Reauthorize payments

Authorize payments

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

Request

Responses

Do you have your own 3DS authentication engine?*