> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar flujos fiat

> Obtén una vista de libro mayor de partida doble de todos los movimientos del saldo fiat de un comercio, incluidas las líneas de operación, los asientos de comisión y los eventos de reversión.

Usa este endpoint para obtener un libro mayor detallado de los cambios en el saldo fiat de la cuenta de un comercio. A diferencia de los registros de fondeo (que muestran transacciones agregadas), los registros de flujo fiat muestran las líneas individuales de partida doble, incluidos los asientos de comisión por separado, los eventos de reversión y los movimientos de transferencia. Es el endpoint recomendado para construir conciliaciones de saldo en tiempo real y exportaciones contables.

> [!NOTE]
>
> Todas las solicitudes deben incluir el encabezado `X-BH-TOKEN` con un token de negocio obtenido de `GET /v2/token/generate`.

## Endpoint

`GET https://api.velafi.com/v2/merchant/fiat/flows`

## Parámetros de consulta

**merchantId** `integer`

Filtra por el ID del comercio.

**fiat** `string`

Filtra por código de moneda fiat.

**txId** `integer`

Filtra por un ID de transacción de fondeo específico.

**flowType** `string`

Filtra por tipo de flujo. Valores aceptados:

* `ALL`: todos los tipos (predeterminado)
* `DEPOSIT`: depósito entrante
* `WITHDRAW`: retiro saliente
* `WITHDRAW_ROLLBACK`: reversión de un retiro
* `BUY_CRYPTO`: cargo por compra de cripto
* `BUY_CRYPTO_ROLLBACK`: reversión de una compra de cripto
* `REFUND`: abono por reembolso
* `REFUND_ROLLBACK`: reversión de un reembolso
* `TRANSFER_IN`: abono por transferencia interna
* `TRANSFER_OUT`: cargo por transferencia interna

**startTime** `integer`

Inicio del rango de fechas como marca de tiempo Unix en milisegundos.

**endTime** `integer`

Fin del rango de fechas como marca de tiempo Unix en milisegundos.

**currentPage** `integer`

Número de página que quieres obtener (empieza en 1). El valor predeterminado es `1`.

**pageSize** `integer`

Número de registros por página. El valor predeterminado es `10` y el máximo es `1000`.

## Campos de la respuesta

**code** `number`

Código de respuesta de estilo HTTP. `200` indica éxito.

**msg** `string`

Mensaje de estado legible, p. ej. `SUCCESS`.

**data** `object`

**campos de data**

**currentPage** `number`

Número de la página devuelta.

**size** `number`

Número de registros en esta página.

**total** `number`

Número total de registros de flujo que coinciden con la consulta.

**record** `array`

**campos de cada elemento de record**

**id** `number`

ID único de esta línea de flujo fiat.

**merchantId** `number`

ID del comercio al que pertenece esta línea de flujo.

**settingsId** `number`

ID de la cuenta del comercio (configuración del canal de pago).

**txId** `string`

ID de la transacción de fondeo principal.

**category** `string`

Categoría general: `TRADE`, `FEE` o `TRANSFER`.

**flowType** `string`

Tipo de flujo específico (consulta los valores del parámetro de consulta arriba).

**fiat** `string`

Moneda fiat de esta línea de flujo.

**changed** `number`

Monto en que cambió el saldo. Positivo = abono, negativo = cargo.

**total** `number`

Saldo acumulado después de aplicar esta línea de flujo.

**extId** `string`

ID de referencia externa que vincula con la orden o el registro relacionado.

**createTime** `string`

Marca de tiempo Unix (milisegundos) en que se creó la línea de flujo.

## Ejemplo

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/merchant/fiat/flows \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "merchantId=3" \
  --data-urlencode "fiat=MXN" \
  --data-urlencode "flowType=DEPOSIT" \
  --data-urlencode "pageSize=10"
```

```json Response theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "currentPage": 1,
    "size": 10,
    "total": 100,
    "record": [
      {
        "id": 282,
        "merchantId": 3,
        "settingsId": 3,
        "txId": "573901321954934784",
        "category": "TRADE",
        "flowType": "DEPOSIT",
        "fiat": "MXN",
        "changed": 105.61,
        "total": 37042.07,
        "extId": "573901321434841088",
        "createTime": "1737452292000"
      }
    ]
  }
}
```

> [!NOTE]
>
> Por lo general, cada operación genera al menos dos líneas de flujo: una línea `TRADE` para el monto principal y una línea `FEE` para la comisión. Filtra por `category` para separarlas en tu proceso contable.


## Related topics

- [Listar pares cripto→fiat](https://docs.velafi.com/es/api-reference/basic-configuration/get-crypto-fiat-pairs.md)
- [Listar pares fiat→cripto](https://docs.velafi.com/es/api-reference/basic-configuration/get-fiat-crypto-pairs.md)
- [Listar pares fiat→fiat](https://docs.velafi.com/es/api-reference/basic-configuration/get-fiat-fiat-pairs.md)
- [Listar monedas fiat](https://docs.velafi.com/es/api-reference/basic-configuration/get-list-of-fiat-currencies.md)
- [Listar métodos de pago fiat→fiat](https://docs.velafi.com/es/api-reference/basic-configuration/get-fiat-fiat-payment-methods.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.