> ## Documentation Index
> Fetch the complete documentation index at: https://whalescorp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Особенности учета USDC

## Номинация invoice

Invoices номинируются в **USDC**, примерно \$1.00 USD, с peg, поддерживаемым Circle.

Рекомендуемые колонки, часть уже реализована:

```text theme={null}
subtotal_usdc   NUMERIC(18,6)   -- primary
subtotal_usd    NUMERIC(18,6)   -- USD equivalent (planned)
rate_at_invoice NUMERIC(12,6)   -- USD/USDC at issuance (planned)
rate_source     TEXT            -- 'circle_api' | 'assumed_peg' (planned)
```

## Settlement-документы в валютах, отличных от USD

Settlement statements, см. §2.5, требуют FX conversion, если merchant работает в валюте, отличной от USD. Следует хранить:

```text theme={null}
face_value_usdc     NUMERIC(18,6)   -- always in USDC
settlement_currency TEXT            -- e.g. 'EUR'
fx_rate             NUMERIC(12,6)   -- USDC → settlement_currency at settlement date
fx_rate_source      TEXT            -- 'ecb', 'coinbase', 'manual'
amount_due          NUMERIC(18,6)   -- face_value_usdc × fx_rate, in settlement_currency
```

Это authoritative amount, то есть итоговая сумма, которую merchant должен заплатить. FX rate фиксируется в момент **выпуска** settlement statement, а не в момент оплаты, что защищает обе стороны от rate drift в течение платежного окна.

## Признание выручки

Согласно guidance от IRS, включая `Notice 2014-21` и `Rev. Rul. 2023-14`:

* полученный USDC = ordinary income по FMV на момент получения
* FMV для USDC ≈ \$1.0000, это тривиально, но все равно должно быть задокументировано
* для каждой collected entry в `fee_ledger` следует хранить `usdc_rate_at_collection` и `usd_fmv`, это запланировано\\

## On-chain подтверждение оплаты

`fee_ledger.collection_tx_hash` и `merchant_settlements.payment_ref`, то есть Solana tx sig для crypto payments, являются неизменяемыми подтверждениями оплаты. Их можно проверить через [solscan.io](http://solscan.io).

## Инструкции по оплате invoice

```text theme={null}
Payment Network: Solana (Mainnet)
Payment Token: USDC (SPL)
Payment Address: [platform USDC wallet]
Memo: [invoice_number or settlement_number]
Amount: [total_usdc] USDC
Rate Source: Circle USD/USDC (at invoice date)
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.