> For the complete documentation index, see [llms.txt](https://docs.payvalida.com/api-cashout/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payvalida.com/api-cashout/registrar/recarga-bolsa.md).

# Recarga bolsa

{% hint style="info" %}
Tener en cuenta que actualmente el país y la moneda habilitado es Colombia (343) y Pesos ("COP") respectivamente.

El listado de excepciones de esta funcionalidad se encuentran en la documentación de [Recaudos](https://payvalida.gitbook.io/api-cashin/mensajes-de-error/excepciones).

La identificación del comercio (merchant) y FIXED\_HASH, es generada al momento de [crear una cuenta](https://registro.payvalida.com) en nuestra plataforma y se envía por correo electrónico.
{% endhint %}

{% hint style="info" %}
Para recargas a través de esta API se tiene los siguientes límites máximos:

* Persona natural: 26.000.000 COP
* Persona jurídica: 1.500.000.000 COP
  {% endhint %}

## Recargar

<mark style="color:green;">`POST`</mark> `https://api.payvalida.com/cashout/v1/rechargecashout`

`URL Sandbox: https://api-test.payvalida.com/cashout/v1/rechargecashout`\
\
Este API registra una orden de pago y retorna el parámetro **checkout**,  el cual indica la URL en la cual el comercio deberá completar el pago. Una vez el comercio realice el pago y este sea aprobado, llegará una notificación por correo electrónico indicando la recarga de la bolsa. El correo deberá ser enviado a Payvalida para su configuración.<br>

#### Request Body

| Name           | Type   | Description                                                                                   |
| -------------- | ------ | --------------------------------------------------------------------------------------------- |
| merchant       | string | Identificación de comercio Payvalida. Max 50 carecteres                                       |
| email          | string | Correo electrónico del pagador. Máx 100 caracteres                                            |
| country        | number | Código de país. Máx 3 caracteres. Actualmente solo está habilitado 343.                       |
| order          | string | Identificación única del comercio para  la orden generada. Máx 100 caracteres                 |
| money          | string | Código ISO de la moneda de la orden. Máx 3 caracteres, actualmente solo está habilitado "COP" |
| amount         | string | Monto de la orden. Solo acepta números enteros                                                |
| description    | string | Descripción de la orden. Máx 250 caracteres                                                   |
| language       | string | Lenguaje del mensaje. Máx 2 caracteres                                                        |
| checksum       | string | Cadena de comprobación SHA512 (email+country+order+money+amount+FIXED\_HASH)                  |
| user\_di       | string | Número de documento de identificación del pagador. Máx 15 caracteres                          |
| user\_type\_di | string | Tipo documento del comprador. Max 3 caracteres.                                               |
| user\_name     | string | Nombre del comprador. Max 25 caracteres.                                                      |

{% tabs %}
{% tab title="200 La ejecución retorna un JSON estructurado con los siguientes campos: " %}

```
{
   "CODE": "0000",
   "DESC": "OK", 
   "DATA":{
      "OrdenID":"comercioExterno_9892",
      "Monto":"500000",
      "PVordenID":"98555221",
      "Referencia":"8766554",
      "Operacion":"CREADA",
      "checkout":"checkout.payvalida.com/?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJNRVJDSEFOVF9DRUwiOiIzMTc2ODI3MzQxIiwiT1JERVJfTUVUSE9EIjoiZWZlY3R5IiwiTUVSQ0hBTlRfQ09ERSI6MjU0LCJNRVJDSEFOVF9FTUFJTCI6ImhyZXN0cmVwb0BwYXl2YWxpZGEuY29tIiwiaXNzIjoiYXV0aDAiLCJNRVJDSEFOVF9MT0dPIjoiaHR0cHM6Ly9zMy5hbWF6b25hd3MuY29tL3ZhbGlkZGF3ZWIvZXZlbnRvcy9mZW5hbGNvYnJhLnBuZyIsIk1FUkNIQU5UX1VSTF9SRVRVUk4iOiJ3d3cucGludmFsaWRkYS5jb20uY28iLCJNRVJDSEFOVF9OQU1FIjoiSGVybmFuIFJwbyAoQ09MKSIsIk9SREVSX0JSSUVGIjoiVGVzdCBSRVNUZnVsbCBQdXJjaGFzZSBPcmRlciBQT1NUIiwiTUVSQ0hBTlRfVEVMIjoiMjg4MDUzOSIsIk9SREVSX0NVUlJFTkNZIjoiQ09QIiwiT1JERVJfQU1PVVQiOiIxMCwwMDAuMDAiLCJleHAiOjE1MzA0MDE1MzgsIk9SREVSX1JFRkVSRU5DRSI6IjQyMzEzIn0.QVsZwm-2BIkK-5RgrAX2NuwGqmHSNHD_zw91i1hcSc8”
   }
}

```

{% endtab %}
{% endtabs %}


---

# 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:

```
GET https://docs.payvalida.com/api-cashout/registrar/recarga-bolsa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.