> For the complete documentation index, see [llms.txt](https://docs.pandablue.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pandablue.com/cashouts/countries-validations/american-countries/colombia/pandablue-wallet-cashouts-to-the-panda-wallet.md).

# Pandablue Wallet: Cashouts to the Panda Wallet

## 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. `+57 3001234567`. 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.

{% hint style="warning" %}
**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.
{% endhint %}

## Example Request

```json
{
    "login": "xxxxxxxx",
    "pass": "xxxxxxxx",
    "external_id": "30000000001",
    "country": "CO",
    "currency": "COP",
    "amount": 185000,
    "document_id": "848392783",
    "document_type": "CC",
    "bank_account": "+57 3001234567",
    "bank_code": "30000",
    "account_type": "C",
    "phone": "+57 3001234567",
    "email": "beneficiary@email.com",
    "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:

{% stepper %}
{% step %}

## `CREATED`

The cashout request was accepted.
{% endstep %}

{% step %}

## `DELIVERED`

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

{% step %}

## `COMPLETED` or `REJECTED`

Funds were credited to the beneficiary's Pandablue Wallet, or the credit could not be applied.
{% endstep %}
{% endstepper %}

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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.pandablue.com/cashouts/countries-validations/american-countries/colombia/pandablue-wallet-cashouts-to-the-panda-wallet.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.