Init Transaction

POST

/card-async/v1/init

Init the transaction with a card async token provided by Kushki which represents the customer's payment.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Bodyapplication/json

🟠400Bad Request

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/card-async/v1/init' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "token": "AbCDef123456Z7Ghi8901234jkLMNopQ",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 10000,
        "iva": 0,
        "ice": 0,
        "currency": "CLP"
    },
    "webhooks": [
        {
            "events": [
                "approvedTransaction",
                "declinedTransaction"
            ],
            "headers": [
                {
                    "label": "json",
                    "value": "12"
                }
            ],
            "urls": [
                "https://yoursite.com/kushki/notify"
            ]
        }
    ],
    "fullResponse": "v2"
}'

Response Example

200 - Single response

{
    "redirectUrl": "https://kushkipagos.com/card-async/v1/agent/df825dd6367e4142a24029805e9b4f27",
    "transactionReference": "33c5d084-81bc-4b05-9078-867026a34490"
}

Modified at 2026-07-28 22:28:08

Request a card async token

Authorize payments