cci: it is required, payouts go in real time. It can go together with bank_code and account_type. account_number is deprecated: it is not needed, the payout goes to the CCI. It is still accepted.account_type 2 together with the cci. Without it the payout goes as a savings account and the bank rejects it ("Account Number does not exist"). account_type can go with the cci without account_number.400 Validation failed with field beneficiary.bank_account.cci.400 Validation failed with field beneficiary.bank_account.cci ("CCI check digits are invalid"). It is almost always a mistyped CCI: ask the account holder for it again. This also applies in demo mode: use a real CCI or one of the examples ("Main" or "CCI only").bank_code together with the cci, it must be the CCI's first 3 digits. Otherwise the response is 400 Validation failed with field beneficiary.bank_account.bank_code ("Bank code 011 does not match the CCI, which belongs to bank code 003").cci, the response is 400 Validation failed with field beneficiary.bank_account.cci ("CCI is required for bank code 011 (BBVA)").order_id prefixes and sends the matching notification to the merchant's payout_webhook ~500 ms after the payout is created.order_id starts with | Status sent in the webhook |
|---|---|
DEMO_SUCCESS | SUCCESS |
DEMO_REJECTED | REJECTED |
DEMO_SUCCESS_001, DEMO_REJECTED_test, etc.status: "PENDING").x-kambia-signature) as a real notification.SUCCESS includes receipt_url: "https://demo.kambia.app" (test link).{
"status_code": 201,
"message": "Payout created successfully",
"payout": {
"id": "645",
"country": "PER",
"amount": 25000,
"currency": "PEN",
"order_id": "CU_1767031321",
"status": "CREATED",
"created_at": "2026-01-19T21:31:16.475102"
}
}