- definir tu catálogo de productos o servicios desde un archivo TypeScript versionado;
- crear sesiones de checkout desde tu backend con una línea de código;
- usar API keys separadas para sandbox y producción;
- recibir webhooks firmados para activar acceso o sincronizar tu sistema;
- probar localmente con el túnel de webhooks de la CLI.
Onflay opera en USD. La comisión Onflay estándar es 5% + US$0.20 por venta exitosa; el procesador de pago se descuenta según su costo real.
Dos formas de arrancar
Opción A — CLI-first (recomendada)
Define todo tu catálogo en un archivo TypeScript, aplícalo al entorno y genera los IDs listos para usar. No necesitas el dashboard para configurar productos o precios.Opción B — SDK directo
Instala el SDK de Node y crea sesiones de checkout desde tu backend apuntando a IDs ya existentes:Flujo típico
1
Obtén una API key de sandbox
Usa
sk_test_... para todo lo que sea backend en pruebas.2
Define tu catálogo
Crea
pricing.onflay.ts y aplícalo con la CLI, o usa IDs del dashboard directamente.3
Crea una sesión de checkout
Tu backend genera la sesión con
listingId/variantId (o lineItems si ya trabajas con priceId) y redirige al comprador a session.url.4
Escucha webhooks
Confirma pagos con eventos firmados. No dependas solo de la URL de éxito.
5
Pasa a producción
Cambia a
sk_live_..., aplica el catálogo sobre producción y configura webhooks live.Paquetes disponibles
También puedes usar
lineItems con priceId si ya operas con un catálogo de Products/Prices. Para integraciones nuevas, recomendamos listingId/variantId porque simplifica el checkout y se alinea con el flujo actual de catálogo/codegen.