> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uspix.vc/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar Endereço Direto

> Criar endereço USDT para pagamento com rede já pré-preenchida, ideal para white-label.

## Parâmetros de Requisição

<ParamField body="amount" type="string" required>
  Valor da cobrança em BRL (Real brasileiro). Ex.: 10
</ParamField>

<ParamField body="network" type="string" required placeholder="POLYGON">
  Rede para o pagamento do USDT. Ex.: POLYGON ou TRON
</ParamField>

## Parâmetros de Resposta

<ResponseField name="id" type="string">
  Identificador único da ordem ou transação gerada no sistema no formato UUID.
</ResponseField>

<ResponseField name="status" type="string">
  Status atual do pagamento. Disponíveis: `OPEN`, `SUCCESS` e `FAILED`
</ResponseField>

<ResponseField name="network" type="string">
  Rede blockchain utilizada para a transação de criptomoedas (Ex: `POLYGON`).
</ResponseField>

<ResponseField name="amount" type="string">
  Valor total da transação na moeda fiduciária principal.
</ResponseField>

<ResponseField name="currency" type="string">
  Sigla da moeda fiduciária utilizada na cobrança (Ex: `BRL`).
</ResponseField>

<ResponseField name="usdt_amount" type="string">
  Quantidade equivalente em USDT a ser paga na criptomoeda.
</ResponseField>

<ResponseField name="address" type="string">
  Endereço da carteira blockchain de destino para onde o pagamento deve ser enviado.
</ResponseField>

<ResponseField name="expires_at" type="string">
  Data e hora de expiração do pagamento no formato ISO 8601.
</ResponseField>

<ResponseField name="checkout_url" type="string">
  Link direto para a página de pagamento (checkout) onde o cliente final realizará a transação.
</ResponseField>

<ResponseField name="status_url" type="string">
  URL da API para consultar o status atualizado da ordem de pagamento.
</ResponseField>

<ResponseField name="created_at" type="string">
  Data e hora exatas em que o registro foi criado no servidor, no formato ISO 8601.
</ResponseField>

<RequestExample>
  ```shellscript cURL theme={null}
  curl --request POST \
    --url https://checkout.uspix.vc/api/orders \
    --header 'authorization: Bearer CHAVE_API' \
    --header 'content-type: application/json' \
    --data '{
    "amount": 45,
    "network": "POLYGON"
  }'
  ```

  ```python Python theme={null}
  import requests

  url = "https://checkout.uspix.vc/api/orders"

  payload = {
      "amount": 45,
      "network": "POLYGON"
  }
  headers = {
      "authorization": "Bearer CHAVE_API",
      "content-type": "application/json"
  }

  response = requests.post(url, json=payload, headers=headers)

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const request = require('request');

  const options = {
    method: 'POST',
    url: 'http://checkout.uspix.vc/api/orders',
    headers: {
      authorization: 'Bearer CHAVE_API',
      'content-type': 'application/json'
    },
    body: {amount: 45, network: 'POLYGON'},
    json: true
  };

  request(options, function (error, response, body) {
    if (error) throw new Error(error);

    console.log(body);
  });
  ```

  ```php PHP theme={null}
  <?php

  $curl = curl_init();

  curl_setopt_array($curl, [
    CURLOPT_URL => "https://checkout.uspix.vc/api/orders",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => json_encode([
      'amount' => 45,
      'network' => 'POLYGON'
    ]),
    CURLOPT_HTTPHEADER => [
      "authorization: Bearer CHAVE_API",
      "content-type: application/json"
    ],
  ]);

  $response = curl_exec($curl);
  $err = curl_error($curl);

  curl_close($curl);

  if ($err) {
    echo "cURL Error #:" . $err;
  } else {
    echo $response;
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "019f9eee-8dd4-71f0-9a02-9045090c8106",
    "status": "OPEN",
    "network": "POLYGON",
    "amount": "45.00",
    "currency": "BRL",
    "usdt_amount": "9.29",
    "address": "0x03baf1c24f3167C378903CFb9A5c949A46Ad6547",
    "checkout_url": "https://checkout.uspix.vc/checkout/019f9eee-8dd4-71f0-9a02-9045090c8106",
    "status_url": "https://checkout.uspix.vc/api/orders/019f9eee-8dd4-71f0-9a02-9045090c8106/status",
    "created_at": "2026-07-26T14:57:41+00:00",
    "expires_at": "2026-07-26T15:12:43+00:00",
  }
  ```
</ResponseExample>