Criar Depósito

Crie uma nova ordem de depósito e gere um endereço para receber fundos

POST /api/v1/onchain/deposit

Criar Depósito

cURL

curl --request POST \
  --url https://api.example.com/api/v1/onchain/deposit \
  --header 'Bearer: <bearer>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "value": 123,
  "asset": "<string>",
  "network": "<string>"
}
'

200

{
  "order": {
    "address": "<string>",
    "paymentLinkId": "<string>",
    "network": "<string>",
    "asset": "<string>",
    "amount": 123
  }
}

Retorna os detalhes de uma nova ordem de depósito onchain, incluindo um endereço de carteira para receber fundos na blockchain.

Autorizações

Bearer · string · required

Chave de API para autenticação

Autenticação via API key no formato Bearer: <sua_chave_de_api>, onde <sua_chave_de_api> é sua chave de API.

Parâmetros da requisição

Body

value · number · required

O valor em BRL a ser depositado

asset · string · required

O tipo de criptomoeda a ser utilizado

Valores possíveis: USDT, USDC, DAI, BUSD

network · string · required

A rede blockchain a ser utilizada

Valores possíveis: eth, bsc, polygon

Resposta

order · object

Show Propriedades

address · string

Endereço da carteira para o depósito

paymentLinkId · string

Identificador único para o pagamento

network · string

Rede blockchain utilizada

asset · string

Tipo de criptomoeda

amount · number

A quantidade em criptomoeda a ser depositada

Sucesso (201)

{
  "order": {
    "address": "0x1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t",
    "paymentLinkId": "pmt_12345abcde",
    "network": "bsc",
    "asset": "USDT",
    "amount": 23.74
  }
}

Exemplos de código

cURL

curl -X POST "https://server.cryptouse.com.br/api/v1/onchain/deposit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer seu_token_aqui" \
  -d '{
    "value": 100.00,
    "asset": "USDT",
    "network": "bsc"
  }'

Notas

• O endereço gerado é exclusivo para esta ordem e não deve ser reutilizado
• A taxa de conversão BRL para criptomoeda é fixada no momento da criação da ordem
• Após o depósito ser recebido e confirmado na blockchain, você receberá uma notificação
• A ordem expira após 24 horas se nenhum pagamento for recebido