Berry API · v1

A Berry por trás do seu código.

Uma API REST para consultar transações e relatórios, gerenciar produtos e cupons e gerar cobranças via PIX ou boleto — o suficiente pra automatizar suporte, conciliação e vendas.

Ler a documentação → Como começar
REST + JSON Bearer token PIX & boleto
criar cobrança PIX 
curl -X POST https://api.berrypay.com.br/v1/payment \  -H "Authorization: Bearer bp_live_..." \  -H "Content-Type: application/json" \  -d '{    "product_id": "b1f2c3d4-0000-4000-8000-000000000001",    "offer": "of_9f8e7d6c",    "payment_method": "pix",    "buyer": { "name": "João Silva",              "email": "joao@example.com",              "document": "123.456.789-01" }  }' # 201 Created{ "data": {  "transaction_id": "a1b2c3d4-…-000000000010",  "status": "pending",  "payment_url": "https://checkout.berrypay.com.br/transaction/a1b2…",  "pix": { "qr_code": "00020101021226880014br.gov.bcb.pix…" }} }
O que dá pra fazer

Seis recursos, um token.

GET

Produtos

/v1/products

Seus produtos com imagem, slug de checkout e oferta padrão.

GET

Ofertas

/v1/products/{id}/offers

Variações de preço e cobrança — à vista no PIX, parcelado, assinatura.

GET · POST

Cupons

/v1/products/{id}/coupons

Liste e crie cupons de desconto, percentual ou valor fixo.

GET

Transações

/v1/transactions

Filtre por status, e-mail, produto e período — os mesmos filtros do painel.

POST

Pagamentos

/v1/payment

Gere uma cobrança avulsa via PIX ou boleto, com QR copia-e-cola e link.

GET

Relatórios

/v1/reports/summary

Totais de vendas de hoje, ontem, este mês e mês passado.

Caso de uso · Suporte & operações

Consulte qualquer transação numa chamada.

Um GET resolve "cadê o pagamento do fulano?". Busque por e-mail ou ID e leia status, valor líquido e horário — sem abrir o painel.

  • Atendimento que confere o status na hora
  • Conciliação e dashboards internos
  • Resumo agregado com /v1/reports/summary
consultar transação 
curl "https://api.berrypay.com.br/v1/transactions?query=joao@example.com&status=paid" \  -H "Authorization: Bearer bp_live_..." { "data": [ {  "id": "a1b2c3d4-…-000000000010",  "status": "paid", "payment_method": "pix",  "customer": { "name": "João Silva", "email": "joao@example.com" },  "amounts": { "gross_total": 19700, "net_amount": 18715 },  "paid_at": "2026-08-20T13:01:12.000Z"} ], "pagination": { "total": 1 } }

Autenticação

Bearer token bp_live_… em toda requisição. Cada chave carrega os escopos read e/ou write.

Rate limits

60 requisições por minuto por chave. Headers X-RateLimit-* em toda resposta e Retry-After no 429.

Idempotência

Envie Idempotency-Key nas escritas para reenviar com segurança após um timeout, sem duplicar.

Primeiros passos

Da chave à primeira cobrança.

Crie sua chave de API

Gere uma chave bp_live_… no painel da Berry e guarde como variável de ambiente — ela aparece uma única vez.

Faça a primeira chamada

Um GET /v1/products com o header Authorization já devolve o catálogo da sua conta.

Explore o resto

Gere um PIX, filtre transações, leia relatórios. Referência completa em developers.berrypay.com.br.

/developers/mcp Servidor MCP A API inteira como ferramentas pro seu assistente de IA, num endpoint só. Ver o MCP → /developers/vendas-ia Vendas por IA Um agente que coleta os dados e gera o PIX do cliente dentro do WhatsApp. Ver o fluxo →
E aí, bora?

Comece a integrar a Berry.

Chave de API, primeira chamada e a referência completa dos endpoints — tudo na documentação.

Ler a documentação → Criar conta