Migrar de outra provedora de Pix: trocar a URL e as credenciais, sem reescrever tudo
Quem já integrou Pix com outra provedora não precisa recomeçar. A API v2 usa autenticação por token, PUT /cob/{txid} e webhooks por tipo, no desenho que o mercado conhece. Em geral, a troca é de endereço e de credencial.
O que se mantém parecido
Token
POST /oauth/token e Authorization: Bearer.
Cobrança
PUT /cob/{txid} e GET /cob/{txid}, com os estados ATIVA, CONCLUIDA e REMOVIDA_PELO_PSP.
Pix recebidos
GET /pix e GET /pix/{endToEndId}.
Webhooks
Avisos por tipo (receive, transfer, cashout) no formato { type, data }.
Idempotência
x-idempotency-key nos pagamentos.
O que não existe (e dizemos antes)
Algumas rotas que existem em outras provedoras não existem aqui. Chamá-las devolve 501 com not_supported, nunca um 404, para a falha ficar óbvia: TED, Pix por dados bancários, cobrança Pix com vencimento (cobv) e lotes, Pix Automático (recorrência por mandato), criação e remoção de chaves Pix e abertura de contas de terceiros por API. Confira a lista completa na documentação antes de migrar.
Como migrar com segurança
1. Teste no sandbox
Aponte o seu código para a URL base com uma chave de teste e rode o fluxo inteiro, inclusive falhas.
2. Migre uma parte
Comece por uma loja, um produto ou uma parcela do tráfego, e compare a conciliação.
3. Troque as credenciais
Quando estiver estável, crie a chave de Produção e mude o Client ID e o Client Secret.
4. Revise os webhooks
Cadastre a URL de destino e valide a assinatura.
Perguntas frequentes
Preciso reescrever a integração?
Em geral basta trocar a URL base e as credenciais, se a sua integração usa o desenho padrão de API de Pix. Teste no sandbox para confirmar.
Vocês têm Pix Automático?
Não pela API v2. Para cobranças recorrentes existe a cobrança recorrente e carnê Pix da plataforma.
Vocês têm cobrança com vencimento (cobv)?
Não na API v2. Cobranças Pix aqui são dinâmicas, com validade. Para parcelas com vencimento, veja o carnê Pix.
Posso migrar aos poucos?
Sim. Você pode manter as duas provedoras e mover o tráfego em etapas.
Migrar de outra provedora de Pix: trocar a URL e as credenciais, sem reescrever tudo
Quem já integrou Pix com outra provedora não precisa recomeçar. A API v2 usa autenticação por token, PUT /cob/{txid} e webhooks por tipo, no desenho…
Veja também
- Documentação da API PixDocumentação pública da API Pix da Pague Mais: autenticação, cobrança, Pix de saída, webhooks, boletos, idempotência, sandbox e llms.txt para assistentes de IA.
- API Pix para desenvolvedoresGuia rápido da API Pix: crie a chave, gere o token, cobre com PUT /cob, envie Pix com idempotência e receba webhooks assinados. Sandbox para testar.
- Como reduzir a taxa do gatewayPaga taxa cara em gateway? Veja 8 caminhos para reduzir o custo de receber: foco no Pix, negociação, split, tarifas escondidas e quando trocar de provedora.
- Sandbox da API PixAmbiente de teste da API Pix: simule cobranças, pagamentos e falhas com chave de teste separada, sem mover dinheiro real, antes de ir à produção.