Transfer Wallet API

This guide is for TRANSFER-mode agents building their own website — your backend calls best-system's member API server-to-server only.

Three things to prepare

  1. In bo-web, open Api Management → API Credential, turn on the External Site API switch and set the IP allowlist (your server's outbound IPs)
  2. Store these 3 values as environment variables on your backend:
ValueFormat
BASE_URLhttps://api.example.com (provided by the best-system team per environment)
API_KEYak_ followed by 48 hex chars
API_SECRET64 hex chars — server-side only
  1. Sign every request with X-Api-Key + HMAC per Authentication

Every endpoint lives under BASE_URL/api/v1 and returns the same envelope { success, code, message, data, request_uuid } — success means code === 0 (see Conventions)