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

# Configurar la cuenta de reembolso

> Designa un beneficiario validado como cuenta de reembolso de un comercio. Cuando una orden se revierte, VelaFi envía los fondos a esta cuenta automáticamente.

Cuando una orden de fiat a cripto o de pagos globales se revierte o se reembolsa, VelaFi necesita saber a dónde enviar los fondos. Usa este endpoint para designar cualquier beneficiario validado previamente como la cuenta de reembolso de un comercio determinado. Cada comercio puede tener una sola cuenta de reembolso activa a la vez: si vuelves a llamar a este endpoint con un `userPaymentId` distinto, se reemplaza la designación anterior.

## Endpoint

```
POST https://api.velafi.com/v2/payments/refund_account
```

> [!NOTE]
>
> Usa `https://api-test.velafi.com/v2/payments/refund_account` para pruebas en sandbox.

## Encabezados de la solicitud

| Encabezado | Valor |
| - | - |
| `X-BH-TOKEN` | Tu token de `GET /v2/token/generate` |
| `Content-Type` | `application/json` |

## Parámetros del cuerpo de la solicitud

**userPaymentId** `integer` *required*

El ID numérico único del beneficiario que quieres designar como cuenta de reembolso. El beneficiario debe tener `status: 1` (válido).

**merchantId** `integer` *required*

El ID numérico del comercio para el que se configura la cuenta de reembolso.

## Campos de la respuesta

**code** `integer`

Código de estado de la respuesta. `200` indica éxito.

**msg** `string`

Mensaje de respuesta legible.

**data** `boolean`

`true` si la cuenta de reembolso se designó correctamente.

## Ejemplo

```bash theme={null}
curl -X POST "https://api.velafi.com/v2/payments/refund_account" \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": 456,
    "userPaymentId": 123
  }'
```

```json theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": true
}
```

> [!TIP]
>
> Después de configurar una cuenta de reembolso, el campo `hasRefundAccount` del beneficiario correspondiente devolverá `1` en las respuestas de `GET /v2/payments`.


## Related topics

- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Obtener los detalles de la cuenta](https://docs.velafi.com/es/api-reference/account/get-account-details.md)
- [Activar la cuenta de un comercio](https://docs.velafi.com/es/docs/guides/activating-merchant-account.md)
- [Activar la cuenta de un comercio empresa](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-business.md)
- [Activar la cuenta de un comercio persona física](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-individual.md)


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