Saltar al contenido principal
Onflay permite integrar checkout hospedado, pagos en USD y webhooks firmados usando SDKs oficiales y la CLI. Puedes arrancar un proyecto completo sin abrir el dashboard. Con la integración para developers puedes:
  • 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 de plataforma es 6% por venta exitosa + fee del procesador de pago.

​
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. 
pnpm add -D onflay
export ONFLAY_API_KEY=sk_test_...

npx onflay catalog plan pricing.onflay.ts   # previsualiza cambios
npx onflay catalog apply pricing.onflay.ts  # sincroniza con el entorno
npx onflay catalog codegen pricing.onflay.ts --out src/onflay-catalog.ts
Ve a la guía de la CLI para ver el formato completo del archivo de catálogo y todos los comandos disponibles.

​
Opción B — SDK directo

Instala el SDK de Node y crea sesiones de checkout desde tu backend apuntando a IDs ya existentes: 
pnpm add @onflay/node @onflay/webhooks

import { Onflay } from '@onflay/node';

const onflay = new Onflay(process.env.ONFLAY_API_KEY!);

const session = await onflay.checkoutSessions.create({
  lineItems: [{ priceId: 'price_...', quantity: 1 }],
  successUrl: 'https://tu-app.com/gracias',
  cancelUrl: 'https://tu-app.com/precios',
});

// Redirige al comprador
redirect(session.url);

​
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 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

PaqueteUso
@onflay/nodeSDK de servidor — sesiones de checkout, API
@onflay/webhooksVerificación de firma de webhooks
@onflay/reactComponentes de frontend (checkout embebido)
onflayCLI — catálogo declarativo, webhooks locales, eventos
Las suscripciones recurrentes están próximamente. La documentación actual cubre pagos únicos, checkout hospedado, Listings/Variants, Products/Prices, webhooks e idempotencia.