Yatırmayı getir

API anahtarı: Payment

Tek bir yatırmayı pcd_ kimliğiyle, her durumda okuyun. payment_channel.deposit.confirming webhook'undan öğrendiğiniz kimlik burada anında çözülür; yalnızca sonradan sorgulayabilmek için webhook yükünü saklamanız gerekmez.

Yanıt (200 OK)

{
  "id": "pcd_8ScRvL4jNq2XkB7mTfZdWu",
  "payment_channel_id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
  "project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
  "payment_channel_external_id": "customer-42",
  "status": "confirmed",
  "is_final": true,
  "is_test": false,
  "currency": "USDT",
  "network": "TRC20",
  "chain_id": 728126428,
  "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "gross": "100",
  "fee": "1",
  "net": "99",
  "applied_fee_percent": 1.0,
  "customer_fee_percent": 0,
  "tx_hash": "9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25",
  "transfer_id": "9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25:41a614f803b6fd780986a42c78ec9c7f77e6ded13c:41c9f6a2b7d0138e54ca3b91f6072ed48a5c1e93b7:0",
  "source_address": "TW9s4RkAqBnLpVdX2ChYzUeGm7QfKt3NbZ",
  "destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "block_height": 68421905,
  "first_included_block_timestamp": 1767225900,
  "explorer_url": "https://tronscan.org/#/transaction/9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25",
  "created_at": 1767225870,
  "updated_at": 1767225930,
  "confirmed_at": 1767225930
}

Alanlar

Alan	Anlamı
id	Yatırma kimliği (pcd_…). Yinelenenleri bunun üzerinden ayıklarsınız.
payment_channel_id, payment_channel_external_id	Parayı alan kanal ve o kanala verdiğiniz kimlik.
status	confirming, reorged veya confirmed.
is_final	Yalnızca confirmed için true.
currency, network, chain_id, contract_address	Gelen token ve nereye geldiği. contract_address, token'ın zincir üzerindeki kimliğidir: EVM ve Tron'da kontrat adresi, TON'da jetton master, Solana'da SPL mint.
gross, fee, net	Ondalık dizeler. Bakiyenize ulaşan tutar net.
applied_fee_percent, customer_fee_percent	Bu yatırma için, kanala işlendiği anda dondurulan oranlar.
tx_hash, transfer_id, block_height	Zincir üstü kanıt. transfer_id opaktır — eşleştirin, ayrıştırmayın.
source_address	Zincir bu bilgiyi veriyorsa müşterinin adresi; aksi hâlde bulunmaz.
destination_address	Paranın ulaştığı kanal adresi.
first_included_block_timestamp	İşlemin bir blokta ilk göründüğü an.
explorer_url	O ağ için varsa blok gezginindeki bağlantı.
confirmed_at	Yatırma confirmed durumuna ulaştığında bir kez ayarlanır.

Şemada contract_address isteğe bağlıdır ve yalnızca yerel bir coin'de boş kalır. Kabul edilen varlıklar arasında yerel coin yok; dolayısıyla okuyabildiğiniz her yatırmada bu alan dolu gelir. Aynı kuralı payment.contract_address için GET /v1/invoices/:id anlatır — iki kaynağı tek kod yolu karşılar.

Yatırma durumları

Durum	Anlamı	Nihai
confirming	Zincirde görüldü, ağın gerektirdiği onayları bekliyor	Hayır
reorged	İşlem, zincirin yeniden düzenlenmesiyle (reorg) düştü	Hayır
confirmed	Kesinleşti. Net tutar bakiyenize geçer	Evet

confirmed geri dönüşsüzdür: bir yatırma oraya ulaştıktan sonra hiçbir şey onu geri çevirmez. reorged ise durağandır ama nihai değildir — aynı işlem sonraki bir blokta yeniden yer alırsa aynı yatırma confirming durumuna döner ve onaya kadar gidebilir. Bu süre boyunca pcd_ kimliğini korur; bu yüzden tek bir ödeme için asla ikinci bir yatırma görmezsiniz.

Başarısız durum yoktur. Reorg'a uğrayıp bir daha zincire dahil edilmeyen bir yatırma yalnızca reorged olarak kalır.

Para kaydedilir, yeniden hesaplanmaz

applied_fee_percent ve customer_fee_percent, yatırma kanala işlendiğinde alınmış bir anlık görüntüdür. Fiyatlandırmanızı sonradan değiştirmek, hâlihazırda var olan bir yatırmayı değiştirmez; eski bir yatırmayı yeniden okuduğunuzda hep taşıdığı gross, fee ve net değerleri döner.

Onaylanmış bir production yatırmasında bu üç tutar, bakiyenizi alacaklandıran muhasebe kaydından geri okunur — ekstrenizdeki sayıların aynısıdır, yeniden hesaplama değil. %1'lik oranda 100 USDT'lik bir yatırma gross 100, fee 1, net 99 bildirir.

Tutarlar, sondaki sıfırları kırpılmış ondalık dizelerdir. Ondalık bir tiple ayrıştırın; ikili kayan nokta, stablecoin ölçeğinde hassasiyet kaybeder.

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_deposit_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 pcd_ kimliği değil.

Tam katalog için bkz. Hata Kodları.