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.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-uat.kushkipagos.com/cash/v1/charges/init' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "token": "string",
    "expirationDate": "7 days",
    "amount": {
        "currency": "PEN",
        "subtotal_iva": 0,
        "subtotal_iva0": 0,
        "iva": 0,
        "ice": 0,
        "extraTaxes": {
            "airport_tax": 0,
            "iac": 0,
            "tasaAeroportuaria": 0,
            "agenciaDeViaje": 0,
            "IVAagenciaDeViaje": 0,
            "propina": 0,
            "tip": 0,
            "stateTax": 0,
            "municipalTax": 0,
            "reducedStateTax": 0
        }
    },
    "metadata": {
        "key0": "string",
        "key1": "string",
        "key2": "string"
    },
    "webhooks": {
        "events": [
            "approvedTransaction"
        ],
        "headers": [
            {
                "label": "string",
                "value": "string"
            }
        ],
        "urls": [
            "string"
        ]
    },
    "fullResponse": "v2"
}'

Response Example

200 - Without fullResponse

{
    "agreementNumber": "9595950804",
    "barCodeUrl": "https://api-uat.kushkipagos.com/cash/v1/charges/193222411482/barcode",
    "getPinBarCode": "4150000000054244802015549183763900100009620190417",
    "pins": [
        {
            "pin": "1554244909",
            "processorName": "BancoBogota"
        },
        {
            "pin": "1231242",
            "processorName": "Payvalida"
        }
    ],
    "pdfUrl": "https://api-uat.kushkipagos.com/cash/v1/charges/2388729046399317/receipt",
    "pdf": [
        "https://api-uat.kushkipagos.com/cash/v1/charges/2388729046399317/receipt"
    ],
    "pin": "1554244909",
    "ticketNumber": "193222411482",
    "transactionReference": "fa3cb92f-f53f-46e8-a9f9-0c40e9ae2df2",
    "agreementDetails": [
        {
            "Baloto": [
                {
                    "agreementNumber": "9595950804",
                    "processorName": "BancoBogota"
                }
            ]
        },
        {
            "Carulla": [
                {
                    "agreementNumber": "9595950804",
                    "processorName": "BancoBogota"
                }
            ]
        },
        {
            "efecty": [
                {
                    "agreementNumber": "110342",
                    "processorName": "Payvalida"
                }
            ]
        },
        {
            "bancolombia": [
                {
                    "agreementNumber": "54245",
                    "processorName": "Payvalida"
                }
            ]
        }
    ]
}

Modified at 2026-07-28 17:13:11

Request a cash in token

Transaction Status