NORYK GATEWAY — EXEMPLOS DE INTEGRAÇÃO NO BACKEND

Estes exemplos criam uma cobrança Pix de R$100 (amountCents=10000).
No ambiente real, o Pix copia e cola retornado é pagável. Revise o valor do exemplo antes de executar; GET /health informa o ambiente.
Não execute um exemplo contra dinheiro real como teste.

Configure no ambiente protegido do seu servidor:
- NORYK_BASE_URL: origem da sua API. Padrão: http://127.0.0.1:8080
- NORYK_API_KEY: chave própria emitida no painel Credenciais, com payments:write.
- IDEMPOTENCY_KEY: chave única do pedido, persistida antes da primeira chamada.

Use a mesma IDEMPOTENCY_KEY e o mesmo corpo ao recuperar este pedido.
Trocar a chave pode criar uma segunda cobrança. Os exemplos não fazem retry
automático nem seguem redirecionamentos que encaminhem a credencial.
Os exemplos Node.js, Python e PHP também conferem id, status e amountCents na
resposta de sucesso antes de considerá-la confirmada. Em cURL, valide o JSON
retornado no seu backend antes de confirmar o pedido. Um 2xx incompleto permanece
sem confirmação e não autoriza usar uma chave nova.
Não mantenha API keys em frontend, repositórios, prompts ou arquivos públicos.

Arquivos:
- create-charge.sh: Bash + cURL. No Windows, utilize um shell Bash compatível
  ou adapte o trecho para curl.exe; o alias curl do PowerShell pode ser diferente.
- create-charge.mjs: Node.js 24, sem dependências adicionais.
- create-charge.py: Python 3 com biblioteca padrão.
- create-charge.php.txt: referência PHP 8.3+ com extensão cURL. Salve no seu
  backend como create-charge.php. A extensão .txt evita execução acidental
  ao publicar a pasta de documentação em hospedagem PHP.

Depois de receber a resposta, persista id e acompanhe GET /v1/charges/{id}.
qrCode é o texto Pix copia e cola. paid ainda é a liberar; settled é liquidado.
Em falha de comunicação, conserve a chave e os dados e confira o mesmo pedido.

Não execute arquivos PHP de exemplo como endpoints públicos na sua hospedagem:
eles são referências para integrar dentro do backend da sua aplicação.
O portal de documentação disponibiliza os arquivos apenas para download.
