Integrar com IA
Cole no seu agente de código (Claude Code, Codex…). O prompt traz o contrato da API e as regras de segurança; a chave nunca vai no prompt.
Prompt de integração
Integre a API de pagamentos da ZWAY neste projeto.
Base: https://api.zwaybr.com/api/v1. Autenticação: header Authorization: Bearer <ZWAY_API_KEY> (variável de ambiente; nunca no código, no navegador ou no app).
Criar pagamento: POST /payments com JSON { currency, paymentMethod, amount (inteiro, em centavos da moeda), name, email, document { type, number }, items [{ title, unitPrice, quantity }], externalId, ... }.
- BRL: paymentMethod PIX (exige phone e items), BOLETO (endereço opcional, expiresAt) ou CREDIT_CARD (cardToken + tokenOrigin gerados no navegador; nunca número/CVV).
- Outras moedas (ex.: MXN): consulte GET /payments/methods?currency=MXN para saber os métodos e os campos exigidos (ex.: SPEI exige document rfc, birthDate, birthCountry) e envie returnUrl.
- Sempre envie o header Idempotency-Key (um por cobrança, estável nas repetições).
Consultar: GET /payments/{id}. Erros: { error: true, code, message, details }.
Webhook: cadastre a URL no painel ZWAY (tipo Recebimento). Valide X-Webhook-Signature = 'sha256=' + HMAC-SHA256 do corpo BRUTO com o segredo do webhook (comparação em tempo constante) e use X-Webhook-Id para não processar duas vezes. Eventos: transaction.approved, transaction.pending, transaction.failed, transaction.cancelled, transaction.expired.
Regras: Não execute cobranças reais durante o desenvolvimento. Não grave a chave em arquivos versionados nem em logs. Escreva testes com a API simulada.