Consultar Ordem Onchain

Obtenha detalhes de uma ordem blockchain específica

GET /api/v1/onchain/order/{id}

Consultar Ordem Onchain

cURL

curl --request GET \
  --url https://api.example.com/api/v1/onchain/order/{id}

200

{
  "order": {
    "network": "<string>",
    "value": 123,
    "cryptoValue": 123,
    "address": "<string>",
    "asset": "<string>",
    "status": "<string>",
    "metadata": {
      "orderId": "<string>",
      "tokenAddress": "<string>",
      "network": "<string>",
      "walletIndex": 123
    },
    "paymentLinkId": "<string>",
    "createdAt": "<string>"
  }
}

Consultar detalhes da ordem

Este endpoint retorna informações detalhadas sobre uma ordem blockchain específica usando seu ID de link de pagamento.

Parâmetros de caminho

paymentLinkId · string · required

ID do link de pagamento da ordem

Exemplo de requisição

curl -X GET "https://server.cryptouse.com.br/api/v1/onchain/order/0b664ca9-40a4-4692-80e7-f94392bbb4bf" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer seu_token_aqui"

Resposta

order · object

Show Propriedades

network · string

Rede blockchain utilizada

Valores possíveis: eth, bsc, polygon

value · number

O valor em BRL da ordem

cryptoValue · number

O valor em criptomoeda

address · string

Endereço da carteira de criptomoeda

asset · string

Tipo de criptomoeda

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

status · string

Status atual do pagamento

Valores possíveis: PENDING, COMPLETED, REFUNDED, PARTIAL_ORDER, FAILED

metadata · object

Show Propriedades

orderId · string

ID da ordem

tokenAddress · string

Endereço do contrato do token

network · string

Rede blockchain

walletIndex · number

Índice da carteira

paymentLinkId · string

Identificador único para o pagamento

createdAt · string

Timestamp de criação

Exemplo de resposta

Sucesso (200)

{
  "order": {
    "network": "bsc",
    "value": 100,
    "cryptoValue": 0.179,
    "address": "0xdC1bEaD90005669BbFc310624E3B22B2CeeE3D94",
    "asset": "USDT",
    "status": "PENDING",
    "metadata": {
      "orderId": "29fdcad5-836f-463f-b770-180bcd80da40",
      "tokenAddress": "0x55d398326f99059ff775485246999027b3197955",
      "network": "bsc",
      "walletIndex": 1100429915
    },
    "paymentLinkId": "0b664ca9-40a4-4692-80e7-f94392bbb4bf",
    "createdAt": "2025-07-30T17:30:54.387Z"
  }
}

Redes e Assets Suportados

Redes Blockchain

Rede	Descrição
eth	Ethereum Mainnet
bsc	Binance Smart Chain
polygon	Polygon (Matic)

Assets de Criptomoeda

Asset	Descrição
USDT	Tether USD
USDC	USD Coin
DAI	Dai Stablecoin
BUSD	Binance USD

Status da ordem

Status	Descrição
PENDING	A ordem foi criada mas ainda não recebeu pagamento
COMPLETED	O pagamento foi recebido e confirmado
REFUNDED	A ordem foi reembolsada
PARTIAL_ORDER	Foi recebido um pagamento parcial
FAILED	A ordem falhou por algum motivo

Notas

• As ordens completadas não podem ser modificadas
• Ordens com status PENDING expiram após 24 horas
• Para ordens com status PARTIAL_ORDER, verifique o campo status para determinar se há pagamentos parciais