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

# Referencia

> Punto de entrada para estados de transacción, datos de prueba y códigos de retorno de PayIn.

Esta página concentra la información base que conviene tener a mano durante la integración de PayIn. Los catálogos detallados de pruebas y códigos viven en sus páginas dedicadas para evitar duplicidad y mantener esta referencia simple.

***

## Accesos rápidos

<CardGroup cols={2}>
  <Card title="Estados de Transacción" icon="arrow-progress" href="/pagos/estados-de-transaccion">
    Revisa el ciclo de vida del pago y los estados que debes mapear en tu backend.
  </Card>

  <Card title="Datos de Prueba" icon="credit-card-front" href="/pagos/datos-de-prueba">
    Usa tarjetas, credenciales y escenarios sandbox para validar tus flujos.
  </Card>

  <Card title="Códigos de Retorno" icon="receipt" href="/pagos/codigos-de-retorno">
    Consulta los códigos de aprobación, rechazo y reintento por marca o procesador.
  </Card>

  <Card title="API de Consulta" icon="magnifying-glass" href="/payin/consulta">
    Complementa tu integración con una segunda validación backend cuando la necesites.
  </Card>
</CardGroup>

***

## Lo esencial

<CardGroup cols={2}>
  <Card title="Montos en centavos" icon="banknote">
    Envía y procesa montos en la unidad mínima de la moneda. Ejemplo: `15000` representa `150.00`.
  </Card>

  <Card title="Confirmación final" icon="shield-check">
    No tomes el frontend como única fuente de verdad. Confirma el resultado final con [Notificaciones](/payin/notificaciones) o [Consulta](/payin/consulta).
  </Card>

  <Card title="Aprobación" icon="circle-check">
    Considera aprobado el flujo cuando el resultado funcional y el código de retorno coincidan con la respuesta esperada del método o procesador.
  </Card>

  <Card title="Trazabilidad" icon="key">
    Conserva `merchant_operation_number` y `transaction_id` para consulta, conciliación, cancelación y soporte.
  </Card>
</CardGroup>

***

## Lectura rápida de estados

| Estado                    | Qué significa en integración                                                                  |
| :------------------------ | :-------------------------------------------------------------------------------------------- |
| `PENDIENTE`               | La transacción aún no terminó y puede requerir espera, redirección o acción del usuario.      |
| `AUTORIZADO`              | El pago fue aprobado y ya puedes continuar tu flujo de negocio según tu modelo operativo.     |
| `DENEGADO` / `INVALIDO`   | El pago no fue aprobado y debes manejar el mensaje mostrado al usuario y el registro interno. |
| `CANCELADO` / `EXPIRADO`  | La operación terminó sin pago exitoso.                                                        |
| `EXTORNADO` / `LIQUIDADO` | Corresponden a etapas posteriores del ciclo de vida y conciliación.                           |

<Note>
  Si necesitas el detalle completo de cada estado, usa la página dedicada de [Estados de Transacción](/pagos/estados-de-transaccion).
</Note>

***

## Cómo usar esta sección

<Steps>
  <Step title="Prueba en sandbox">
    Usa [Datos de Prueba](/pagos/datos-de-prueba) para validar aprobaciones, rechazos y flujos por método de pago.
  </Step>

  <Step title="Mapea respuestas">
    Usa [Códigos de Retorno](/pagos/codigos-de-retorno) para definir qué considera tu sistema como aprobado, rechazado o reintento.
  </Step>

  <Step title="Confirma desde backend">
    Cierra tu lógica operativa con [Notificaciones](/payin/notificaciones) o [API de Consulta](/payin/consulta), especialmente en métodos asíncronos.
  </Step>
</Steps>

***

## Siguiente paso

<CardGroup cols={2}>
  <Card title="API de Autorización" icon="arrow-right" href="/payin/autorizacion">
    Vuelve al punto de entrada de creación de cargos y selección del método de pago.
  </Card>

  <Card title="API de Notificaciones S2S" icon="bell" href="/payin/notificaciones">
    Implementa la confirmación backend del resultado final de autorización.
  </Card>
</CardGroup>