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

# Reclamar fondos Pending Fund

> Retira el saldo disponible de la cuenta Pending Fund (fondos pendientes) de un comercio a un método de pago registrado y recibe un ID de transacción rastreable.

Usa este endpoint para iniciar un retiro desde la cuenta Pending Fund (fondos pendientes) de un comercio. Especifica el comercio, la moneda fiat, el monto y el ID del método de pago de destino (que puedes obtener de `GET /v2/payments`). VelaFi devuelve un `txId` que puedes usar para dar seguimiento al retiro mediante el endpoint de [registros de fondeo](https://docs.velafi.com/es/api-reference/merchant/retrieve-funding-records.md). Puede aplicarse una comisión según el canal de retiro.

> [!NOTE]
>
> Todas las solicitudes deben incluir el encabezado `X-BH-TOKEN` y `Content-Type: application/json`. Las monedas admitidas actualmente son MXN y ARS.

## Endpoint

`POST https://api.velafi.com/v2/merchant/claimfunds`

## Parámetros de la solicitud

**merchantId** `number` *required*

El ID del comercio que realiza el retiro.

**fiat** `string` *required*

Moneda fiat que se retira. Admitidas actualmente: `MXN`, `ARS`.

**amount** `number` *required*

Monto a retirar en la moneda fiat especificada.

**userPaymentId** `number` *required*

ID del método de pago registrado del usuario que recibirá los fondos. Obtenlo con `GET /v2/payments`.

**clientId** `string`

Tu propio identificador único para este retiro, usado para idempotencia y seguimiento.

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

**txId** `number`

ID único de esta transacción de retiro.

**merchantId** `number`

ID del comercio que inició el retiro.

**clientId** `string`

El identificador que proporcionaste para esta transacción.

**fiat** `string`

Moneda fiat del retiro.

**totalAmount** `number`

Monto total descontado del saldo de Pending Fund (monto + comisión).

**amount** `number`

Monto neto entregado al método de pago.

**fee** `number`

Comisión cobrada por este retiro.

**userPaymentId** `number`

ID del método de pago que recibe los fondos.

**createTime** `string`

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

## Ejemplo

```bash cURL theme={null}
curl -X POST https://api.velafi.com/v2/merchant/claimfunds \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": 3,
    "clientId": "withdraw-2024-001",
    "fiat": "MXN",
    "amount": 20.00,
    "userPaymentId": 91
  }'
```

```json Response theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "txId": 1123123123,
    "merchantId": 3,
    "clientId": "withdraw-2024-001",
    "fiat": "MXN",
    "totalAmount": 22.00,
    "amount": 20.00,
    "fee": 2.00,
    "userPaymentId": 91,
    "createTime": "1737452292000"
  }
}
```

> [!TIP]
>
> Proporciona siempre un `clientId` único en cada solicitud de retiro. Si se detecta un `clientId` duplicado, la API devuelve la transacción original en lugar de crear una nueva.


## Related topics

- [Transferir fondos Pending Fund](https://docs.velafi.com/es/api-reference/merchant/transfer-pending-funds.md)
- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Obtener la cuenta Pending Fund](https://docs.velafi.com/es/api-reference/merchant/get-pending-fund-account.md)
- [On-ramp (fiat a cripto)](https://docs.velafi.com/es/docs/guides/on-ramp.md)
- [Obtener la comisión de transferencia](https://docs.velafi.com/es/api-reference/merchant/get-transfer-pending-funds-fee.md)


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