Use this file to discover all available pages before exploring further.
Copie este prompt em qualquer agente de IA:
Contexto Pagou para IA
Integre pagamentos Pagou. Docs: https://developer.pagou.ai/llms.txt | Completo: https://developer.pagou.ai/llms-full.txt | OpenAPI: https://developer.pagou.ai/api-reference/openapi-v2.jsonRegras:- Valide endpoints/campos no OpenAPI antes de codar- Inclua external_ref em todas as requisições de criação- Tokenização de cartão: Payment Element + elements.submit()- Libere pedidos apenas por webhook ou estado reconciliado- Deduplique webhooks pelo id do evento no topo
## Integração Pagou- Docs: https://developer.pagou.ai/llms.txt- OpenAPI: https://developer.pagou.ai/api-reference/openapi-v2.json- Sempre inclua external_ref, valide campos no OpenAPI, libere apenas por webhook
## Integração Pagou- Docs: https://developer.pagou.ai/llms.txt- OpenAPI: https://developer.pagou.ai/api-reference/openapi-v2.json- Sempre inclua external_ref, valide campos no OpenAPI, libere apenas por webhook
Ou rode com contexto inline:
codex "Leia https://developer.pagou.ai/llms-full.txt e adicione checkout Pix"
Adicione ao .cursorrules na raiz do projeto:
## Integração Pagou- Docs: https://developer.pagou.ai/llms.txt- OpenAPI: https://developer.pagou.ai/api-reference/openapi-v2.json- Sempre inclua external_ref, valide campos no OpenAPI, libere apenas por webhook
Cole o prompt de contexto acima no início do chat e faça sua pergunta.Se o agente não conseguir acessar URLs, cole a seção relevante do llms-full.txt diretamente.
Comece com esta primeira mensagem:
Leia https://developer.pagou.ai/llms-full.txt para contexto da API Pagou.Construa: [descreva seu app]
Substitua [descreva seu app] pelo que você quer construir.
Copie qualquer um destes direto no seu agente de IA:
Checkout Pix
Leia https://developer.pagou.ai/llms-full.txt e https://developer.pagou.ai/api-reference/openapi-v2.jsonConstrua um fluxo de checkout Pix:1. Backend: POST /v2/transactions com method=pix, inclua external_ref2. Frontend: exiba pix_qr_code como imagem QR, mostre pix_code como fallback para copiar3. Webhook: escute transaction.paid, atualize status do pedido4. Trate expiração: consulte status via GET /v2/transactions/{id} se não receber webhookUse env var para API key. Nunca exponha credenciais no frontend.
Checkout cartão
Leia https://developer.pagou.ai/llms-full.txt e https://developer.pagou.ai/api-reference/openapi-v2.jsonConstrua um fluxo de checkout de cartão:1. Frontend: carregue Payment Element de https://js.pagou.ai/payments/v3.js, monte formulário de cartão2. No submit: chame elements.submit() para tokenizar, envie token para backend3. Backend: POST /v2/transactions com method=credit_card, token, installments, external_ref4. Trate 3DS: se resposta tiver next_action, redirecione usuário para completar autenticação5. Webhook: escute transaction.paid ou transaction.failed, atualize status do pedidoUse env var para API key. Nunca manipule números de cartão diretamente.
Handler de webhook
Leia https://developer.pagou.ai/llms-full.txt e https://developer.pagou.ai/api-reference/openapi-v2.jsonConstrua um endpoint de webhook:1. POST /webhooks/pagou - aceite body JSON2. Deduplique pelo campo "id" no topo (mesmo evento pode ser enviado múltiplas vezes)3. Roteie eventos de pagamento por data.event_type: transaction.paid, transaction.failed, transaction.refunded4. Roteie eventos de transferência por type: payout.transferred, payout.failed5. Retorne 200 com {"received": true}6. Processe async - responda rápido, trate lógica de negócio em backgroundArmazene IDs de eventos processados para prevenir duplicação.
Transferência Pix
Leia https://developer.pagou.ai/llms-full.txt e https://developer.pagou.ai/api-reference/openapi-v2.jsonConstrua um fluxo de transferência Pix Out:1. Backend: POST /v2/transfers com pix_key_type (CPF/CNPJ/EMAIL/PHONE/EVP), pix_key_value, amount, external_ref2. Webhook: escute payout.transferred (sucesso) ou payout.failed (erro)3. Consulta de status: GET /v2/transfers/{id} se webhook não recebido4. Cancelamento: POST /v2/transfers/{id}/cancel (só funciona se status for pending)Use env var para API key. Valide chave Pix do destinatário antes de enviar.
