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

# Eliminar un beneficiario

> Elimina de forma permanente un beneficiario registrado mediante su ID de método de pago del usuario. Los beneficiarios eliminados no se pueden usar en futuras órdenes de off-ramp ni de pagos globales.

Elimina un beneficiario específico cuando ya no lo necesites o cuando cambien los datos de la cuenta asociada. Identificas el registro con el `userPaymentId` que se devolvió al crear el beneficiario o que obtienes con `GET /v2/payments`. Los registros eliminados no se pueden recuperar: si necesitas volver a usar la misma cuenta, agrégala como un beneficiario nuevo.

## Endpoint

```text theme={null}
DELETE https://api.velafi.com/v2/payments/{userPaymentId}
```

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

## Parámetros de ruta

**userPaymentId** `integer` *required*

ID numérico único del beneficiario que quieres eliminar. Obtenlo del campo `id` en una respuesta de `GET /v2/payments`.

## 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 el beneficiario se eliminó correctamente.

## Ejemplo

```bash theme={null}
curl -X DELETE "https://api.velafi.com/v2/payments/228" \
  -H "X-BH-TOKEN: YOUR_TOKEN"
```

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

> [!WARNING]
>
> Antes de eliminarlo, verifica que el `userPaymentId` no esté referenciado en ninguna orden activa o pendiente. Eliminar un beneficiario que está en uso puede causar problemas en el procesamiento de órdenes.


## Related topics

- [Administrar beneficiarios](https://docs.velafi.com/es/docs/guides/managing-beneficiaries.md)
- [Eliminar un webhook](https://docs.velafi.com/es/api-reference/webhooks/delete-a-webhook.md)
- [Agregar un beneficiario](https://docs.velafi.com/es/api-reference/beneficiary/add-beneficiary.md)
- [Eliminar una dirección de la lista blanca](https://docs.velafi.com/es/api-reference/crypto-wallet/delete-whitelist-address.md)
- [Listar beneficiarios](https://docs.velafi.com/es/api-reference/beneficiary/get-beneficiary.md)


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