Inicio rápido
Crea un producto y abre tu primer checkout de prueba.
Instala el SDK
npm install @boelabs/billete-sdkCada versión mayor del SDK habla una versión de la API. Para probar una versión beta, instala @boelabs/billete-sdk@beta.
Configura la clave en tu servidor
Crea una clave de prueba en Desarrolladores → Claves API y guárdala en la variable privada BILLETE_API_KEY. No uses una variable pública del framework.
Prepara un producto
Ejecuta este paso una vez para preparar el catálogo.
import { createBillete } from "@boelabs/billete-sdk";
const billete = createBillete({ apiVersion: "2026-10-24", environment: "test" });
const product = await billete.products.create(
{ name: "Curso de fotografía", currency: "USD", amount: 2500 },
{ idempotencyKey: "catalog-photography-course-v1" },
);Guarda product.id para usarlo al crear compras.
Crea el checkout de una compra
import { createBillete } from "@boelabs/billete-sdk";
const billete = createBillete({ apiVersion: "2026-10-24", environment: "test" });
const checkout = await billete.checkouts.create(
{
items: [{ product: "prod_ejemplo", quantity: 1 }],
customer: { email: "cliente@example.com" },
successUrl: "https://example.com/gracias?checkout={CHECKOUT_ID}",
cancelUrl: "https://example.com/carrito",
},
{ idempotencyKey: "checkout-order-123" },
);Reemplaza prod_ejemplo por el producto creado y la clave por una estable para cada pedido. Redirige a tu cliente a checkout.url.
Confirma desde el servidor
La visita a la página de éxito no prueba el pago. Verifica el webhook antes de entregar la compra.