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

# Obtener la URL de prueba de vida de Woovi

> Obtén o regenera la URL de prueba de vida de Woovi necesaria para completar la activación de la cuenta BRL Pix - Woovi de comercios de personas físicas.

Usa este endpoint para obtener la URL de prueba de vida de Woovi para un comercio de persona física que está activando una cuenta BRL Pix con el proveedor Woovi. El comercio debe completar la prueba de vida en la URL devuelta antes de que llames a [Activar persona física](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-individual.md) con `trench: "Pix - Woovi"`. Si el comercio no ha completado la prueba y la URL anterior ya expiró, volver a llamar a este endpoint devuelve una URL nueva.

> [!NOTE]
>
> Todas las solicitudes deben incluir el encabezado `X-BH-TOKEN` y `Content-Type: application/json`. Este endpoint aplica solo a comercios de personas físicas cuya verificación KYC esté aprobada (estado del comercio `2`) y cuya cuenta tenga acceso al canal Pix - Woovi. Llámalo **antes** de la solicitud de activación: la activación falla con el código de error `-5059` hasta que se complete la prueba de vida.

## Endpoint

`POST https://api.velafi.com/v2/merchant/woovi/liveness`

## Parámetros de la solicitud

**merchantId** `number` *required*

ID del comercio que requiere la prueba de vida.

**generateNewLiveness** `boolean`

Actualmente se ignora: la API no reenvía este valor, así que siempre se trata como `false`. Para obtener una URL nueva después de que la anterior expire, vuelve a llamar a este endpoint.

## Campos de la respuesta

**code** `number`

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

**msg** `string`

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

**data** `object`

**campos de data**

**livenessId** `string`

Identificador único de esta sesión de prueba de vida.

**livenessUrl** `string`

URL que el comercio debe visitar para completar la prueba de vida. Contiene un JWT de corta duración.

**expiresAt** `string`

Marca de tiempo Unix (segundos) en que expira la URL de prueba de vida.

**status** `string`

Estado actual de la prueba de vida:

* `PENDING`: la prueba de vida aún no se completa; envía al comercio a `livenessUrl`
* `COMPLETED`: la prueba de vida se aprobó; si todavía no activas el canal, ya puedes llamar al endpoint de activación
* `KYC_APPROVED`: el canal Pix - Woovi del comercio ya está activo

**failReason** `string`

Motivo de la falla de la prueba de vida, si aplica.

## Ejemplo

```bash cURL theme={null}
curl -X POST https://api.velafi.com/v2/merchant/woovi/liveness \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": 151209,
    "generateNewLiveness": false
  }'
```

```json Response theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "livenessId": "00000000-0000-0000-0000-000000000007",
    "livenessUrl": "https://app.sandbox.avenia.io/liveness/00000000-0000-0000-0000-000000000000?jwt=...",
    "expiresAt": "1788244424",
    "status": "PENDING",
    "failReason": ""
  }
}
```

> [!WARNING]
>
> La `livenessUrl` contiene un JWT de corta duración y expira en el momento indicado en `expiresAt`. Si la URL expira antes de que el comercio complete la prueba, vuelve a llamar a este endpoint para recibir una URL nueva.


## Related topics

- [Activar la cuenta de un comercio](https://docs.velafi.com/es/docs/guides/activating-merchant-account.md)
- [Activar la cuenta de un comercio persona física](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-individual.md)
- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Obtener la cuota de retiro](https://docs.velafi.com/es/api-reference/crypto-wallet/get-withdrawal-quota.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.