Integração com IA

Leia https://developer.pagou.ai/llms-full.txt e https://developer.pagou.ai/api-reference/openapi-v2.json

Construa um fluxo de checkout Pix:
1. Back-end/server function apenas: POST /v2/transactions com method=pix, valor em centavos e external_ref
2. Front-end: exiba apenas os campos Pix voltados ao comprador retornados pelo back-end
3. Webhook: implemente POST /webhooks/pagou, deduplique pelo id de topo e roteie event=transaction por data.event_type
4. Liberação: atualize o pedido apenas depois de transaction.paid ou estado pago reconciliado
5. Reconciliação: use GET /v2/transactions/{id} apenas para recuperação/suporte, não como fluxo principal

Use env vars para API keys. Nunca exponha credenciais Pagou no front-end. Valide todos os campos no OpenAPI.

Leia https://developer.pagou.ai/llms-full.txt e https://developer.pagou.ai/api-reference/openapi-v2.json

Construa um fluxo de checkout de cartão:
1. Front-end: carregue Payment Element de https://js.pagou.ai/payments/v3.js e monte campos hospedados de cartão
2. No submit: chame elements.submit() e envie ao back-end apenas o token pgct_
3. Back-end/server function apenas: POST /v2/transactions com method=credit_card, valor em centavos, token, installments e external_ref
4. 3DS: se a resposta do back-end tiver next_action, continue o challenge pelo fluxo do SDK
5. Webhook: roteie event=transaction por data.event_type e atualize o pedido apenas depois de webhook ou reconciliação no servidor
6. Reconciliação: use GET /v2/transactions/{id} apenas depois de estado incerto no browser/rede

Use env vars para API keys. Nunca exponha segredos nem manipule número de cartão diretamente. Valide todos os campos no OpenAPI.

Leia https://developer.pagou.ai/llms-full.txt e https://developer.pagou.ai/api-reference/openapi-v2.json

Construa um fluxo de link de checkout hospedado pela Pagou, sem manipular cartão:
1. Apenas no back-end/server function: POST /v2/checkout-links com Authorization: Bearer <API key>
2. Body com produtos: { "currency": "BRL", "title": "<pedido>", "products": [{ "external_id": "<seu id>", "name": "<nome>", "price": <centavos>, "quantity": <n> }] }
3. Body só-valor: { "currency": "BRL", "amount": <centavos> }. Envie products OU amount, nunca ambos.
4. external_id é o seu identificador de produto; reenviar o mesmo id atualiza o produto sem duplicá-lo.
5. A resposta é { "data": { "url": "<url do checkout>" } }; redirecione o comprador para data.url.
6. Liberação: atualize o pedido somente quando o webhook de transação (event=transaction, data.event_type) confirmar o pagamento, nunca no redirecionamento.

Preços e valores são inteiros em centavos. Mantenha a API key no servidor em uma variável de ambiente, nunca no navegador. Valide todos os campos no OpenAPI.

Leia https://developer.pagou.ai/llms-full.txt e https://developer.pagou.ai/api-reference/openapi-v2.json

Construa um fluxo de assinatura:
1. Back-end/server function apenas: crie ou consulte o cliente com /v2/customers
2. Front-end: use Payment Element em modo subscription e envie ao back-end apenas o token pgct_
3. Back-end: POST /v2/subscriptions com customer_id, token, valor em centavos, interval, interval_count, external_ref/metadata se necessário
   Para Pix Automático: pule o passo 2, envie payment_method "pix_automatic" sem token e mostre ao pagador o authorization.qr_code retornado
4. Webhook: implemente POST /webhooks/pagou, deduplique pelo id de topo e roteie event=subscription por data.event_type
5. Estado: libere ou remova acesso pelo status da assinatura e webhooks de assinatura, não pelo estado do browser
6. Reconciliação: use GET /v2/subscriptions/{id} apenas para recuperação/suporte ou estado incerto

Trate subscription.created, subscription.started, subscription.renewed, subscription.updated, subscription.canceled, subscription.payment_failed, subscription.past_due, subscription.unpaid, subscription.trial_will_end e subscription.chargeback_received.

Use env vars para API keys. Nunca exponha credenciais Pagou no front-end. Valide todos os campos no OpenAPI.

Leia https://developer.pagou.ai/llms-full.txt e https://developer.pagou.ai/api-reference/openapi-v2.json

Construa um endpoint de webhook:
1. POST /webhooks/pagou - aceite body JSON e retorne 200 com {"received": true} rapidamente
2. Persista ou enfileire o payload bruto antes do processamento assíncrono
3. Deduplique pelo campo "id" no topo (mesmo evento pode ser enviado múltiplas vezes)
4. Roteie eventos de pagamento por event=transaction e data.event_type
5. Roteie eventos de assinatura por event=subscription e data.event_type
6. Roteie eventos de transferência pelo type no topo, como payout.transferred, payout.failed, payout.rejected, payout.canceled
7. Execute tarefas lentas da aplicação em background, não antes da resposta HTTP

Armazene IDs de eventos processados para prevenir duplicação. Não use polling como caminho principal de atualização de estado.

Leia https://developer.pagou.ai/llms-full.txt e https://developer.pagou.ai/api-reference/openapi-v2.json

Construa um fluxo de transferência Pix Out:
1. Back-end/server function apenas: POST /v2/transfers com dados Pix do recebedor, valor em centavos e external_ref
2. Webhook: roteie eventos de transferência pelo type no topo, incluindo payout.transferred, payout.failed, payout.rejected e payout.canceled
3. Estado: atualize o status do payout pelo webhook/status do recurso, não por polling no front-end
4. Reconciliação: use GET /v2/transfers/{id} apenas se o webhook atrasar ou ficar incerto
5. Cancelamento: POST /v2/transfers/{id}/cancel apenas quando o status atual do recurso permitir

Use env vars para API keys. Nunca exponha credenciais Pagou no front-end. Valide todos os campos no OpenAPI.