Getir

API anahtarı: Payment

Tek bir kanalı pc_ kimliğiyle okuyun. Müşteriye parayı nereye göndereceğini göstermeden önce yapılacak çağrı budur: her ağın güncel adresini ve o ağın şu anda kabul ettiği token'ları döndürür.

Yanıt (200 OK)

{
  "id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
  "project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
  "external_id": "customer-42",
  "status": "active",
  "is_accepting_payments": true,
  "is_fully_provisioned": false,
  "is_test": false,
  "applied_fee_percent": 1.0,
  "customer_fee_percent": 0,
  "networks": [
    {
      "network": "TRC20",
      "status": "active",
      "address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
      "tokens": [
        { "symbol": "USDT", "minimum_deposit": "1.00" },
        { "symbol": "USDC", "minimum_deposit": "1.00" }
      ]
    },
    {
      "network": "ERC20",
      "status": "active",
      "address": "0x9f2a6c1b4e8d7350ab11c9e5f0d2743b86ce41d9",
      "tokens": [
        { "symbol": "USDT", "minimum_deposit": "12.00" },
        { "symbol": "USDC", "minimum_deposit": "12.00" }
      ]
    },
    {
      "network": "SOL",
      "status": "provisioning",
      "tokens": [
        { "symbol": "USDC", "minimum_deposit": null }
      ]
    }
  ],
  "created_at": 1767225600,
  "updated_at": 1767225780
}

Kanal durumları

Durum	Anlamı	Yatırma kabul eder
provisioning	Oluşturuldu, henüz hazır adres yok	Hayır
active	En az bir adres var	Evet
blocked	Kanalı siz duraklattınız	Hayır

active tek yönlüdür. Bir kanal ilk adresini ürettikten sonra kendiliğinden provisioning durumuna dönmez; kalan ağlar arka planda ilerler ve hazır oldukça yanıtta görünür. Başarısız durum yoktur: hazırlık, başarılı olana kadar yeniden denenir.

Arayüzünüzde koşul kuracağınız tek bayrak is_accepting_payments değeridir. Yalnızca proje aktifse, kanal engellenmemişse ve en az bir ağın hem adresi hem de kabul edilen bir token'ı varsa true olur.

Adresler kalıcıdır

Bir kanal için verilen adres sonsuza dek o kanala aittir ve başka kimseye yeniden atanmaz. Önbelleğe alın; her sayfa görüntülemesinde yeniden çekmeyi bırakın.

Değişen iki şey vardır ve entegrasyonunuz onları izlemelidir:

• —Ağ başına token'lar. Projede bir token'ı etkinleştirmek veya kapatmak tokens dizisini değiştirir. Yalnızca listelenmiş olanı gösterin.
• —Hangi ağların göründüğü. Bir ağın tüm token'larını projeden kaldırmak, o ağı yanıttan çıkarır. Adresin kendisi silinmez — token'ı yeniden etkinleştirdiğinizde aynı adres geri gelir — ama API'nin artık döndürmediği bir rotayı sunmayı bırakın.

Minimum, ağ ve token'a göre değişir

tokens içindeki kayıt bir nesnedir, token kodu değil:

Alan	Anlamı
symbol	Token kodu, örneğin USDT.
minimum_deposit	Token'ın kendi biriminde ondalık dize. Hesaba geçen en küçük transfer.

Minimum hem token'a hem ağa birlikte bağlıdır ve aralığın iki ucu arasında kat kat fark vardır: aynı token, kullanımı kuruşluk olan bir zincirde başka, dolarlık olan bir zincirde başka sınırlanır. Değer her okumada yeniden alınır; bu yüzden gösterdiğiniz yanıttan okuyun, kodunuza sabit yazmayın.

Minimumun altındaki bir transfer kanala geçmez ve kendiliğinden geri de dönmez. Bu sayıyı adresin yanında gösterin.

minimum_deposit, o rota için şu anda bir minimum verilemediğinde null olur. Bu, minimumu olmayan bir rota demek değildir: o rotada güvenli olduğu bilinen bir tutar da yoktur, dolayısıyla bir sayı dönene kadar oradan ödeme istemeyin. null değerini sıfır saymak, hiçbir şekilde hesaba geçirilemeyecek bir ödeme almanın en kısa yoludur.

Komisyonlar güncel değerdir, geçmiş değil

applied_fee_percent ve customer_fee_percent, bugünkü fiyatlandırmanızı anlatır; bilgi amaçlıdır. Belirli bir ödeme için bağlayıcı sayılar, o ödemeyi kaydeden yatırmanın üzerindedir: kendi dondurulmuş oranlarını ve kendi gross, fee ve net değerlerini taşır. Bkz. Kanal Yatırması Getir.

Hatalar

Kod	HTTP	Ne zaman
payment_channels_disabled	503	Ödeme kanalları, bu ortamda hesabınız için etkin değil.
payment_key_required	403	İstek, Payout (rk_) anahtarıyla imzalandı.
payment_channel_not_found	404	Kimlik, bu kimlik bilgisinin görebileceği hiçbir şeye çözülmüyor.
field_invalid_format	400	Yol parçası geçerli bir pc_ kimliği değil.

Başka bir satıcıya, başka bir ortama veya kimlik bilginizin kapsamı dışındaki bir projeye ait kanal payment_channel_not_found yanıtı verir — hiç var olmayan bir kanalla birebir aynı. API, göstermeyeceği şeyin varlığını asla doğrulamaz.

Tam katalog için bkz. Hata Kodları.