Comece aqui
Introdução
API de pagamentos Pix do gateway Dark Pay
Bem-vindo(a) à documentação da API Dark Pay. Com ela você cria cobranças Pix (QR Code / copia-e-cola), consulta status, lista transações e solicita saques — tudo autenticado com as chaves da sua conta (pk_ / sk_) geradas em Integrações → API.
O Dark Pay é o gateway: você integra com darkpays.online; a adquirente (PodPay/Velana) fica no servidor e não é exposta ao seu frontend.
URL base (produção)
Todas as rotas de negócio usam HTTPS. Não use HTTP sem TLS.
URL base da API v1:
https://darkpays.online/api/v1https://darkpays.onlinePrimeiros passos
1. Entre no painel → Integrações → API e crie uma credencial (pk_live_… / sk_live_…).
2. Copie a secret completa (botão copiar) e guarde só no backend.
3. Crie uma cobrança com POST /payments (Pix).
4. Exiba o QR / copia-e-cola ao cliente e confirme o pagamento via webhook ou POST …/sync.
Formato
Request e response em JSON. Valores monetários (amount) em reais (BRL), número decimal — mínimo R$ 1,00 (ex.: 97.00).
Códigos HTTP 2xx = sucesso. Erros vêm em JSON com code e message.
