> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vitawallet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeros pasos

> Crea tu cuenta de prueba, genera credenciales y realiza tu primera transacción.

## 1. Crear una cuenta de prueba

**1. Acceso inicial**

Ingresa al ambiente de pruebas de Vita Wallet en [stage.vitawallet.io](https://stage.vitawallet.io/) y registra una cuenta **BUSINESS** con tu email corporativo y una contraseña segura (mayúsculas, minúsculas, números y un símbolo).

**2. Verificación de email**

Recibirás un email con un PIN de 6 dígitos. Ingrésalo en la página de registro para validar tu dirección.

**3. Verificación de cuenta**

Completa el formulario de verificación con los datos requeridos (no necesitan ser reales en el ambiente de pruebas). Luego contacta a tu representante de soporte para habilitar la configuración de API.

> [!NOTE]
>
> En producción los datos de verificación deben ser reales y validados por el equipo de compliance.

## 2. Generar credenciales de API

Una vez habilitada tu cuenta, administra tus credenciales desde la sección **Integraciones** en el menú principal.

| Credencial | Descripción |
| - | - |
| **API Key** | Autentica las peticiones a la API. |
| **Secret Key** | Genera la firma HMAC de cada petición. |
| **IPs permitidas** | Lista de direcciones IP desde las que se aceptan conexiones. |

### Tipos de credenciales

> [tab] Sandbox
>
> * Permiten simular transacciones sin afectar cuentas reales.
> * Úsalas para pruebas de integración en un entorno seguro.

> [tab] Producción
>
> * Necesarias para procesar pagos reales.
> * Solo se emiten después de certificar la integración en Sandbox.

### Flujo para obtenerlas

1. Entra a la sección **Integraciones** desde tu cuenta Vita Wallet.
2. Haz clic en el botón para enviar tus credenciales al email registrado.
3. Desde el email recibido, administra tus credenciales.

> [!WARNING]
>
> Completar exitosamente todas las pruebas en Sandbox es un paso obligatorio antes de generar credenciales de producción.

## 3. Realizar pagos de prueba

Conecta las funciones necesarias en tu sistema usando los endpoints documentados:

* Crea y consulta Payment Orders (payins) o Withdrawals (payouts).
* Configura un endpoint para recibir **webhooks** con cambios de estado.
* Maneja los errores estándar documentados.

### Certificación

Para finalizar la integración, agenda una reunión con el equipo técnico de Vita. Antes de solicitarla debes completar **al menos 10 pruebas por cada endpoint** que vayas a usar en producción.


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