# Billete — Gateway e orquestrador de pagamentos

> O Billete é o gateway e orquestrador de pagamentos para negócios digitais: pagamentos móveis, QR e débito bancário imediato, assinaturas, checkout hospedado, webhooks assinados e um SDK tipado.

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

O Billete é o gateway e orquestrador de pagamentos para negócios digitais na América Latina: métodos locais, assinaturas, checkout hospedado e uma API pensada para desenvolvedores.

- [Criar conta](https://billete.run/sign-up)
- [Ler a documentação](https://billete.run/docs)
- API reference: https://billete.run/docs/api
- SDK: https://www.npmjs.com/package/@boelabs/billete-sdk

## Do zero às primeiras vendas em uma tarde

1. **Crie sua conta**: Configure seu negócio, seus planos e seus preços no dashboard. Você começa no ambiente de testes.
2. **Integre ou compartilhe**: Use o SDK para criar checkouts no seu app ou compartilhe um link de pagamento sem escrever código.
3. **Receba e concilie**: O Billete confirma cada pagamento, envia webhooks assinados e concilia as cobranças automaticamente.

## Pagamentos locais com uma experiência de primeira linha

### Métodos locais

Pagamentos móveis, pagamentos com QR e débito bancário imediato, em moeda local ou com preços em moeda estrangeira à taxa oficial.

### Orquestração com fallback

Roteamento por método com provedor principal e alternativos, janelas de manutenção e monitoramento de saúde.

### Assinaturas

Planos, licenças por usuário, cobrança por uso, períodos de carência e mudanças de plano com pré-visualização.

### Checkout e links de pagamento

Páginas de pagamento hospedadas e um portal para seus clientes, prontos para compartilhar sem construir UI.

### Webhooks assinados

Standard Webhooks com novas tentativas automáticas e reenvio pelo dashboard.

### Conciliação automática

Cobranças conciliadas, recibos em PDF, reembolsos e disputas em um só lugar.

## Uma API que não faz você pensar duas vezes

- SDK em TypeScript sem dependências: Node, Bun, Deno, edge e React Native
- Idempotência: uma nova tentativa nunca cobra duas vezes
- API versionada por data para você atualizar no seu ritmo
- Documentação com mais de 20 receitas e llms.txt para seus agentes

```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",
});
```

## Feito para negócios digitais

### SaaS e assinaturas

Planos, licenças, teste grátis e renovações com lembretes.

### Lojas online

Checkout hospedado, cupons, impostos, retirada na loja ou entrega.

### Créditos de uso

Cobre por consumo com cotas e features medidas.

### Eventos e ingressos

Links de pagamento prontos para compartilhar em qualquer canal.

## Perguntas frequentes

### Quais formas de pagamento o Billete aceita?

Pagamentos móveis, pagamentos com QR e débito bancário imediato em moeda local. Você pode definir preços em moeda local, USD ou EUR; os preços em moeda estrangeira são convertidos à taxa oficial do momento da cobrança.

### Quanto custa?

O Billete cobra uma taxa por transação processada, sem mensalidade. Fale com a gente para conhecer as tarifas para o seu caso.

### Existe um ambiente de testes?

Sim. Cada conta tem um ambiente de testes idêntico à produção, com chaves separadas, para integrar sem movimentar dinheiro real.

### Meus clientes veem a marca do Billete?

As páginas de pagamento mostram o seu negócio e uma linha discreta de “Com tecnologia Billete”.