# Referanslar

> 2328.io API'sinde kullanılan ağ kodları, para birimi-ağ eşlemeleri ve ödeme durum değerleri.

Bu sayfa, API istek ve yanıtlarında kullanılan tüm referans değerlerini listeler.

## Ağ kodları

Bu kodlar, `network` alanının bulunduğu her yerde kullanılır:

| Kod | Ağ |
|-----|-----|
| `TRX-TRC20` | Tron TRC-20 |
| `BSC-BEP20` | BNB Smart Chain |
| `ETH-ERC20` | Ethereum (ERC-20) |
| `BASE` | Base |
| `AVAX-C` | Avalanche C-Chain |
| `POL-MATIC` | Polygon (Matic) |
| `TON` | TON |
| `BTC` | Bitcoin |
| `LTC` | Litecoin |
| `DASH` | Dash |
| `SOL` | Solana |
| `DOGE` | Dogecoin |
| `ZEC` | Zcash |
| `XRP` | XRP Ledger |
| `XMR` | Monero |

## Para birimi-ağ eşlemesi

Her para birimi yalnızca bir alt küme ağda kullanılabilir. Geçerli bir kombinasyon seçmek için bu tabloyu kullanın:

| Para birimi | İzin verilen ağlar |
|-------------|--------------------|
| `USDT` | TRX-TRC20, BSC-BEP20, ETH-ERC20, BASE, AVAX-C, POL-MATIC, TON, SOL |
| `USDC` | BSC-BEP20, ETH-ERC20, BASE, AVAX-C, POL-MATIC, SOL |
| `BTC` | BTC |
| `ETH` | ETH-ERC20, BASE |
| `BNB` | BSC-BEP20 |
| `TRX` | TRX-TRC20 |
| `LTC` | LTC |
| `DASH` | DASH |
| `GRAM` | TON |
| `AVAX` | AVAX-C |
| `POL` | POL-MATIC |
| `SOL` | SOL |
| `DOGE` | DOGE |
| `ZEC` | ZEC |
| `XRP` | XRP |
| `XMR` | XMR |

`GRAM`, TON yerel para birimi için kanonik varlık kodudur. Ödeme, statik-cüzdan ve ödeme oluşturma API’leri şu anda eski `TON` girişini kabul eder ve bunu `GRAM` olarak normalize eder; entegrasyonlar API tarafından döndürülen kanonik değeri saklamalı ve işlemede kullanmalıdır. Polygon’un yerel varlığı `POL` iken, ağ kodu `POL-MATIC`’dir. Ağ kodu olarak `MATIC` gönderilmemelidir.

Etkin yönler, operasyonel yapılandırmadır ve bu katalogdan bağımsız olarak değişebilir. Seçenekleri sunmadan önce `/v1/directions` sorgulayın; bu tabloyu geçerli kod haritası olarak kabul edin, her çiftin şu anda etkin olduğuna dair bir garanti olarak değil.

## Ödeme durumları

Ödemelerdeki `payment_status` alanı ve `/v1/payment/list` filtresi aşağıdaki değerleri alır:

| Durum | Açıklama |
|-------|----------|
| `pending` | Oluşturuldu, başlatılmayı bekliyor |
| `check` | Müşteriden ödeme bekleniyor |
| `paid` | Başarıyla ödendi |
| `underpaid_check` | Eksik ödendi (yükleme yapılabilir) |
| `underpaid` | Eksik ödendi |
| `overpaid` | Fazla ödendi (alacaklandırıldı) |
| `cancel` | İptal edildi / süresi doldu |
| `aml_lock` | AML nedeniyle işlem bloke edildi |

> **INFO:** Başarılı bir ödemeyi dinlerken hem `paid` hem de `overpaid` durumlarını başarılı olarak değerlendirmeli ve müşterinin siparişini alacaklandırmalısınız.

### Durum işleme politikası

| Durum | Siparişi yerine getir? | Beklemeye devam et? | Operasyonel işlem |
|--------|----------------|-------------------|--------------------|
| `pending` / `check` | Hayır | Evet, sona kadar | Bekleyen durumu göster ve normal şekilde mutabakat yap. |
| `underpaid_check` | Varsayılan olarak hayır | Evet, ek ödeme gelebilir | Her txid'yi idempotent olarak sakla ve kalan ödeme iş akışını göster. |
| `paid` | Evet, bir kez | Hayır | Doğrulanmış olaydan atomik olarak yerine getir. |
| `overpaid` | Evet, bir kez | Hayır | merchant politikası için fazla/gerçek tutarları yerine getir ve sakla. |
| `underpaid` | Ürüne özel | Hayır | Açık kısmi ödeme/manuel inceleme politikasını uygula. |
| `cancel` | Hayır | Hayır | Süresi dolmuş/iptal edilmiş olarak işaretle, ancak sonraki zincir üzeri kanıtları yükselt. |
| `aml_lock` | Hayır | Otomatik yerine getirme yok | Uyumluluk/destek incelemesi; değeri otomatik olarak serbest bırakmayın. |

Durumlar, platformun ödeme hakkındaki görüşünü tanımlar. Bunlar, yerel yerine getirme durumunuzun yerine geçmez. Hem geri ödenmiş, hem manuel olarak incelenmiş, hem de zaten yerine getirilmiş siparişin eski bir webhook tarafından bozulmasını önlemek için her ikisini de saklayın.

`/v1/payment/list` istek filtresi şu anda `pending`, `check`, `paid`, `underpaid_check`, `underpaid`, `overpaid` ve `cancel`’yi kabul etmektedir. AML kilitli bir ödeme diğer ödeme uç noktaları tarafından iade edilebilse de `aml_lock` filtresi olarak kabul edilmez.

## Çekim durumları

`/v1/payout` ve `/v1/payout/status/{uuid}` üzerindeki `status` alanı şu değerlerden birini alır:

| Durum | Açıklama |
|-------|----------|
| `pending` | Oluşturuldu, işlenmeyi bekliyor |
| `completed` | Başarıyla tamamlandı — `txid` ayarlandı |
| `failed` | Gönderim hatası — bkz. `error_type` |
| `cancelled` | İptal edildi |

## Çekim hata türleri

Bir çekim `status = failed` olduğunda `error_type` alanı nedeni açıklar:

| Kod | Açıklama |
|-----|----------|
| `aml_risk` | Çekim AML risk kontrolleri tarafından engellendi (alıcı adres yüksek riskli olarak işaretlendi) |