Metodo Black
Use a API key Black criada em Credenciais. Com a Kust Pay ligada, ela é o provedor principal. Se a Kust estiver fora, a cobrança segue na Naken Pay do método Black e a tarifa volta para a anterior.
Cash-in
Kust Pay ativa: 5% + R$ 1,00. Kust desligada: 8% + R$ 2,00 (ou a tarifa salva na conta).
POST /api/v1/cash-in
Cash-out
Kust Pay ativa: R$ 5,00. O saque sai do provedor que recebeu o dinheiro. Se a Kust cair, o saldo que está nela não vai para a Naken.
POST /api/v1/cash-out
Autenticacao
Envie a chave Black no header X-Api-Key. Cada conta tem uma tarifa guardada no banco; o valor exibido no painel e o valor aplicado a essa conta.
X-Api-Key: pk_live_SUA_CHAVE_BLACK Content-Type: application/json Idempotency-Key: pedido-unico-123
Criar um cash-in
curl -X POST https://api.pypag.com/api/v1/cash-in \\
-H "X-Api-Key: pk_live_SUA_CHAVE_BLACK" \\
-H "Content-Type: application/json" \\
-H "Idempotency-Key: pedido-unico-123" \\
-d '{"amount":100,"customerName":"Cliente","customerDocument":"12345678901"}'A resposta inclui a transacao, o codigo Pix, a tarifa e o valor liquido.
Enviar um cash-out
curl -X POST https://api.pypag.com/api/v1/cash-out \\
-H "X-Api-Key: pk_live_SUA_CHAVE_BLACK" \\
-H "Content-Type: application/json" \\
-d '{"amount":20,"pixKey":"[email protected]","pixType":"email","idempotencyKey":"saque-unico-123"}'O cash-out requer KYC aprovado e saldo suficiente.
Webhook
Com a Kust Pay como principal, cole esta URL na credencial da Kust. O servidor só libera o saldo depois de validar a assinatura e reconsultar a cobrança.
https://api.pypag.com/api/webhook/kust
Se a Kust estiver desligada, a Naken Black continua em https://api.pypag.com/api/webhook/nakenpay.