Skip to main content
Assistentes de programação como Claude Code, Codex, Gemini CLI, Cursor e GitHub Copilot fazem boa parte de uma integração quando recebem o contexto certo. Esta página reúne o que eles precisam: prompts prontos por tipo de integração e atalhos para entregar a documentação inteira ao assistente.
O assistente escreve o código, mas a responsabilidade pela integração continua sendo do seu time. Revise o que ele produzir, rode os testes com a chave de teste e siga o roteiro de homologação antes de ir para produção.

Prompts prontos

Clique em Copy prompt e cole no assistente que você usa, dentro do projeto que vai receber a integração. No Cursor, o botão Open in Cursor abre o prompt direto no editor. Cada prompt aponta para as páginas certas da documentação e já traz as regras que mais causam erro: autenticação, valores em reais, ausência de idempotência na criação de cobranças e tratamento de webhooks.

Primeira cobrança Pix

Cobrança Pix com QR Code, confirmação por webhook e tratamento de erros.

Open in Cursor

Cartão de crédito com 3D Secure

Cartão parcelado, 3D Secure gerenciado e cartão salvo para recompra.

Open in Cursor

Receptor de webhooks

Endpoint que recebe, valida e processa os eventos da Finvia sem duplicar efeitos.

Open in Cursor

Assinaturas

Planos, assinatura com trial, renovação automática, falhas e cancelamento.

Open in Cursor

Subcontas, split e saques

Marketplace ou plataforma com subcontas, divisão de pagamentos e saques por Pix.

Open in Cursor

Estorno, disputas e saldo

Estorno total ou parcial, bloqueio cautelar, chargeback, MED e consulta de saldo.

Open in Cursor

Revisar uma integração e preparar a homologação

Auditoria do código atual contra a documentação e o roteiro de homologação.

Open in Cursor

Atalhos em todas as páginas

No topo de cada página da documentação há um menu com atalhos para assistentes de IA: Para levar uma página específica ao assistente, como a de criar uma cobrança, use Copiar página e escreva o pedido logo abaixo do texto colado.

Documentação inteira para o assistente

Dois endereços entregam a documentação em formato próprio para IA: Com o índice, o assistente encontra sozinho a página de que precisa. Basta incluir o endereço no pedido, como os prompts acima já fazem.

Servidor MCP

O servidor MCP deixa o assistente pesquisar a documentação da Finvia sempre que precisar, sem você copiar nada. O endereço é:
No Claude Code, adicione com:
No Cursor e no VS Code, use o atalho Conectar do menu de cada página. Em outros assistentes, como Codex e Gemini CLI, adicione um servidor MCP remoto do tipo HTTP com o endereço acima, seguindo a documentação da ferramenta.

Veja também

Sua primeira cobrança

O passo a passo da primeira chamada, para conferir o que o assistente fez.

Roteiro de homologação

Os testes que a integração precisa passar antes de ir para produção.