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

# Inicio rápido

> Configura tu integración y realiza tu primera transacción con Alignet One.

Una vez completado el proceso comercial (firma de contrato), sigue este flujo para comenzar a aceptar pagos.

## Flujo general

<CardGroup cols={3}>
  <Card title="1. Credenciales" icon="key">Obtén tus accesos para comenzar la integración.</Card>
  <Card title="2. Método de integración" icon="shuffle">Elige cómo integrar pagos según tu canal.</Card>
  <Card title="3. Configuración" icon="code">Configura tu integración y parámetros de pago.</Card>
  <Card title="4. Pruebas (Sandbox)" icon="flask-round-potion">Valida tu integración en ambiente sandbox.</Card>
  <Card title="5. Preproducción" icon="vial-circle-check">Valida el flujo completo con credenciales productivas.</Card>
  <Card title="6. Producción" icon="rocket-launch">Activa pagos en vivo y comienza a operar.</Card>
</CardGroup>

## Flujo de integración

<Steps>
  <Step title="Obtén tus credenciales">
    Obtén tus credenciales de acceso (Client ID, Client Secret y Merchant ID). El equipo de integraciones se contactará contigo para enviarlas de forma segura.

    Con estas credenciales podrás:

    * Autenticar tus solicitudes a la API.
    * Identificar tu comercio en las transacciones.
    * Configurar tu entorno de integración (**SANDBOX y PRODUCCIÓN**).

    **Sandbox** se utiliza para pruebas y validación sin impacto en transacciones reales. **Producción** es el entorno en vivo para procesar transacciones reales.
  </Step>

  <Step title="Elige tu método de integración">
    Selecciona el método que mejor se adapte a tu negocio (Web, Mobile, API, CMS o POS) y define los medios de pago que deseas habilitar.

    Considera el canal de venta, el nivel de personalización requerido y los recursos técnicos disponibles.
  </Step>

  <Step title="Configura tu método de integración">
    Sigue la guía técnica correspondiente e implementa la autenticación, los parámetros de transacción y los componentes necesarios.

    * Configura autenticación (API Key o tokens).
    * Define parámetros como `amount`, `currency` y `merchant_operation_number`.
    * Configura URLs de retorno y notificaciones (webhooks/S2S).
    * Integra componentes frontend o SDK, si aplica.
  </Step>

  <Step title="Realiza pruebas">
    Ejecuta transacciones en sandbox y valida los estados de pago, las respuestas y el manejo de errores.

    <Tip>Valida escenarios aprobados y rechazados, y verifica la recepción correcta de notificaciones (webhooks/S2S).</Tip>

    Para conocer el ciclo de vida y los estados de una transacción, revisa [Estados de transacción](/pagos-virtuales/pagos/estados-de-transaccion).
  </Step>

  <Step title="Valida en preproducción">
    El equipo de integraciones validará tu implementación y, si es conforme, te compartirá las **credenciales de producción**.

    Ejecuta pruebas controladas, valida el flujo de extremo a extremo —incluidas las notificaciones— y confirma que las transacciones se procesen correctamente. Antes de continuar, completa el [Checklist de certificación técnica](/pagos-virtuales/checklist-de-certificacion).
  </Step>

  <Step title="Activa en producción">
    Activa la integración en vivo, procesa transacciones reales y monitorea el comportamiento y los logs del sistema.
  </Step>
</Steps>

Para asegurar una implementación segura y robusta, revisa nuestras [Buenas prácticas generales](/pagos-virtuales/buenas-practicas-generales).

## Ejecuta tu primera transacción

### Integración directa

<CardGroup cols={2}>
  <Card title="SDK Mobile (iOS / Android)" icon="mobile-screen-button" horizontal href="/pagos-virtuales/sdk-mobile/introduccion">Prueba el flujo de pago desde una aplicación móvil.</Card>
  <Card title="Checkout Web (Flex)" icon="globe" horizontal href="/pagos-virtuales/checkout-web/flex/introduccion">Realiza una transacción usando el checkout alojado.</Card>
</CardGroup>

### E-commerce (CMS)

<Card title="Introducción E-commerce" horizontal href="/pagos-virtuales/e-commerce/introduccion">
  Consulta el panorama general de WooCommerce, PrestaShop y VTEX.
</Card>

<CardGroup cols={3}>
  <Card title="WooCommerce" icon="shopping-cart" href="/pagos-virtuales/wordpress-woocommerce/introduccion">Configura el plugin y realiza una compra de prueba.</Card>
  <Card title="PrestaShop" icon="store" href="/pagos-virtuales/prestashop/introduccion">Activa el módulo y ejecuta una transacción de prueba.</Card>
  <Card title="VTEX" icon="shopping-bag" href="/pagos-virtuales/vtex/introduccion">Integra y valida una compra en tu ecommerce.</Card>
</CardGroup>
