Merchant Balance

KEY="sk_live_..."
B="https://fin-os.io/api/v1"

# 1. Текущий баланс
curl -X GET $B/merchant/balance -H "Authorization: Bearer $KEY"

# 2. Адрес пополнения в TRON
curl -X POST $B/merchant/balance/deposit-address \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain": "TRON"}'

# 3. Пополнить со счёта финансирования владельца
curl -X POST $B/merchant/balance/topup-from-treasury \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: topup-2026-08-17-01" \
  -d '{"amount": "100", "chain": "TRON"}'

# 4. Расходы на проверки за август
curl -G $B/merchant/balance/transactions \
  -H "Authorization: Bearer $KEY" \
  --data-urlencode "type=aml_fee" \
  --data-urlencode "from=2026-08-01" \
  --data-urlencode "to=2026-08-31" \
  --data-urlencode "per_page=100"

# 5. Действующий тариф
curl -X GET $B/merchant/service-pricing -H "Authorization: Bearer $KEY"

const B   = 'https://fin-os.io/api/v1';
const KEY = process.env.FINOS_SECRET_KEY;
const H   = { 'Authorization': `Bearer ${KEY}`, 'Content-Type': 'application/json' };

// Остаток расчётной строки USDT
async function serviceBalance() {
  const { data } = await (await fetch(`${B}/merchant/balance`, { headers: H })).json();
  return data.find(r => r.currency === 'USDT')?.available ?? '0';
}

// Полный леджер за период: идём по курсору, пока has_more
async function ledger(params = {}) {
  const rows = [];
  let cursor = null;

  do {
    const q = new URLSearchParams({ per_page: '100', ...params });
    if (cursor) q.set('starting_after', cursor);

    const body = await (await fetch(`${B}/merchant/balance/transactions?${q}`, { headers: H })).json();
    rows.push(...body.data);
    cursor = body.meta.has_more ? body.meta.next_cursor : null;
  } while (cursor);

  return rows;
}

// Расход на проверки за месяц
const fees = await ledger({ type: 'aml_fee', from: '2026-08-01', to: '2026-08-31' });
console.log(fees.reduce((s, r) => s + Number(r.amount), 0));

use Illuminate\Support\Facades\Http;

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

// Хватит ли на пачку проверок
$pricing = $api->get('/merchant/service-pricing')->json('data');
$balance = collect($api->get('/merchant/balance')->json('data'))
    ->firstWhere('currency', 'USDT')['available'] ?? '0';

if (bccomp($balance, bcmul($pricing['aml']['check_price'], (string) $plannedChecks, 10), 10) < 0) {
    // Пополняем со счёта финансирования: ключ идемпотентности - ваш идентификатор операции
    $api->withHeaders(['Idempotency-Key' => "topup-{$invoiceId}"])
        ->post('/merchant/balance/topup-from-treasury', ['amount' => 100, 'chain' => 'TRON']);
}

// Леджер за период с курсорной пагинацией
$rows   = [];
$cursor = null;

do {
    $page = $api->get('/merchant/balance/transactions', array_filter([
        'type'           => 'aml_fee',
        'from'           => '2026-08-01',
        'to'             => '2026-08-31',
        'per_page'       => 100,
        'starting_after' => $cursor,
    ]))->json();

    $rows   = array_merge($rows, $page['data']);
    $cursor = $page['meta']['has_more'] ? $page['meta']['next_cursor'] : null;
} while ($cursor);

import os, requests
from decimal import Decimal

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

def service_balance():
    rows = requests.get(f'{B}/merchant/balance', headers=H).json()['data']
    return next((Decimal(r['available']) for r in rows if r['currency'] == 'USDT'), Decimal(0))

def ledger(**params):
    params.setdefault('per_page', 100)
    cursor = None
    while True:
        if cursor:
            params['starting_after'] = cursor
        body = requests.get(f'{B}/merchant/balance/transactions',
                            headers=H, params=params).json()
        yield from body['data']
        if not body['meta']['has_more']:
            return
        cursor = body['meta']['next_cursor']

# Расход на проверки за август
spent = sum(Decimal(r['amount']) for r in ledger(type='aml_fee',
                                                 **{'from': '2026-08-01', 'to': '2026-08-31'}))
print(service_balance(), spent)