Virtual Cards

# Выпустить виртуальную карту для customer'а
curl -X POST https://fin-os.io/api/v1/customers/$UUID/cards \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Ivan", "last_name": "Petrov", "email": "ivan@example.com"}'

# Список карт customer'а
curl https://fin-os.io/api/v1/customers/$UUID/cards \
  -H "Authorization: Bearer sk_test_..."

# Детали одной карты
curl https://fin-os.io/api/v1/customers/$UUID/cards/$CARD_ID \
  -H "Authorization: Bearer sk_test_..."

# Пополнить карту со счёта площадки (RUB)
curl -X POST https://fin-os.io/api/v1/customers/$UUID/cards/$CARD_ID/topup \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"amount": "1500.00"}'

const FINOS_API = 'https://fin-os.io/api/v1';
const SECRET    = process.env.FINOS_SECRET_KEY; // sk_test_ или sk_live_
const H = { 'Authorization': `Bearer ${SECRET}`, 'Content-Type': 'application/json' };

// Выпустить виртуальную карту
async function issueCard(uuid, profile = {}) {
  const res = await fetch(`${FINOS_API}/customers/${uuid}/cards`, {
    method: 'POST',
    headers: H,
    body: JSON.stringify(profile), // { first_name, last_name, patronymic, birth_date, email }
  });
  if (res.status === 503) throw new Error('Card issuance not enabled yet');
  const { data } = await res.json();
  return data; // { id, status, masked_pan, balance, currency, markup, ... }
}

// Список карт
async function listCards(uuid) {
  const res = await fetch(`${FINOS_API}/customers/${uuid}/cards`, { headers: H });
  return (await res.json()).data;
}

// Пополнить карту (RUB, строкой до 2 знаков)
async function topupCard(uuid, cardId, amount) {
  const res = await fetch(
    `${FINOS_API}/customers/${uuid}/cards/${cardId}/topup`,
    { method: 'POST', headers: H, body: JSON.stringify({ amount }) }
  );
  if (res.status === 503) throw new Error('Card top-up not enabled yet');
  return (await res.json()).data; // { status: 'accepted', amount, currency, card_id, pricing }
}

use Illuminate\Support\Facades\Http;

class FinosCards
{
    private string $base = 'https://fin-os.io/api/v1';

    public function __construct(private string $secretKey) {} // sk_test_ или sk_live_

    /** Выпустить виртуальную карту. */
    public function issue(string $customerUuid, array $profile = []): array
    {
        return Http::withToken($this->secretKey)
            ->post("{$this->base}/customers/{$customerUuid}/cards", $profile)
            ->throw()
            ->json('data');
    }

    /** Все карты customer'а. */
    public function list(string $customerUuid): array
    {
        return Http::withToken($this->secretKey)
            ->get("{$this->base}/customers/{$customerUuid}/cards")
            ->json('data');
    }

    /** Пополнить карту (amount — строка RUB до 2 знаков). */
    public function topup(string $customerUuid, string $cardId, string $amount): array
    {
        return Http::withToken($this->secretKey)
            ->post("{$this->base}/customers/{$customerUuid}/cards/{$cardId}/topup", [
                'amount' => $amount,
            ])
            ->throw()
            ->json('data');
    }
}

import requests, os

FINOS = 'https://fin-os.io/api/v1'
KEY   = os.environ['FINOS_SECRET_KEY']  # sk_test_ или sk_live_
H     = {'Authorization': f'Bearer {KEY}'}

def issue_card(uuid, profile=None):
    r = requests.post(
        f'{FINOS}/customers/{uuid}/cards', headers=H, json=profile or {}
    )
    if r.status_code == 503:
        raise RuntimeError('Card issuance not enabled yet')
    r.raise_for_status()
    return r.json()['data']

def list_cards(uuid):
    r = requests.get(f'{FINOS}/customers/{uuid}/cards', headers=H)
    r.raise_for_status()
    return r.json()['data']

def topup_card(uuid, card_id, amount):
    # amount — строка RUB до 2 знаков, напр. '1500.00'
    r = requests.post(
        f'{FINOS}/customers/{uuid}/cards/{card_id}/topup',
        headers=H, json={'amount': amount},
    )
    if r.status_code == 503:
        raise RuntimeError('Card top-up not enabled yet')
    r.raise_for_status()
    return r.json()['data']

# usage
card = issue_card(customer_uuid, {'first_name': 'Ivan', 'email': 'ivan@example.com'})
print('Card:', card['id'], card['masked_pan'])
topup_card(customer_uuid, card['id'], '1500.00')