Recebendo Criptomoedas

Receba pagamentos em USDT, BTC e outras criptomoedas com conversão automática para BRL.
Resumo Rápido

A AjnaPay suporta recebimento em criptomoedas via gateway Transfi. Crie invoices crypto temporárias ou use wallets permanentes para receber pagamentos.

1. Habilitando Moedas

Antes de receber crypto, habilite as moedas desejadas na sua conta:

Endpoint
POST /api/v1/account/enable-currency
Request Body
{
  "currency": "USDTBSC"
}

2. Criando Invoice Crypto

Crie uma invoice temporária para receber um valor específico:

Endpoint
POST /api/v1/deposits
Request Body
{
  "type": "crypto",
  "currency": "USDTBSC",
  "amount": "100.00",
  "description": "Pagamento em USDT",
  "split": [
    {
      "account_id": "uuid-da-conta",
      "percentage": 100
    }
  ]
}

3. Wallet Permanente

Para receber múltiplos pagamentos, use a wallet permanente da conta:

Endpoint
GET /api/v1/account/crypto-balances
Response 200 OK
{
  "success": true,
  "data": [
    {
      "currency": "USDTBSC",
      "balance": "250.00",
      "wallet_address": "0x1234...abcd",
      "network": "BSC"
    },
    {
      "currency": "BTC",
      "balance": "0.005",
      "wallet_address": "bc1q...xyz",
      "network": "Bitcoin"
    }
  ]
}

4. Moedas Suportadas

Moeda Rede Precisão Mínimo
USDTBSC Binance Smart Chain 6 casas 1.00 USDT
USDTETH Ethereum 6 casas 1.00 USDT
BTC Bitcoin 8 casas 0.0001 BTC
ETH Ethereum 8 casas 0.001 ETH

5. Webhooks Crypto

Receba notificações sobre depósitos crypto:

Evento Descrição
crypto.deposit.received Depósito crypto recebido
crypto.deposit.confirmed Depósito confirmado na blockchain
crypto.deposit.converted Crypto convertida para BRL

6. Exemplo Completo

Exemplo com cURL
# Habilitar USDT
curl -X POST "https://ajnapay.com.br/api/v1/account/enable-currency" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"currency": "USDTBSC"}'

# Criar invoice de 100 USDT
curl -X POST "https://ajnapay.com.br/api/v1/deposits" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "crypto",
    "currency": "USDTBSC",
    "amount": "100.00"
  }'

# Consultar wallets
curl -X GET "https://ajnapay.com.br/api/v1/account/crypto-balances" \
  -H "Authorization: Bearer SEU_TOKEN"