https://api.pagmaster.site/api/v1/public. Autentique com Authorization: Bearer $MASTER_API_KEY. Para uma subconta, envie X-Master-Subaccount em todas as chamadas, incluindo consultas.
Unidades e taxas
A taxa é 3% por recebimento confirmado e 3% por saque, descontada do bruto. Os cálculos são feitos em unidades inteiras; a taxa é arredondada para cima em um milionésimo de USDT. Não aplique também a tarifa Pix ou cartão.
Uma cobrança com cotação de 25 USDT tem taxa de 0,75 USDT e crédito de 24,25 USDT. Um saque bruto de 11 USDT tem taxa de 0,33 USDT e entrega prevista de 10,67 USDT. Exemplos ilustrativos.
Criar cobrança
POST /crypto/charges exige escopo charges.
amountMinor: inteiro. USD: 100–200000; BRL: 200–200000. Os mínimos específicos da moeda ou rede também podem limitar a criação.currency:brlouusd; obrigatória, indica a moeda do preço.payCurrency:usdt,btc,eth,ltc,trx,sol,doge,xrp,adaoumatic.network: apenas para USDT,trc20,erc20,bsc,soloupolygon. Padrãotrc20. Enviar rede para outra moeda retorna400.payerName: 2–100 caracteres.description: 0–200 caracteres.requestKey: UUID obrigatório. Use a mesma referência para repetir os mesmos dados.
expiresAt retornado.
O endereço pode ser convertido em QR Code no seu frontend. Um QR contendo somente o endereço não preenche necessariamente o valor ou a rede na carteira.
Consultar e confirmar
GET /crypto/payments/{id} exige read e recebe o UUID da Pagmaster, não um identificador externo. A Pagmaster consulta o processamento automaticamente no backend, mesmo com o painel fechado. A leitura pode realizar uma consulta vencida; respeita leases, filas, limites e pausas da integração.
status: "paid". Não há rota de aprovação manual. Um envio na blockchain, partially_paid, a geração do endereço ou o vencimento local do relógio não autorizam crédito pela Pagmaster. Apenas a confirmação autenticada e validada do processamento gera o lançamento único.
O polling de cripto é agendado em aproximadamente 5 segundos após cada consulta bem-sucedida. Não é promessa de confirmação em 5 segundos: confirmações de rede, tempo da integração e limites podem ampliar a espera. Um campo
notice indica resultado incerto ou análise de integridade.
Saldo e histórico
GET /crypto/account: saldo disponívelbalanceUnits, reservasreservedUnits, taxas, moedas, redes e limites. Exigeread.GET /crypto/payments: até 100 movimentações cripto recentes do contexto selecionado. Inclui recebimentos e saques; exigeread.GET /crypto/payments/{id}: detalhes e consulta de status da movimentação daquele contexto.
Prévia de saque
POST /crypto/withdrawals/preview exige read. Não movimenta dinheiro.
grossUnits, feeUnits, netUnits, feePercent: 3, sufficientBalance, withdrawalsFrozen, currency: "usdt", unitScale: 1000000 e network: "trc20".
Solicitar saque
POST /crypto/withdrawals exige transfers. O único destino suportado é uma carteira USDT TRC-20, com endereço Tron válido e checksum conferido. Não exige código por e-mail.
/crypto/account.
O saldo bruto é reservado atomicamente. A taxa está incluída no débito: não a some novamente. O dinheiro chega à carteira já com o desconto. O status inicial pode ser pending, queued ou unknown; consulte a mesma rota /crypto/payments/{id}. O processamento consulta seu histórico de saques, valida referência e valor, e somente então conclui o débito ou libera uma reserva rejeitada.
Os bloqueios de saque da conta e da plataforma também valem para cripto; o bloqueio de saques pela API vale para esta rota. Saldo de outra conta, da principal ou em reais não complementa saldo USDT insuficiente.
Repetição e integridade
A criação remota de cripto não documenta idempotência. A Pagmaster registra e reclama cada solicitação antes do POST externo e nunca o repete automaticamente após resultado incerto. Repetir a mesmarequestKey retorna o mesmo registro; dados ou contexto diferentes retornam 409. Uma solicitação que ainda não foi enviada pode aguardar em fila.
Recebimentos e saques confirmados usam identidade financeira única e ledger em unidades inteiras. A varredura confere saldos e reservas; divergências bloqueiam novos saques daquela carteira sem alterar o saldo automaticamente. Resultados desconhecidos mantêm as reservas até confirmação ou investigação pelo suporte.
Webhooks para sua aplicação
Os endpoints cadastrados em Integrações → Webhooks recebem eventos assinados:crypto.payment.pending,crypto.payment.paid,crypto.payment.failed,crypto.payment.expired.crypto.withdrawal.pending,crypto.withdrawal.completed,crypto.withdrawal.failed,crypto.withdrawal.cancelled.
id, type, createdAt, data e a mesma assinatura. Os dados usam settlementCurrency: "usdt" e unitScale: 1000000, com grossUnits, feeUnits, netUnits, operationId e subaccountId. Não interprete esses eventos como centavos BRL. Entregas são idempotentes por movimentação e tipo, mas sua aplicação também deve deduplicá-las.
Esses são webhooks enviados pela Pagmaster ao seu endpoint. A confirmação financeira da Pagmaster continua baseada em polling autenticado, sem recebimento de webhook da liquidante.