Saque cripto

Cria uma solicitação de saque cripto em USDT BEP20 usando a API pública da PulsePag. O valor é informado em BRL e a wallet de destino deve ser uma carteira válida na rede BNB Smart Chain.

Endpoint: POST /api/crypto/withdraw

Autenticação

Use Authorization: Bearer SEU_JWT.
O token JWT é gerado em POST /api/auth/login.

Parâmetro	Tipo	Obrigatório	Descrição
`amount`	number	Sim	Valor do saque em BRL.
`wallet`	string	Sim	Endereço BEP20 de destino.
`wallet_address`	string	Não	Alias legado compatível para `wallet`.
`projectWebhook`	string	Não	URL opcional para receber callback do cliente.

curl -X POST 'https://api.pulsepag.com/api/crypto/withdraw' \
  --header 'Authorization: Bearer SEU_JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 250.00,
    "wallet": "0x8f3ab4c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7",
    "projectWebhook": "https://seusistema.com/webhooks/crypto-withdraw"
  }'

Resposta de exemplo

Exemplo ilustrativo. O shape pode variar conforme o estágio da operação.

{
  "message": "Crypto withdrawal processed successfully.",
  "withdrawal": {
    "transaction_id": "crypto-abc123",
    "status": "PROCESSING",
    "amount": 250.00,
    "fee": 12.50,
    "total": 262.50,
    "wallet": "0x8f3ab4c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7"
  }
}

Validação da wallet

Regra	Descrição
Formato	Wallet EVM com 42 caracteres iniciando em `0x`.
Rede	Somente BNB Smart Chain / BEP20.
Status	Trate PENDING, PROCESSING, COMPLETED e FAILED como possíveis resultados.

/^0x[a-fA-F0-9]{40}$/

Endpoints complementares

Endpoint	Uso
`GET /api/crypto/fees`	Consulta taxas e limites do saque cripto.
`GET /api/crypto/status/{transactionId}`	Consulta o status do saque cripto pelo identificador retornado na criação.