Skip to main content
Bem-vindo à documentação do Bob Payments! Aqui você encontra tudo para integrar nossa API de pagamentos PIX. O Bob foi construído por desenvolvedores que queriam uma solução simples para orquestrar múltiplos gateways — sem perder venda por indisponibilidade e sem reescrever integração toda vez que precisar trocar de provedor.

​
O que é o Bob Payments?

O Bob nasceu da frustração de depender de um único gateway de pagamento. Quando ele cai, você perde venda. Quando muda de provedor, reescreve a integração do zero. Quando quer testar outro gateway, é mais uma integração para manter. Os problemas que a gente viu se repetir:
  • Cada gateway tem sua própria API, seu próprio contrato de erros e seu processo de homologação
  • Indisponibilidade de gateway sem nenhum fallback automático
  • Cobranças duplicadas por cliques duplos e retentativas de rede
  • Fraudes detectadas tarde, já nos gateways
  • Migração de provedor como um projeto de meses
Nossa resposta foi construir uma camada de orquestração: você integra o Bob uma vez e a gente cuida de múltiplos gateways por baixo — com failover automático, distribuição de tráfego e proteção contra fraude embutidos.

​
API descomplicada

Nossa API foi construída com três princípios: Ambiente pelo token Não existe parâmetro mode=sandbox. Sua chave define o ambiente automaticamente — troque a chave, troque o ambiente. 
sk_test_...  →  sandbox
sk_live_...  →  produção
Consistente Toda resposta tem o mesmo formato: success e data. Você trata o retorno uma vez e funciona em qualquer endpoint. Idempotente Cliques duplos e retentativas não geram cobranças duplicadas. Se já existe uma transação pendente com os mesmos dados, ela é retornada — nunca criada duas vezes. Veja como é simples criar uma cobrança: 
const response = await fetch('https://api.bobpayments.com/api/transactions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_test_sua-chave-aqui',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    customer: {
      name: 'João Silva',
      document: '12345678900',
      documentType: 'CPF',
      email: '[email protected]',
      phone: '11999999999',
      address: {
        street: 'Rua Exemplo', streetNumber: '123',
        neighborhood: 'Centro', zipCode: '01310100',
        city: 'São Paulo', state: 'SP', country: 'BR',
      },
    },
    payment: { amountCents: 10000, product: 'Plano Premium' },
  }),
});

const { data } = await response.json();
// data.pixCode → código PIX copia-e-cola
// data.status  → "waiting_payment"

{
  "success": true,
  "data": {
    "id": "clx7a8b9c0d1e2f3g4h5",
    "pixCode": "00020126580014br.gov.bcb.pix...",
    "status": "waiting_payment",
    "amountCents": 10000,
    "isSandbox": true
  }
}

​
Por onde continuar

Autenticação

Obtenha suas chaves de API e faça sua primeira requisição autenticada.

Sandbox e Produção

Entenda os dois ambientes e como alternar entre eles.

Criar cobrança PIX

Referência completa do endpoint de criação de transações.

Webhooks

Receba notificações em tempo real quando pagamentos forem confirmados.

Precisa de ajuda?

Nossa equipe está disponível para auxiliar no processo de desenvolvimento. Entre em contato pelo e-mail [email protected].