Introdução

A PagusPay é uma API de pagamentos para enviar USDC → Pix — você deposita saldo em USDC numa conta de stablecoins, e a PagusPay converte e liquida em contas bancárias brasileiras via Pix, usando chaves Pix padrão (CPF, CNPJ, email, telefone ou EVP) para identificar os beneficiários.

Somente criação (maker-only) por design

A API é, propositalmente, maker-only. Tudo o que você pode fazer via API para na submissão:

• Criar beneficiários
• Criar folhas de pagamento (rascunho)
• Submeter uma folha para aprovação

A aprovação e a execução são sempre humanas. Toda folha de pagamento que movimenta dinheiro exige uma etapa maker/checker com confirmação de dois fatores (2FA por email), feita por uma pessoa no painel da PagusPay. Não existe endpoint de API para aprovar, rejeitar ou executar uma folha — isto é uma fronteira de segurança deliberada, não uma funcionalidade em falta.

API (você)                         Painel (humano)
──────────                         ──────────────────
POST /v1/recipients        ──►
POST /v1/payout-batches    ──►     draft
POST .../{id}/submit       ──►     pending_approval
                                    │
                                    ▼
                            aprovação + 2FA (maker/checker)
                                    │
                                    ▼
                            executing → completed

O que você pode construir

• Rotinas automatizadas de folha de pagamento ou pagamento a fornecedores que param em pending_approval, prontas para aprovação humana
• Gestão de beneficiários sincronizada com o seu próprio sistema de registro
• Painéis somente leitura sobre saldos, beneficiários e status de folhas

Próximos passos

• Autenticação — como criar e usar tokens de API
• Guia de Pagamentos — o fluxo completo de beneficiário → folha → submissão com requisições reais
• Referência da API — documentação completa dos endpoints, gerada a partir da especificação OpenAPI