Usar enlaces de pago

Un enlace de pago es una oferta reutilizable administrada desde el panel. Comparte una URL estable en un sitio, campaña, mensaje o QR. Crear, editar o previsualizar el enlace no crea una deuda ni cobra a un cliente. Al iniciar el flujo interactivo, Pharos crea o reanuda una Checkout Session con un snapshot de la oferta.

Requisitos

Productos y precios configurados para todos los ítems.
Enlace activo y sin vencer.
Una ruta de pago disponible para el país y moneda previstos.
Acceso para administrar enlaces en la empresa y entorno activos.
Para integraciones, un receptor de Webhooks que verifique el resultado.

Configurar y publicar

Abre Cobros → Enlaces de pago y selecciona Crear enlace de pago, o usa la API.
Elige productos, precios y cantidades. Revisa la composición del carrito y los importes iniciales y recurrentes.
Configura campos, promociones, cupones, cuotas, vencimiento y acción posterior al checkout.
Revisa la vista previa, guarda y activa el enlace.
Copia su URL alojada /checkout/:slug y compartila por el canal elegido.
Prueba una compra en Sandbox y verifica el resultado antes de publicar en producción.

<a href="https://checkout.example.com/checkout/summer-offer">
  Comprar
</a>

Conserva parámetros de campaña si necesitas atribución. Un dominio propio cambia el host público, no la identidad de la oferta.

Cupones y promociones automáticas

En la sección de promociones del editor, selecciona los beneficios automáticos y habilita Permitir cupones para que el comprador ingrese un código. Crear un cupón o promoción no configura el enlace por sí solo. Consulta Cupones, Promociones y Cómo se combinan los descuentos.

Guarda e inicia un intento nuevo en Sandbox para probar beneficios elegibles y no elegibles. La vista previa muestra beneficios configurados; el cálculo final confirma cuáles aplican.

Flujo de compra

El comprador abre la URL y Pharos resuelve el enlace activo.
El checkout inicia el flujo interactivo y crea una sesión con snapshot o reanuda la sesión abierta correspondiente de esa pestaña.
La sesión conserva ítems, precios, recurrencia, campos, beneficios, cuotas y vencimiento para el intento.
El comprador completa contacto y facturación y elige un medio disponible.
Pharos valida la oferta, calcula el importe final y crea los registros correspondientes de cliente, factura, suscripción y pago.
El pago puede completarse inmediatamente, pedir otra acción o quedar en proceso.
El checkout muestra el resultado o instrucciones; tu integración confirma la compra sólo con purchase_succeeded firmado y sin duplicar efectos.

Oferta reutilizable y snapshot

Los cambios de productos, precios, campos, promociones o cuotas afectan sesiones posteriores. Una sesión abierta conserva su snapshot hasta completarse o vencer. Desactivar, vencer o eliminar el enlace impide sesiones nuevas; no reescribe el intento existente. Actualizar la misma pestaña puede reanudar su sesión.

La vista previa no crea una sesión, factura, suscripción ni pago. El mensaje de confirmación y destino de redirección se copian a la sesión; editarlos después no cambia intentos abiertos.

Acción posterior al checkout

Elige CONFIRMATION para mostrar el resumen con el mensaje predeterminado o uno personalizado en texto plano. El mensaje personalizado se muestra como fue escrito y no se traduce según la ubicación del comprador.

Elige REDIRECT para navegar a una URL HTTP(S) después de una finalización no fallida, incluyendo pagos en proceso o sin pago requerido. La URL puede contener {CHECKOUT_SESSION_ID} y Pharos lo reemplaza. Los destinos localhost sólo se admiten en Sandbox.

La redirección no confirma el pago: puede suceder antes del resultado final de un medio asíncrono.

Interpretar el resultado

Señal	Significado
`status=complete`	Terminó el flujo alojado; no demuestra un cobro
`paymentStatus=processing`	Falta resultado final; mantener la compra pendiente
`paymentStatus=paid`	La sesión refleja un pago exitoso; reconciliar con el evento firmado
`paymentStatus=failed`	El intento falló y puede admitir reintento
`paymentStatus=no_payment_required`	Flujo gratuito o de prueba sin cargo; aplicar tu política y contrato de eventos
`purchase_succeeded`	Señal autorizada de compra exitosa, después de verificar firma y deduplicar

Una página de éxito o checkout_session_completed no demuestra que se cobraron fondos.

Problemas frecuentes

No se encuentra el enlace: revisa slug, activación, eliminación y vencimiento.
Falta un precio, moneda o medio: revisa catálogo, carrito y rutas habilitadas.
No aparecen cambios recientes: inicia un intento nuevo; la sesión anterior conserva su snapshot.
Comprador detenido: consulta estado, resultado de pago y vencimiento antes de pedir un reintento.
Tu sistema no entregó la compra: revisa firma, duplicados, entregas y recepción de purchase_succeeded.