Customer Wallets

KEY="sk_live_..."
B="https://fin-os.io/api/v1"
UUID="5f8d7a3c-1234-4567-89ab-cdef01234567"

# 1. Выдать клиенту адрес в TRON
curl -X POST $B/customers/$UUID/wallet/addresses \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain": "TRON"}'

# 2. Балансы клиента
curl -X GET $B/customers/$UUID/wallet -H "Authorization: Bearer $KEY"

# 3. Предпросмотр вывода
curl -G $B/customers/$UUID/wallet/withdraw/quote \
  -H "Authorization: Bearer $KEY" \
  --data-urlencode "coin=USDT" \
  --data-urlencode "network=TRON" \
  --data-urlencode "address=TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb" \
  --data-urlencode "amount=100"

# 4. Вывод (Idempotency-Key обязателен)
curl -X POST $B/customers/$UUID/wallet/withdraw \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: wd-2026-08-17-0001" \
  -d '{"coin":"USDT","network":"TRON","address":"TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb","amount":"100"}'

# 5. Статус заявки
curl -X GET $B/customers/$UUID/wallet/withdrawals/$WITHDRAWAL_ID \
  -H "Authorization: Bearer $KEY"

# 6. Списать с клиента комиссию сервиса
curl -X POST $B/customers/$UUID/wallet/charge \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: chg-2026-08-17-0001" \
  -d '{"coin":"USDT","network":"TRON","amount":"12.5","reason":"Абонентская плата за август"}'

const B   = 'https://fin-os.io/api/v1';
const KEY = process.env.FINOS_SECRET_KEY;

const H = { 'Authorization': `Bearer ${KEY}`, 'Content-Type': 'application/json' };

async function call(path, opts = {}) {
  const res  = await fetch(`${B}${path}`, { ...opts, headers: { ...H, ...(opts.headers || {}) } });
  const body = await res.json();
  if (!res.ok) throw Object.assign(new Error(body.error.message), body.error);
  return body;
}

// Адрес пополнения
const address = (await call(`/customers/${uuid}/wallet/addresses`, {
  method: 'POST', body: JSON.stringify({ chain: 'TRON' }),
})).data;

// Предпросмотр: показываем клиенту итоговое списание
const q = new URLSearchParams({ coin: 'USDT', network: 'TRON', address: dest, amount });
const quote = (await call(`/customers/${uuid}/wallet/withdraw/quote?${q}`)).data;
if (!quote.allowed) throw new Error(quote.reason.error);
console.log('спишется', quote.total_debit, 'получит', quote.receives);

// Вывод. Ключ идемпотентности - ваш идентификатор операции, не случайный на каждый ретрай
const withdrawal = (await call(`/customers/${uuid}/wallet/withdraw`, {
  method: 'POST',
  headers: { 'Idempotency-Key': `wd-${orderId}` },
  body: JSON.stringify({ coin: 'USDT', network: 'TRON', address: dest, amount }),
})).data;

// Терминальные стадии: confirmed и failed. Остальное - «ещё в работе»
console.log(withdrawal.status, withdrawal.state); // pending processing

use Illuminate\Support\Facades\Http;

$base = 'https://fin-os.io/api/v1';
$api  = Http::withToken(config('services.finos.secret_key'))->acceptJson()->baseUrl($base);

// Адрес пополнения (идемпотентно)
$address = $api->post("/customers/{$uuid}/wallet/addresses", ['chain' => 'TRON'])->json('data');

// Предпросмотр вывода
$quote = $api->get("/customers/{$uuid}/wallet/withdraw/quote", [
    'coin'    => 'USDT',
    'network' => 'TRON',
    'address' => $destination,
    'amount'  => '100',
])->json('data');

if (! $quote['allowed']) {
    throw new \RuntimeException($quote['reason']['error']);
}

// Вывод: ключ идемпотентности привязан к вашей операции
$response = $api->withHeaders(['Idempotency-Key' => "wd-{$orderId}"])
    ->post("/customers/{$uuid}/wallet/withdraw", [
        'coin'    => 'USDT',
        'network' => 'TRON',
        'address' => $destination,
        'amount'  => '100',
    ]);

if ($response->failed()) {
    $err = $response->json('error');
    match ($err['code']) {
        'insufficient_funds'        => notifyTopUp($uuid),
        'withdraw_limit_exceeded'   => showLimits($quote),
        'aml_blocked'               => sendToCompliance($destination),
        'aml_screening_in_progress' => retryLater(),
        default                     => report($err),
    };
}

$withdrawal = $response->json('data');   // status=pending, state=processing

import os, requests

B   = 'https://fin-os.io/api/v1'
KEY = os.environ['FINOS_SECRET_KEY']
H   = {'Authorization': f'Bearer {KEY}'}

# Адрес пополнения
address = requests.post(f'{B}/customers/{uuid}/wallet/addresses',
                        headers=H, json={'chain': 'TRON'}).json()['data']

# Журнал: только поступления, подтверждённые сетью
txs = requests.get(f'{B}/customers/{uuid}/wallet/transactions',
                   headers=H,
                   params={'direction': 'in', 'status': 'confirmed', 'per_page': 50}
                   ).json()

# Вывод с ключом идемпотентности
r = requests.post(
    f'{B}/customers/{uuid}/wallet/withdraw',
    headers={**H, 'Idempotency-Key': f'wd-{order_id}'},
    json={'coin': 'USDT', 'network': 'TRON', 'address': destination, 'amount': '100'},
)

if r.status_code in (200, 201):
    wd = r.json()['data']
    # duplicate=True означает повтор ключа: деньги уже были списаны первым вызовом
    print(wd['id'], wd['status'], wd['state'], wd['duplicate'])
else:
    err = r.json()['error']
    print(err['code'], err['message'], err['request_id'])