# Billete — Payment gateway and orchestrator

> Billete is the payment gateway and orchestrator for digital businesses: mobile payments, QR and instant bank debit, subscriptions, hosted checkout, signed webhooks and a typed SDK.

URL: https://boelabs.com/en/billete
Language: English (en-US) — also in: [Español](https://boelabs.com/billete.md?lang=es) · [Português](https://boelabs.com/billete.md?lang=pt) · [Français](https://boelabs.com/billete.md?lang=fr)

Billete is the payment gateway and orchestrator for digital businesses in Latin America: local methods, subscriptions, hosted checkout and an API designed for developers.

- [Create account](https://billete.run/sign-up)
- [Read the docs](https://billete.run/docs)
- API reference: https://billete.run/docs/api
- SDK: https://www.npmjs.com/package/@boelabs/billete-sdk

## From zero to accepting payments in an afternoon

1. **Create your account**: Set up your business, plans and pricing in the dashboard. You start in the sandbox.
2. **Integrate or share**: Use the SDK to create checkouts from your app, or share a payment link without writing code.
3. **Get paid and reconcile**: Billete confirms every payment, sends signed webhooks and reconciles charges automatically.

## Local payments with a world-class experience

### Local methods

Mobile payments, QR payments and instant bank debit, in local currency or priced in foreign currency at the official rate.

### Orchestration with fallbacks

Per-method routing with a primary provider and fallbacks, maintenance windows and health monitoring.

### Subscriptions

Plans, seats, metered usage, grace periods and plan changes with previews.

### Checkout and payment links

Hosted payment pages and a customer portal, ready to share without building any UI.

### Signed webhooks

Standard Webhooks with automatic retries and redelivery from the dashboard.

### Automatic reconciliation

Reconciled charges, PDF receipts, refunds and disputes, all in one place.

## An API you won't have to second-guess

- Zero-dependency TypeScript SDK: Node, Bun, Deno, edge and React Native
- Idempotency: a retry never charges twice
- Date-based API versioning, so you upgrade on your schedule
- Docs with 20+ recipes and llms.txt for your agents

```ts
import { createBillete } from "@boelabs/billete-sdk";

const billete = createBillete({ apiVersion: "2026-11-09.beta", environment: "test" });

const checkout = await billete.checkouts.create({
  plan: "plan_pro",
  months: 1,
  customer: { email: "ana@example.com", externalId: "user_123" },
  successUrl: "https://yourapp.com/thanks?checkout={CHECKOUT_ID}",
  cancelUrl: "https://yourapp.com/pricing",
});
```

## Built for digital businesses

### SaaS and subscriptions

Plans, seats, free trials and renewals with reminders.

### Online stores

Hosted checkout, coupons, taxes, in-store pickup or shipping.

### Usage credits

Charge for usage with quotas and metered features.

### Events and tickets

Payment links ready to share on any channel.

## Frequently asked questions

### Which payment methods does Billete support?

Mobile payments, QR payments and instant bank debit in local currency. You can set prices in local currency, USD or EUR; foreign-currency prices are converted at the official rate at the time of the charge.

### How much does it cost?

Billete charges a fee per processed transaction, with no monthly fee. Get in touch to learn the rates for your use case.

### Is there a sandbox?

Yes. Every account has a sandbox identical to production, with separate keys, so you can integrate without moving real money.

### Do my customers see the Billete brand?

Payment pages show your business and a discreet “Powered by Billete” line.