> ## 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 registros de fondeo

> Lista toda la actividad de la cuenta Pending Fund de un comercio, incluidos depósitos, retiros, compras de cripto, reembolsos y transferencias internas.

Usa este endpoint para obtener el historial completo de actividad de la cuenta Pending Fund (fondos pendientes) de un comercio. Aquí se registra cada abono y cargo, ya sea por una transferencia bancaria entrante, una compra de cripto, un retiro (claim), un reembolso o una transferencia interna entre comercios. Filtra por tipo, estado, rango de fechas o `clientId` para generar reportes de conciliación o investigar transacciones específicas.

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

## Endpoint

`GET https://api.velafi.com/v2/merchant/funding/records`

## Parámetros de consulta

**txId** `integer`

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

**merchantId** `integer`

Filtra por el ID del comercio.

**fiat** `string`

Filtra por código de moneda fiat.

**type** `string`

Filtra por tipo de transacción. Valores aceptados:

* `ALL` — todos los tipos (predeterminado)
* `DEPOSIT` — fondos entrantes agregados a la cuenta
* `WITHDRAW` — fondos reclamados (retirados) de la cuenta
* `BUY_CRYPTO` — fondos usados para comprar criptomoneda
* `REFUND` — reembolso abonado a la cuenta
* `TRANSFER_IN` — fondos recibidos de otro comercio
* `TRANSFER_OUT` — fondos enviados a otro comercio

**status** `integer`

Filtra por estado de la transacción:

* `0` — todos (predeterminado)
* `1` — pendiente
* `2` — completado
* `3` — cancelado
* `4` — reembolsado

**clientId** `string`

Filtra por el identificador de orden que proporcionaste como cliente.

**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 se va a 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, por ejemplo `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 que coinciden con la consulta.

**record** `array`

**campos de cada elemento de record**

**id** `string`

ID único de la transacción de fondeo (txId).

**merchantId** `number`

ID del comercio al que pertenece este registro.

**merchantName** `string`

Nombre visible del comercio.

**fiat** `string`

Moneda fiat de la transacción.

**totalAmount** `number`

Monto fiat total, incluidas las comisiones.

**amount** `number`

Monto fiat neto (sin comisiones).

**fee** `number`

Comisión cobrada por la transacción.

**refundedAmount** `number`

Monto reembolsado, si aplica.

**paymentId** `number`

ID del canal de pago.

**userPaymentId** `number`

ID del método de pago del usuario.

**type** `string`

Tipo de transacción: `DEPOSIT`, `WITHDRAW`, `BUY_CRYPTO`, `REFUND`, `TRANSFER_IN`, `TRANSFER_OUT`.

**status** `number`

Estado: `1` = pendiente, `2` = completado, `3` = cancelado, `4` = reembolsado.

**taxId** `string`

Identificación fiscal de la entidad que deposita.

**webhookInfo** `string`

Cadena JSON con los datos sin procesar del webhook bancario del depósito.

**completedTime** `string`

Marca de tiempo Unix (milisegundos) en que se completó la transacción.

**refundedTime** `string`

Marca de tiempo Unix (milisegundos) en que se emitió el reembolso.

**createTime** `string`

Marca de tiempo Unix (milisegundos) en que se creó el registro.

**updateTime** `string`

Marca de tiempo Unix (milisegundos) de la última actualización del registro.

**failCode** `number`

Código de falla legible por máquina, si aplica.

**failReason** `string`

Descripción legible de la falla, si aplica.

## Ejemplo

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

```json Respuesta theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "currentPage": 1,
    "size": 10,
    "total": 100,
    "record": [
      {
        "id": "1123123123",
        "merchantId": 3,
        "merchantName": "Example Merchant",
        "fiat": "MXN",
        "totalAmount": 22.00,
        "amount": 20.00,
        "fee": 2.00,
        "refundedAmount": 0,
        "paymentId": 63,
        "userPaymentId": 91,
        "type": "DEPOSIT",
        "status": 2,
        "taxId": "20000000001",
        "webhookInfo": "{}",
        "completedTime": "1737452344000",
        "refundedTime": null,
        "createTime": "1737452292000",
        "updateTime": "1737452344000",
        "failCode": "",
        "failReason": ""
      }
    ]
  }
}
```


## Related topics

- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Listar flujos fiat](https://docs.velafi.com/es/api-reference/merchant/get-a-list-merchant-fiat-flow.md)
- [Evento de fondeo](https://docs.velafi.com/es/api-reference/webhooks/funding-records-message-push.md)
- [Listar beneficiarios](https://docs.velafi.com/es/api-reference/beneficiary/get-beneficiary.md)
- [Listar países](https://docs.velafi.com/es/api-reference/basic-configuration/get-list-of-countries.md)


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