KYB Verification (Companies)

# Полный sandbox-flow

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

# 1. Создать компанию
UUID=$(curl -s -X POST $B/companies \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"ООО Тест","tax_number":"7707083893","country_iso":"RU"}' \
  | jq -r .data.uuid)

# 2. Заполнить реквизиты
curl -X PATCH $B/companies/$UUID \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "registration_number": "1027700132195",
    "kpp": "770701001",
    "legal_address": "г. Москва, ул. Тверская, д. 1",
    "bank_name": "ПАО Сбербанк",
    "bank_bik": "044525225",
    "bank_account": "40702810000000000001",
    "bank_currency": "RUB",
    "director_full_name": "Иванов И.И.",
    "director_birth_date": "1980-01-15",
    "director_document_type": "passport",
    "director_document_number": "4501123456",
    "director_email": "dir@example.com",
    "accountant_name": "Петрова А.С.",
    "accountant_birth_date": "1985-04-10",
    "accountant_email": "acc@example.com",
    "compliance_sanctions": true,
    "compliance_terrorism": true,
    "compliance_funds_origin": true,
    "pd_consent_given": true
  }'

# 3. Добавить бенефициара
curl -X POST $B/companies/$UUID/beneficiaries \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"full_name":"Иванов И.И.","birth_date":"1980-01-15","ownership_percentage":100,"is_pep":false}'

# 4. Загрузить документ (повторить для всех 12 типов)
curl -X POST $B/companies/$UUID/documents \
  -H "Authorization: Bearer $KEY" \
  -F "type=charter" \
  -F "file=@/path/to/charter.pdf"

# 5. Submit
curl -X POST $B/companies/$UUID/submit \
  -H "Authorization: Bearer $KEY"

# 6. Проверить статус
curl -X GET $B/companies/$UUID \
  -H "Authorization: Bearer $KEY"

class FinosKyb {
  constructor(secret) {
    this.base = 'https://fin-os.io/api/v1';
    this.headers = { 'Authorization': `Bearer ${secret}`, 'Accept': 'application/json' };
  }

  async createDraft(initial) {
    const r = await fetch(`${this.base}/companies`, {
      method: 'POST',
      headers: { ...this.headers, 'Content-Type': 'application/json' },
      body: JSON.stringify(initial),
    });
    return (await r.json()).data;
  }

  async update(uuid, fields) {
    const r = await fetch(`${this.base}/companies/${uuid}`, {
      method: 'PATCH',
      headers: { ...this.headers, 'Content-Type': 'application/json' },
      body: JSON.stringify(fields),
    });
    return (await r.json()).data;
  }

  async uploadDoc(uuid, type, file) {
    const form = new FormData();
    form.append('type', type);
    form.append('file', file);
    const r = await fetch(`${this.base}/companies/${uuid}/documents`, {
      method: 'POST', headers: this.headers, body: form,
    });
    return (await r.json()).data;
  }

  async submit(uuid) {
    const r = await fetch(`${this.base}/companies/${uuid}/submit`, {
      method: 'POST', headers: this.headers,
    });
    if (!r.ok) throw new Error((await r.json()).errors?.documents?.[0] || 'submit failed');
    return (await r.json()).data;
  }
}

use Illuminate\Support\Facades\Http;

class FinosKybClient
{
    public function __construct(private string $secret) {}

    private function http()
    {
        return Http::withToken($this->secret)
            ->acceptJson()
            ->baseUrl('https://fin-os.io/api/v1');
    }

    public function createDraft(array $initial): array
    {
        return $this->http()->post('/companies', $initial)->json('data');
    }

    public function update(string $uuid, array $fields): array
    {
        return $this->http()->patch("/companies/{$uuid}", $fields)->json('data');
    }

    public function addBeneficiary(string $uuid, array $data): array
    {
        return $this->http()->post("/companies/{$uuid}/beneficiaries", $data)->json('data');
    }

    public function uploadDocument(string $uuid, string $type, string $path): array
    {
        return Http::withToken($this->secret)
            ->attach('file', file_get_contents($path), basename($path))
            ->post("https://fin-os.io/api/v1/companies/{$uuid}/documents", ['type' => $type])
            ->json('data');
    }

    public function submit(string $uuid): array
    {
        $r = $this->http()->post("/companies/{$uuid}/submit");
        $r->throw();
        return $r->json('data');
    }
}

import requests, os

class FinosKyb:
    def __init__(self, secret):
        self.base = 'https://fin-os.io/api/v1'
        self.h = {'Authorization': f'Bearer {secret}'}

    def create_draft(self, initial):
        r = requests.post(f'{self.base}/companies', headers=self.h, json=initial)
        r.raise_for_status()
        return r.json()['data']

    def update(self, uuid, fields):
        r = requests.patch(f'{self.base}/companies/{uuid}', headers=self.h, json=fields)
        r.raise_for_status()
        return r.json()['data']

    def add_beneficiary(self, uuid, data):
        return requests.post(f'{self.base}/companies/{uuid}/beneficiaries',
                             headers=self.h, json=data).json()['data']

    def upload_document(self, uuid, doc_type, file_path):
        with open(file_path, 'rb') as f:
            r = requests.post(
                f'{self.base}/companies/{uuid}/documents',
                headers=self.h,
                data={'type': doc_type},
                files={'file': f},
            )
        r.raise_for_status()
        return r.json()['data']

    def submit(self, uuid):
        r = requests.post(f'{self.base}/companies/{uuid}/submit', headers=self.h)
        r.raise_for_status()
        return r.json()['data']

# Usage
kyb = FinosKyb(os.environ['FINOS_SANDBOX_KEY'])
company = kyb.create_draft({'name': 'ООО Тест', 'tax_number': '7707083893'})
print('Created:', company['uuid'])