Init Transaction

POST

/cash/v1/charges/init

Init the transaction with a Cash In token provided by Kushki. The Init Transaction delivers a pin number to perform the customer payment and the URL of the receipt.

WARNING

Got a suggestion on this documentation? Contact Us.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-uat.kushkipagos.com/cash/v1/charges/init' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "string",
    "expirationDate": "7 days",
    "amount": {
        "currency": "CLP",
        "subtotalIva": 0,
        "subtotalIva0": 0,
        "iva": 0,
        "ice": 0,
        "extraTaxes": {
            "iac": 0,
            "tasaAeroportuaria": 0,
            "agenciaDeViaje": 0
        }
    },
    "metadata": {
        "key0": "value0",
        "key1": "value1",
        "key2": "value2"
    },
    "webhooks": {
        "events": [
            "approvedTransaction"
        ],
        "headers": [
            {
                "label": "string",
                "value": "string"
            }
        ],
        "urls": [
            "string"
        ]
    },
    "fullResponse": "v2"
}'

Response Example

200 - Example 1

{
    "details": {
        "agreementDetails": [
            {
                "storeName": [
                    {
                        "agreementNumber": "string",
                        "processorName": "string"
                    }
                ]
            }
        ],
        "amount": {
            "currency": "CLP",
            "subtotalIva": 0,
            "subtotalIva0": 0,
            "iva": 0,
            "ice": 0,
            "extraTaxes": {
                "iac": 0,
                "tasaAeroportuaria": 0,
                "agenciaDeViaje": 0
            }
        },
        "description": "string",
        "documentNumber": "CC",
        "documentType": "string",
        "expiration": 0,
        "lastName": "string",
        "merchantId": "string",
        "merchantName": "string",
        "name": "string",
        "transactionId": "string",
        "transactionStatus": "string"
    },
    "pdfUrl": "string",
    "pin": "string",
    "ticketNumber": "string",
    "transactionReference": "string"
}

Modified at 2026-04-16 17:10:16

Request a cash in token

Transaction Status