ADR-0005 · Pagamento por checkout hospedado da InfinitePay

Status: aceito · Substitui: plano de Pix dinâmico via API do Banco do Brasil

Contexto

O planejamento inicial previa QR Code Pix dinâmico via API do Banco do Brasil, com confirmação manual por e-mail. Isso exigiria certificado, credenciais bancárias e conciliação própria.

Decisão

Usar o checkout hospedado da InfinitePay: o order-lifecycle cria um link (POST https://api.infinitepay.io/invoices/public/checkout/links, configurável por INFINITEPAY_API_URL) com handle, itens em centavos, endereço, order_nsu, redirect_url e webhook_url. O gateway notifica /api/webhook no Next.js, que marca o pedido como PAID.

Consequências

• ➕ A plataforma não lida com dados de cartão nem gera Pix; o PCI fica com o gateway.
• ➕ Pix e cartão, com parcelamento, sem código extra.
• ➖ O webhook precisa ser verificado (hoje não é: R-01).
• ➖ A página antiga /home/payment/[orderId] com Pix fictício precisa ser removida (R-04).