Documentación de POV
POV es un sistema de reservas de asientos embebible para cine, teatro y espectáculos: un selector 2D y una sala en 3D que se meten dentro de tu web. En dos líneas de HTML tenés el selector funcionando; el resto de este manual es lo que hace falta para cerrar una venta y para operarlo.
¿Qué querés hacer?
| Quiero… | Empezá por |
|---|---|
| Agregar POV a mi web y vender entradas | Quickstart |
| Ya tengo mi sistema de reservas y sólo quiero la sala en 3D | Modo visor |
| Mi cartelera ya vive en mi CMS | Programación externa |
| Cobrar con mi propia pasarela | Bloqueo → cobro → confirmación |
| Que POV cobre por mí | Pasarela POV (Stripe) |
| Usar mi propio lector de entradas en la puerta | Check-in |
| Que la sala 3D sea la pantalla de compra | Comprar desde el 3D |
| Cuadrar los pagos de un día contra mis ventas | Reconciliación |
| Copiar un proyecto que ya funcione | Ejemplos |
El manual
- EmpezarQué es POV, el modelo mental, y tu primera venta de punta a punta.
- WidgetEl embed, sus atributos, los eventos que emite y los métodos que le podés llamar.
- APILos trece endpoints, con sus respuestas, sus errores y sus límites de uso.
- WebhooksLos cuatro eventos, cómo verificar la firma y cómo rotar el secreto sin cortar nada.
- GuíasRecetas completas: cobrar con Mercado Pago o con tu Stripe, tu cartelera, tu scanner, reconciliación.
- EjemplosProyectos completos para clonar y correr: HTML, Node, PHP, Python, Next.js, Mercado Pago y Stripe.
- AdministraciónEl panel: salas, programación, precios, reservas, equipo, facturación y pasarela.
Lo mínimo
Si sólo querés ver el selector andando en tu página, es esto:
<div data-pov data-showtime="shw_123" data-key="pk_test_xxxxxxxx"></div>
<script src="https://pov.uy/v1/embed.js" async></script>Para cerrar la venta faltan tres pasos más —escuchar el bloqueo, cobrar y confirmar desde tu servidor—, y están todos en Tu primera venta. Si preferís partir de algo que ya anda, hay proyectos completos para clonar en Node, PHP, Python y Next.js, y para cobrar con Mercado Pago o con tu cuenta de Stripe.
¿Preferís todo junto? Está la guía completa en una sola página, para buscar con Ctrl+F o imprimir.