Criar Ordem Binance

Crie uma nova ordem de pagamento Binance

POST /api/v1/order/create

Criar Ordem Binance

cURL

curl --request POST \
  --url https://api.example.com/api/v1/order/create \
  --header 'Content-Type: application/json' \
  --data '
{
  "value": 123,
  "payerId": "<string>",
  "merchant": {
    "subMerchantId": "<string>"
  }
}
'

200

{
  "message": "<string>",
  "order": {
    "id": "<string>",
    "paymentLinkId": "<string>",
    "value": 123,
    "status": "<string>",
    "qrCodeLink": "<string>",
    "link": "<string>",
    "createdAt": "<string>"
  }
}

Criar ordem de pagamento Binance

Este endpoint gera um novo QR code de pagamento Binance para o valor especificado.

Requisição

value · number · required

O valor do pagamento em BRL

payerId · string

ID de referência do pagador (opcional)

merchant · object

Show Propriedades

subMerchantId · string

Identificador do comerciante para o pagamento

Exemplo de requisição

curl -X POST "https://server.cryptouse.com.br/api/v1/order/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer seu_token_aqui" \
  -d '{
    "value": 150.00,
    "payerId": "user_123",
    "merchant": {
      "subMerchantId": "merch_456"
    }
  }'

Resposta

message · string

Mensagem de sucesso

order · object

Show Propriedades

id · string

ID da ordem

paymentLinkId · string

Identificador único do link de pagamento

value · number

Valor do pagamento em BRL

status · string

Status da ordem

Valores possíveis: PENDING, COMPLETED, CANCELLED, FAILED, REFUND

qrCodeLink · string

URL para a imagem do QR code

link · string

URL de pagamento para o usuário

createdAt · string

Timestamp de criação da ordem

Exemplo de resposta

Sucesso (201)

{
  "message": "Ordem criada com sucesso",
  "order": {
    "id": "ord_67890fghij",
    "paymentLinkId": "pmt_12345abcde",
    "value": 150.00,
    "status": "PENDING",
    "qrCodeLink": "https://server.cryptouse.com.br/qrcode/pmt_12345abcde.png",
    "link": "https://pay.cryptouse.com/binance/pmt_12345abcde",
    "createdAt": "2023-04-20T15:00:00Z"
  }
}

Integração com Binance Pay

Este endpoint utiliza o serviço Binance Pay para processar pagamentos em criptomoedas. Os usuários poderão pagar usando:

1. O aplicativo Binance escaneando o QR code
2. Qualquer carteira compatível com o link de pagamento
3. Acessando diretamente o link de pagamento

Notificações

Você receberá uma notificação quando o status da ordem for alterado. Os possíveis status incluem:

Status	Descrição
PENDING	A ordem foi criada e aguarda pagamento
COMPLETED	O pagamento foi recebido e confirmado
CANCELLED	A ordem foi cancelada
FAILED	O pagamento falhou
REFUND	O pagamento foi reembolsado

Tempo de expiração

As ordens Binance expiram após 30 minutos se nenhum pagamento for recebido.