Managed Customers

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

# 1. Создать клиента (телефон обязателен)
curl -X POST $B/customers \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Иван Петров",
    "phone": "+79001234567",
    "email": "ivan@example.com",
    "external_id": "user-42",
    "metadata": {"tier": "gold"}
  }'
# 201 - создан, 200 - клиент с таким external_id или телефоном уже был

# 2. Найти клиента по телефону (точное совпадение)
curl -G $B/customers -H "Authorization: Bearer $KEY" \
  --data-urlencode "filter[phone]=+79001234567"

# 3. Согласие на обработку данных (нужно перед KYC)
curl -X POST $B/customers/$UUID/consent \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip": "203.0.113.42"}'

# 4. Заблокировать и разблокировать
curl -X POST $B/customers/$UUID/block \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Подозрительная активность"}'

curl -X POST $B/customers/$UUID/unblock -H "Authorization: Bearer $KEY"

# 5. История операций постранично по курсору
curl -G $B/customers/$UUID/transactions -H "Authorization: Bearer $KEY" \
  --data-urlencode "per_page=50" \
  --data-urlencode "starting_after=7c1f2b90-4a3e-4a1f-9c62-8b0f4a7d2e11"

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

// Создание идемпотентно: 201 - новый, 200 - уже был
async function createCustomer(data) {
  const res  = await fetch(`${B}/customers`, { method: 'POST', headers: H, body: JSON.stringify(data) });
  const body = await res.json();
  if (!res.ok) throw Object.assign(new Error(body.error.message), body.error);
  return { customer: body.data, created: res.status === 201 };
}

// Поиск по телефону - точное совпадение
async function findByPhone(phone) {
  const q = new URLSearchParams({ 'filter[phone]': phone });
  const { data } = await (await fetch(`${B}/customers?${q}`, { headers: H })).json();
  return data[0] ?? null;
}

// Полная история клиента по курсору
async function history(uuid) {
  const rows = [];
  let cursor = null;

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

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

  return rows;
}

const { customer, created } = await createCustomer({
  name: 'Иван Петров', phone: '+79001234567', external_id: 'user-42',
});
console.log(created ? 'создан' : 'уже существовал', customer.uuid);

use Illuminate\Support\Facades\Http;

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

// 1. Создание. 201 - новый клиент, 200 - уже был (по external_id или телефону)
$response = $api->post('/customers', [
    'name'        => 'Иван Петров',
    'phone'       => '+79001234567',
    'email'       => 'ivan@example.com',
    'external_id' => 'user-42',
]);

$customer = $response->json('data');
$created  = $response->status() === 201;

// 2. Согласие на обработку данных
$api->post("/customers/{$customer['uuid']}/consent", ['ip' => request()->ip()]);

// 3. Поиск по телефону
$found = $api->get('/customers', ['filter' => ['phone' => '+79001234567']])->json('data');

// 4. Удаление: 204 либо 409 с причиной отказа
$delete = $api->delete("/customers/{$customer['uuid']}");

if ($delete->status() === 409) {
    match ($delete->json('error.code')) {
        'customer_has_funds'   => 'сначала выведите остатки',
        'customer_has_wallets' => 'у клиента есть адреса или история движений',
        'customer_blocked'     => 'блокировка снимается комплаенс-офицером',
    };
}

import os, requests

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

# Создание идемпотентно по external_id, затем по телефону
r = requests.post(f'{B}/customers', headers=H, json={
    'name': 'Иван Петров',
    'phone': '+79001234567',
    'external_id': 'user-42',
})
r.raise_for_status()
customer, created = r.json()['data'], r.status_code == 201

# Точный поиск по телефону
found = requests.get(f'{B}/customers', headers=H,
                     params={'filter[phone]': '+79001234567'}).json()['data']

# История по курсору
def history(uuid, per_page=100):
    cursor = None
    while True:
        params = {'per_page': per_page}
        if cursor:
            params['starting_after'] = cursor
        body = requests.get(f'{B}/customers/{uuid}/transactions',
                            headers=H, params=params).json()
        yield from body['data']
        if not body['meta']['has_more']:
            return
        cursor = body['meta']['next_cursor']