Pandablue Wallet: Cashouts to the Panda Wallet

Pandablue Wallet is Pandablue's digital wallet for beneficiaries in Colombia. Instead of sending funds to a bank account, merchants can send cashouts directly to a beneficiary's Pandablue Wallet using

Key Features

Same Cashouts API. No additional integration is required. Cashouts to the Pandablue Wallet use the standard cashout request — only the bank_code changes to 30000, and bank_account carries the beneficiary's wallet phone number.

Beneficiary identification by phone number. The wallet account is identified by the mobile phone number the beneficiary registered in the Pandablue Wallet app, not by a bank account number. Make sure the phone number you send matches the one registered in the beneficiary's wallet.

Request Validations

Field	Format	Notes
bank_code	30000	Fixed value for Pandablue Wallet
bank_account	Beneficiary's mobile phone	The mobile number registered in the beneficiary's Pandablue Wallet, e.g. [phone]. Regex ^[\s\S]{1,20}$
account_type	C	Fixed value
phone	Beneficiary's mobile phone	Same value as bank_account
document_type / document_id	CC, NIT, CE, PASS	Same rules as standard Colombia cashouts
email	Optional

All remaining fields (login, pass, external_id, country = CO, currency = COP, amount, beneficiary_name, beneficiary_lastname, address, notification_url) follow the standard Colombia cashout validations.

The phone number format is not validated at request time. The bank_account regex accepts any value between 1 and 20 characters, so a malformed or unregistered phone number will not return a validation error. The cashout will be accepted and later transition to REJECTED. Always send the phone number exactly as the beneficiary registered it in the Pandablue Wallet app.

Example Request

{
    "login": "xxxxxxxx",
    "pass": "xxxxxxxx",
    "external_id": "30000000001",
    "country": "CO",
    "currency": "COP",
    "amount": 185000,
    "document_id": "848392783",
    "document_type": "CC",
    "bank_account": "[phone]",
    "bank_code": "30000",
    "account_type": "C",
    "phone": "[phone]",
    "email": "[email protected]",
    "beneficiary_name": "User",
    "beneficiary_lastname": "Test",
    "address": "Calle 18, Colombia",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}

Status Flow & Notifications

Cashouts to the Pandablue Wallet are processed asynchronously:

1

CREATED

The cashout request was accepted.

2

DELIVERED

The cashout is being credited to the beneficiary's wallet. This transition typically happens within minutes.

3

COMPLETED or REJECTED

Funds were credited to the beneficiary's Pandablue Wallet, or the credit could not be applied.

The final status is delivered asynchronously to your notification_url. Always rely on the notification (or the status endpoint) rather than the synchronous response to confirm the credit.

Rejection Scenarios

If the cashout cannot be credited, it transitions to REJECTED and the rejection reason is included in the notification. Common scenarios:

Scenario	What to check
The phone number is not registered to an active Pandablue Wallet	Confirm with the beneficiary that the phone number you sent is the one registered in their wallet
Beneficiary data doesn't match the wallet owner	Verify beneficiary_name, beneficiary_lastname and document_id against the wallet owner's data
The withdrawal expired before being credited	Create a new cashout request
Invalid bank_account format	Ensure the value is a valid Colombian mobile number

Rejections are final. To retry, create a new cashout request with a new external_id and the corrected data.