Visão geral: integrar Pix cobrança Modobank

Resposta rápida: Para receber Pix via API no Modobank, obtenha credenciais e certificado, autentique com OAuth2+mTLS, crie uma cob, exiba o QR/copia-e-cola, consulte o status e opcionalmente receba webhook de pagamento.

O que você vai construir

Happy path de cobrança imediata (não inclui cobv/lotes/devolução neste pack).

Tempo estimado

1–2 horas na primeira integração em homologação (sem contar abertura de conta).

Mapa da spine

1. Obter credenciais
2. Autenticar
3. Criar cobrança imediata
4. Exibir QR e copia-e-cola
5. Consultar cobrança
6. Webhook de pagamento

O que ter em mãos

• Acesso ao Internet Banking Modobank
• Ambiente de deploy com HTTPS para webhook (recipe 06)
• Stack: curl, Node, Python ou PHP

Código

Sem chamada de API nesta página — só mapa. Snippets começam na recipe 02. Fontes em snippets/.

Se der errado

Sintoma	Causa	Ação
Não acho credenciais	Menu diferente no IB	Contatar suporte Modobank
Não sei a base URL	Host não público neste pack	Usar placeholders + suporte

Checklist

• Li ambientes
• Li placeholders

Próximo passo

→ 01 — Obter credenciais

FAQ

P: Isso substitui o OpenAPI do BACEN?

R: Não. O pack é a jornada; o schema continua no OpenAPI 2.9.

P: Serve para cobv?

R: Não na v1 deste pack.