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

# Introducción

> Pasarela de pagos para integrar procesamiento transaccional en aplicaciones web y móviles.

Zonapay es la pasarela de pagos de Zonapagos: permite a un comercio crear una transacción por API, redirigir al usuario a un ciclo de pago alojado por Zonapagos y recibir de vuelta el estado final del pago.

Está pensada para comercios que necesitan integración transaccional con control sobre el flujo, soporte multi-medio (PSE, tarjeta de crédito, Bancolombia, Codensa, convenios) y trazabilidad para reconciliación.

## ¿Cuándo usar Zonapay?

<CardGroup cols={2}>
  <Card title="E-commerce" icon="cart-shopping">
    Checkout de pago con múltiples medios en una sola integración.
  </Card>

  <Card title="Servicios digitales" icon="globe">
    Suscripciones, compras únicas, renovaciones.
  </Card>

  <Card title="Recaudo integrado" icon="building-columns">
    Cuando el flujo debe convivir con tu propia lógica de negocio.
  </Card>

  <Card title="Apps móviles" icon="mobile">
    Redirección al ciclo de pago o WebView embebida.
  </Card>
</CardGroup>

Si lo que necesitas es un formulario alojado sin desarrollo, evalúa [Zonaexpress](/docs/zonaexpress/introducción). Si lo que necesitas es un enlace compartible, evalúa [Link de cobro](/docs/link-de-cobro/introducción).

## ¿Cómo funciona en una frase?

Tu backend crea la transacción → rediriges al usuario al ciclo de pago → Zonapagos procesa con la red financiera → tu backend consulta el estado y entrega el producto.

<Steps>
  <Step title="Iniciar pago">
    `POST /InicioPago` con los datos del pago. Recibes una URL.
  </Step>

  <Step title="Redirigir al usuario">
    El usuario completa el pago en el ciclo alojado por Zonapagos.
  </Step>

  <Step title="Recibir callback">
    Al terminar, Zonapagos redirige al usuario de vuelta con `id_comercio` e `id_pago`.
  </Step>

  <Step title="Verificar estado">
    `POST /VerificacionPago` te entrega el estado final antes de que entregues el producto.
  </Step>

  <Step title="Sonda (obligatoria si aceptas PSE)">
    Un job periódico consulta pagos pendientes hasta recibir respuesta definitiva.
  </Step>
</Steps>

<div style={{ textAlign: "center", margin: "24px 0" }}>
  <img
    src="https://mintcdn.com/zonavirtualsa/cu5lbN9wErGA323M/docs/imagenes/Arq_general_core_transaccional.jpg?fit=max&auto=format&n=cu5lbN9wErGA323M&q=85&s=e2a3f3a090f4f25dad8432d8b0f0007e"
    style={{ 
  width: "100%",
  maxWidth: "500px",
  borderRadius: "6px",
  boxShadow: "0 10px 30px rgba(0,0,0,0.15), 0 2px 10px rgba(0,0,0,0.1)"
}}
    width="1117"
    height="1861"
    data-path="docs/imagenes/Arq_general_core_transaccional.jpg"
  />
</div>

## Primeros pasos

<CardGroup cols={2}>
  <Card title="Cómo funciona" icon="circle-info" href="/docs/zonapay/empezar/como-funciona">
    Arquitectura, actores y flujo end-to-end.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/docs/zonapay/empezar/quickstart">
    Tu primer pago en 10 minutos con código listo para copiar.
  </Card>

  <Card title="Ambientes" icon="server" href="/docs/zonapay/empezar/ambientes">
    URLs, credenciales y cómo solicitar acceso.
  </Card>

  <Card title="API Reference" icon="code" href="/docs/zonapay/api/introduccion">
    Endpoints, objetos y tablas de referencia.
  </Card>
</CardGroup>

## Medios de pago soportados

* **PSE** (débito bancario en línea)
* **Tarjeta de crédito** (Visa, Mastercard, American Express, Diners Club)
* **Bancolombia** (botón de pago directo)
* **Codensa** (Crédito Fácil Codensa)
* **Sistecrédito**
* **Mefía** y otros convenios
* **PDF presencial** con referencia

Ver el detalle en [Medios de pago](/docs/empieza-ahora/medios-de-pago).

## Soporte

Si durante tu integración necesitas ayuda, escríbenos a [soporte@zonavirtual.com.co](mailto:soporte@zonavirtual.com.co) o por [WhatsApp](https://api.whatsapp.com/send?phone=+573014302402\&text=Hola,%20quiero%20Soporte%20para%20zonapay).