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 |
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) |