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

# Empezar ahora

> Crea tu cuenta en segundos y prueba OnePay sin complicaciones

## Registro

Para acceder a la plataforma completa el formulario de registro que se encuentra en la siguiente [página de registro](https://www.onepay.la/registro).

<Frame>
  <img src="https://mintcdn.com/onepay-ac89a11a/1thgey7J6Nd-ZB-D/images/onboarding/register.png?fit=max&auto=format&n=1thgey7J6Nd-ZB-D&q=85&s=c0173ef2a3c38a329aadbca8d47fe928" alt="Register" width="2734" height="1628" data-path="images/onboarding/register.png" />
</Frame>

<Note>Si ya completaste el registro. Asegúrate de verificar tu cuenta. Si aún no lo has hecho, dirígete al apartado de verificación.</Note>

## Configura tus llaves

1. Ingresa a **Perfil → Desarrolladores → API Keys**.
2. Genera una llave `Secret` y una `Public` para el ambiente `test`.
3. Guarda las llaves en tu gestor de secretos. Nunca las publiques en repositorios.

## Realiza tu primer cobro

1. Desde el panel crea un cliente de prueba o usa el endpoint [`POST /customers`](/client/customers/create).
2. Registra un método de pago sandbox siguiendo la guía de [tarjetas de prueba](/client/cards/index).
3. Crea un cobro rápido con [`POST /payments`](/client/payments/create) o genera un link desde la consola.
4. Abre el link, aprueba el pago con los datos de prueba y verifica el resultado en el dashboard.

### Flujo del primer cobro

```mermaid theme={null}
sequenceDiagram
    participant Dev as Tu Backend
    participant API as OnePay API
    participant Cliente as Cliente
    participant Checkout as Checkout OnePay

    Dev->>API: POST /customers (crear cliente)
    API-->>Dev: customer_id

    Dev->>API: POST /payments (crear pago)
    API-->>Dev: payment_link

    Dev->>Cliente: Enviar payment_link
    Cliente->>Checkout: Abrir link de pago

    Checkout->>Cliente: Formulario de pago
    Cliente->>Checkout: Ingresar datos y confirmar

    Checkout->>API: Procesar pago
    API-->>Checkout: Pago aprobado

    API->>Dev: Webhook payment.approved
    Checkout-->>Cliente: Confirmación
```

## Activa webhooks

* Dirígete a **Desarrolladores → Webhooks** y registra la URL de tu servidor.
* Copia el secreto generado; lo necesitarás para validar la firma con el header `x-webhook-token`.
* Responde `200 OK` para confirmar la recepción de cada evento.
* Consulta la [guía completa de webhooks](/guides/implementar-webhooks) para ver ejemplos de verificación HMAC-SHA256.

## Checklist para ir a producción

* [ ] Subiste la documentación legal en **Configuración → Información de la compañía**.
* [ ] Probaste los casos de éxito, error e idempotencia en ambiente `test`.
* [ ] Configuraste alertas en tus webhooks y monitoreas `event.id` para evitar duplicados.
* [ ] Activaste los métodos de pago que usarás en vivo.