Integre pagamentos com a nossa API

Você integra a API Reborn Pay para um seller Brasil. Ignore o que você sabe de Stripe, Adyen ou outro gateway. Se um path, header ou campo não estiver neste prompt ou em https://docs.rebornpay.io/api/openapi, ele não existe.

Este seller cobra só no Brasil (BRL, PIX, payment link, checkout session). Não implemente cobrança internacional.

Antes de escrever código:
1. Para cada chamada HTTP, confirme path, método, headers e schema em https://docs.rebornpay.io/api/openapi. Copie dali. Não invente campo.
2. Ambiente padrão: sandbox https://sandbox-api.rebornpay.io. Produção (https://api.rebornpay.io) só se o humano pedir.
3. Peça a chave ao humano. No servidor, envie X-Api-Key (alternativa: Authorization: ApiKey <chave>). No browser, use só a publishable key pk_. Nunca coloque chave secreta em variável NEXT_PUBLIC_, no client ou no repositório. Use o prefixo que o dashboard emitiu. Não renomeie a chave.

Erros e webhooks:
- Falha vem em errors[].code. Trate o code, não o título. O campo status é string. Catálogo: https://docs.rebornpay.io/guides/errors.
- 4xx: corrija autenticação, payload ou estado. Sem retry.
- 409: idempotência. Repita a requisição original ou use outra Idempotency-Key.
- 429, 502, 503 e 504: retry com backoff.
- Webhook: https://docs.rebornpay.io/guides/webhooks. O secret aparece uma vez. Valide X-Reborn-Signature. O canal Webhook precisa estar ligado no dashboard.

Se o guia e o OpenAPI divergirem na forma do request, o OpenAPI vence. Se divergirem em qual fluxo usar, o guia vence.

Fluxo Brasil — leia https://docs.rebornpay.io/guides/checkout e, se usar Elements, https://docs.rebornpay.io/guides/elements:
- Crie a sessão com POST /v1/checkout-sessions. PIX confirma com paymentMethod PIX. Cartão exige 3DS2 no browser com @rebornpay/checkout-3ds. Não feche cartão só no servidor.
- PAN e CVV não passam pela API do merchant. Tokenize no browser.
- No threeds/authenticate, o IP do comprador vem do BFF (x-forwarded-for ou x-real-ip). Ignore deviceInformation.ipAddress vindo do JavaScript.
- Trate CHK-010 (bloqueado) e CHK-011 (revisão manual) na UI.
- transactions.runThreeDs existe só neste fluxo.
- Proibido: POST /v1/transactions, payments.collect, payments.confirm, Card Fields internacionais e o guia https://docs.rebornpay.io/guides/international.

Pronto para colar. O agent fica no checkout Brasil e não abre cobrança internacional. No Cursor, a cópia inclui o cabeçalho da rule.