# Movimientos en bolsa

## Consultar movimientos de bolsa

<mark style="color:blue;">`GET`</mark> `https://api.payvalida.com/cashout/v1/walletmovements/{merchant}`

`URL Sandbox: https://api-test.payvalida.com/cashout/v1/walletmovements`**`/{merchant}`**\
\
Permite obtener los movimientos de la bolsa de cashout en un rango de fecha

#### Path Parameters

| Name     | Type   | Description                                       |
| -------- | ------ | ------------------------------------------------- |
| merchant | string | Comercio que realiza la operación (30 caracteres) |

#### Query Parameters

| Name     | Type   | Description                                                                        |
| -------- | ------ | ---------------------------------------------------------------------------------- |
| checksum | string | Cadena de comprobación SHA512(merchant+start+end+fixed\_hashed) (512 caracteres)   |
| limit    | string | Cantidad de registros de respuesta (default 23; 10 <= limit <= 100) (4 caracteres) |
| page     | string | Número de la página (default > 0) (4 caracteres)                                   |
| type     | string | Tipo de concepto (estado del movimiento) (30 caracteres)                           |
| start    | string | Fecha inicial de búsqueda (formato AAAA-MM-DD) (8 caracteres)                      |
| end      | string | Fecha final de búsqueda (formato AAAA-MM-DD) (8 caracteres)                        |

{% tabs %}
{% tab title="200 Cake successfully retrieved." %}

```
{
	"code": "0000",
	"text": "OK",
	"data": [
    	{
	        “operation”:  921000000073
        	"observation": "DEBITO DE LA COMISION 921000000073",
        	"amoun": 12495,
        	"type": "Débito",
        	"date": "2019-12-02T15:04:02.586392Z",
        	"currency": "COP",
        	"user": "slopez@payvalida.com"
    	}, …
   ]
}

```

{% endtab %}
{% endtabs %}

**Tipos de conceptos disponibles:**

* "DEVOLUCION"
* &#x20;"TRANSFERENCIA"
* &#x20;"ANULACION"
* &#x20;"NINGUNO"
* &#x20;"RECARGA"
* &#x20;"COMPRA"
* &#x20;"PROVISION"
* &#x20;"IVA"
* &#x20;"RECARGA/PAGO SERVICIO"
* &#x20;"COMISION"
* &#x20;"OPERACION CASHOUT"

**Detalle del response:**

* **code:** Indica el código de respuesta. Si el código es “0000” indica un resultado sin error, si el código es diferente, el sistema indica el error en el campo text.
* * Los códigos de la respuesta, pueden ser:&#x20;
    * “0000”: OK
    * “0001”: No se encontraron registros al consultar una transacción
    * “0009”: Request con un checksum inválido
    * “0019”: Mensaje cuando un campo es requerido y no se envía en el request
    * “0026”: El limit tiene condiciones en la documentación como máximo y mínimo
    * “0028”: El campo page debe ser mayor a 0
    * “0036”: Cuando se envía una fecha con un formato inválido
    * “0037”: Rango de fechas inválido
    * “0038”: El tipo de concepto no existe
* **text:** Contiene el mensaje relacionado al code enviado.
* **data:** Contiene los datos de la operación cuando el code nos indica que no hay ningún error.
  * **operation:** Código alfanumérico de la operación asociada al movimiento de la bolsa (longitud máxima de 50)
  * **amount:** Número decimal que representa la cantidad debitada (retirada) o acreditada (recargada) de la bolsa. Se diferencia credito o debito por el campo observation
  * **type:** Cadena de texto que representa el tipo de movimiento, si es debito o credito (longitud máxima de 10)
  * **date:** Fecha de creación del registro incluyendo milisegundos.
  * **currency:** Cadena de texto que representa la moneda en la que está registrada el movimiento de bolsa (longitud máxima de 3)
  * **observation:** Cadena de texto que describe la acción realizada en la bolsa que incluye el código de operación  (longitud máxima de 50)
  * **user:** Cadena de texto que muestra el correo electrónico de la cuenta quien realiza la operación en bolsa y a quien se le notifica (longitud máxima de 30)