Crypto

Saque Crypto (Withdraw)

POST/v1/crypto/withdraws

Cria uma nova transação de saque em criptomoedas para uma carteira externa. O usuário deve ter saldo suficiente para cobrir o valor mais a taxa.

Rate limit: 20 requisições por minuto

Definição do Body

Interface TypeScripttypescript

interface CreateCryptoWithdrawRequest {
  asset: "BTC" | "USDT" | "USDC" | "ETH";
  chain: "TRC20" | "ERC20" | "BEP20" | "BTC" | "POLYGON";
  amount: string;          // Número positivo, até 18 casas decimais
  wallet: string;          // Endereço da carteira de destino
  webhook_url?: string;    // Máximo 255 caracteres
}

Parâmetros

Campo	Tipo	Descrição
`asset`obrigatório	`string`	Moeda do saque. Aceitos: BTC, USDT, USDC, ETH.
`chain`obrigatório	`string`	Rede blockchain. Aceitas: TRC20, ERC20, BEP20, BTC, POLYGON. Deve ser compatível com o asset.
`amount`obrigatório	`string`	Valor a sacar. Número positivo maior que zero, até 18 casas decimais.
`wallet`obrigatório	`string`	Endereço da carteira blockchain de destino.
`webhook_url`	`string`	URL para receber notificações de atualização (máx. 255 caracteres).

O usuário deve ter saldo suficiente para cobrir o valor do saque mais a taxa da plataforma. Verifique o saldo antes de criar o withdraw.

Campos da Resposta

Campo	Tipo	Descrição
`transaction_id`	`string (UUID)`	ID único da transação
`asset`	`string`	Moeda sacada (maiúsculas)
`chain`	`string \| null`	Rede blockchain (maiúsculas)
`amount`	`string`	Valor solicitado para saque
`fee`	`string`	Taxa da plataforma
`wallet`	`string`	Endereço da carteira de destino
`status`	`string`	Status inicial: PROCESSING
`created_at`	`Date`	Data e hora de criação

Erros Possíveis

401

Não autenticado

"API Secret inválida"

400

Saldo insuficiente ou serviço desabilitado

"Saldo insuficiente"
"Serviço não habilitado"

POSThttps://api.connectpay.vc/v1/crypto/withdraws

Headers

api-secret: sua-api-secret-aqui
idempotency-key: unique-key-12345
Content-Type: application/json

Request Body (JSON)

{
  "asset": "USDT",
  "chain": "ERC20",
  "amount": "50.00",
  "wallet": "0x742d35Cc1D1B2F48dE3D7d8c53c4E7Db0C4bC123",
  "webhook_url": "https://seu-servidor.com/webhook"
}

cURL

curl -X POST "https://api.connectpay.vc/v1/crypto/withdraws" \
  -H "api-secret: sua-api-secret-aqui" \
  -H "idempotency-key: unique-key-12345" \
  -H "Content-Type: application/json" \
  -d '{
    "asset": "USDT",
    "chain": "ERC20",
    "amount": "50.00",
    "wallet": "0x742d35Cc1D1B2F48dE3D7d8c53c4E7Db0C4bC123",
    "webhook_url": "https://seu-servidor.com/webhook"
  }'

Response 200

{
  "hasError": false,
  "data": {
    "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
    "asset": "USDT",
    "chain": "ERC20",
    "amount": "50.00",
    "fee": "1.00",
    "wallet": "0x742d35Cc1D1B2F48...",
    "status": "PROCESSING",
    "created_at": "2024-01-15T09:30:00.000Z"
  }
}