POST/crypto-deposits

Receber em Cripto

Gera um endereço de pagamento na cripto escolhida. Quando o cliente paga, o valor cai em reais no seu saldo.

Cada moeda tem um mínimo próprio por causa da taxa da blockchain (Bitcoin pede valores maiores). Se o valor ficar abaixo, a API responde 400 com a mensagem. Pra valores baixos, prefira USDT/USDC em BEP20, Solana ou Polygon. Pagamento parcial é aceito: a parte paga já é creditada e a cobrança continua aberta até completar.

Request Body

Parâmetro	Tipo	Descrição
`amount`*	number	Valor em reais (veja os limites em /crypto-deposits/currencies)
`currency`*	string	Código da moeda + rede, ex.: usdttrc20, btc, eth, usdtbsc

Exemplo de Request

curlbash

curl -X POST "https://api.magnuspay.com.br/crypto-deposits" \
  -H "X-API-Key: magnus_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 100, "currency": "usdttrc20" }'

Resposta

201 Createdjson

{
  "success": true,
  "data": {
    "id": "6ac841fb943cc9b3fe2b5a02",
    "status": "PENDING",
    "amount": 100,
    "fee": 4.49,
    "netAmount": 95.51,
    "payCurrency": "usdttrc20",
    "coin": "USDT",
    "network": "Tron (TRC20)",
    "payAddress": "TVv7...s1897",
    "payAmount": 19.92,
    "qrCode": "data:image/png;base64,...",
    "expiresAt": "2026-10-09T15:20:00Z",
    "paidRatio": 0,
    "credited": 0
  }
}

Mostre payAmount + payAddress (ou o qrCode) pro cliente. Ele deve enviar exatamente esse valor, nessa rede.

Consultar status

curlbash

curl "https://api.magnuspay.com.br/crypto-deposits/6ac841fb943cc9b3fe2b5a02" \
  -H "X-API-Key: magnus_sua_api_key"

Parâmetro	Tipo	Descrição
`status`	string	PENDING → COMPLETED (pago) ou FAILED (expirou sem pagamento)
`paidRatio`	number	Quanto já foi pago (0 a 1) em pagamento parcial
`credited`	number	Quanto já caiu no seu saldo, em reais

Webhook

Quando o pagamento confirma, seu webhook recebe o evento transaction.completed, igual a um PIX pago. Configure em Webhooks no painel.