Primeiros Passos

Bem-vindo a documentacao oficial da API NomadPay. Esta plataforma foi projetada para integrar pagamentos PIX com maxima facilidade e profissionalismo.

---

Ambientes

A NomadPay disponibiliza dois ambientes:

Ambiente	URL Base	Uso
Sandbox	https://api.nomadspay.com	Testes e desenvolvimento
Producao	https://api.nomadspay.com	Operacoes reais

No painel (Dashboard), alterne entre as credenciais de Sandbox e Live na aba API → Credenciais.

---

Fluxo Basico de Integracao

1. Criar Cobranca    →    POST /charges
2. Exibir QR Code    →    Use pix_code retornado
3. Aguardar pagamento →   Webhook charge.paid na sua URL
4. Confirmar e liberar →  Use o event_id para idempotencia

---

Autenticacao

Todas as requisicoes exigem o header Authorization com seu Client Secret:

Authorization: Bearer <SEU_CLIENT_SECRET>

Consulte a pagina de Autenticacao para mais detalhes.

---

Endpoints Disponiveis

Metodo	Rota	Descricao
POST	/charges	Criar cobranca PIX
GET	/charges/:id	Consultar status de cobranca
GET	/charges/balance	Consultar saldo disponivel
POST	/withdrawals	Solicitar saque (Cash Out)