Skip to main content

Create USDT Extraction

Overview​

A USDT extraction allows a store or an authorized supervisor to send USDT to a destination wallet. The equivalent USDT amount is deducted from the account linked to the store's QR code.

Who Can Perform This Operation​

This operation is available to:

  • Store users that have a QR code assigned to their account. Stores can provide a custom destination address in the request body.
  • Supervisor users created by that store, provided the buyUsdtActive flag is enabled on their profile. Supervisors cannot provide a custom address — the extraction is sent to the address stored in the store's QR code.

For details on how to create a supervisor and configure operational flags, see the Supervisor Creation Guide.

QR Code Requirement​

A QR code must be assigned to the store before an extraction can be initiated. If no QR code is assigned, the operation will be rejected.

The QR code is linked to an account ID and also stores the last address used in a USDT extraction. When a supervisor performs the operation, the address from the QR code is used automatically.

You can retrieve the current balance and details of the linked account using the Get Account by ID endpoint:

GET /api/v1/account/{id}

Endpoint​

POST /api/v1/extraction/to-usdt

Full API reference: Create a USDT extraction

Authentication​

This endpoint requires a valid Bearer Token issued to a user with the store role, or a supervisor with the buyUsdtActive flag enabled.

Authorization: Bearer <your_access_token>

See the Authentication Guide for details on obtaining a token.

Request Example​

curl -X POST "/api/v1/extraction/to-usdt" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_access_token>" \
  -d '{
    "amount": 500,
    "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
  }'

Request Body​

FieldTypeRequiredDescription
amountnumberYesAmount to withdraw in USDT.
addressstringNoDestination wallet address. Only applicable for store users — supervisors always use the address stored in the QR code

Balance and Credit​

When an extraction is initiated, the system checks the available balance of the account linked to the store's QR code.

If the account balance is not sufficient to cover the full extraction amount, the shortfall can be covered by the credit assigned to the QR code. In that case, the operation proceeds and the used credit is decremented from the QR code's available credit limit.

If neither the account balance nor the available credit is enough to cover the extraction, the operation will be rejected.

The credit limit of a QR code is managed by the platform and is not configurable via the API.

Balance Impact​

EventEffect on Balance
Extraction createdEquivalent USDT amount is immediately deducted from the account linked to the store's QR code
Extraction rejectedAmount is automatically restored to the account balance

Important Notes​

  • The store must have a QR code assigned before performing an extraction. Operations without a QR code will be rejected.
  • Supervisors must have the buyUsdtActive flag set to true by the owning store to access this endpoint. They cannot specify a custom address — the extraction uses the address stored in the store's QR code, which must be set before the operation is performed.
  • The amount must be covered by the account balance, the QR code's available credit, or a combination of both. If neither is sufficient, the operation will be rejected.