Ödemeleri listele

Genel bakış

Hizmet, kripto cüzdanlarınıza gelen tüm ödemeleri otomatik olarak bulur; ancak yalnızca araması etkin faturalar varken. Arama, fatura ödenmemişken sürer ve ödeme süresinden sonra bir saat daha devam eder — bu, yavaş ağlar içindir. Böyle faturalar yoksa gelen işlem sisteme girmez.

İstek

curl -X POST https://api.bitsby.app/payments/list \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "startDate=2000-01-01" \
	-F "endDate=2030-01-01" \
	-F "offset=0" \
	-F "limit=10"

İstek parametreleri

Parametre	Veri türü	Açıklama	Örnek	Zorunlu mu?	Varsayılan
walletId	UUID	UUID biçiminde cüzdan ID'si	1c48b092-9878-48f5-b441-07a8a48e7b54	hayır
invoiceId	UUID	UUID biçiminde fatura ID'si	1c48b092-9878-48f5-b441-07a8a48e7b54	hayır
startDate	String	On-chain işlemin başlangıç tarihi, Y-m-d biçiminde	2000-01-01	hayır
endDate	String	On-chain işlemin bitiş tarihi, Y-m-d biçiminde	2030-01-01	hayır
offset	Integer	Döndürülecek ilk kaydın dizini	0	hayır	0
limit	Integer	Almak istediğiniz kayıt sayısı	50	hayır	10

Yanıt örneği

Bir faturayla zaten eşleşmiş bir ödeme:

{
   "result":"success",
   "data":[
      {
         "id":"f986ad8d-2298-473d-982a-efbc817b975d",
         "amount":12,
         "hash":"f09352627039c088688806821b864895ff237558612d834861621fc026de5f68",
         "transactionDatetime":"2024-02-27 21:05:36",
         "invoice":{
            "id":"f31c61f6-407f-4999-95cf-56477eff06d4",
            "uid":"riUZBnNvd2rX",
            "projectId":"9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "createDatetime":"2024-02-27 20:57:23",
            "timeToPayDatetime":"2024-02-28 08:57:23",
            "commissionFiatUSD":0.12,
            "amountFiatUSD":12,
            "amountFiat":12,
            "currencyFiat":"USD",
            "description":null,
            "serviceData":"orderId:2444",
            "views":1,
            "status":"paid"
         },
         "wallet":{
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
         }
      },
      {
         "id":"f3195184-9a6f-4c82-928b-d7fe7c015b7b",
         "amount":5.02,
         "hash":"74763b65e43bcc9492a6ce9a7f26fbfdbd7635aecd3454420b5e9534cba50ee6",
         "transactionDatetime":"2024-02-26 13:32:57",
         "invoice":{
            "id":"fac8ef03-2c41-4ce0-a432-7c33b928f16f",
            "uid":"AFhygKX21ecd",
            "projectId":"9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "createDatetime":"2024-02-26 13:29:24",
            "timeToPayDatetime":"2024-02-27 01:29:24",
            "commissionFiatUSD":0.05,
            "amountFiatUSD":5.02, 
            "amountFiat":5,
            "currencyFiat":"USD",
            "description":null,
            "serviceData":"orderId:3419",
            "views":3,
            "status":"paid"
         },
         "wallet":{
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
         }
      }
   ]
}

Hizmetin bulduğu ama henüz bir faturayla eşleştirilmemiş bir ödeme, invoice bloğu olmadan gelir. Bu ödemeler, manuel eşleştirmenin adaylarıdır:

{
   "result":"success",
   "data":[
      {
         "id":"c1d0f4a2-93b7-4f61-8c25-1a6f0e2b7d94",
         "amount":9.87,
         "hash":"5b1e4b1cf0a4c3d2e9f6a7b8c9d0e1f2a3b4c5d6e7f8091a2b3c4d5e6f708192",
         "transactionDatetime":"2024-02-28 09:14:02",
         "wallet":{
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
         }
      }
   ]
}

Yanıt parametreleri

Parametre	Açıklama
id	UUID biçiminde ödeme ID'si
amount	Kripto para cinsinden ödeme tutarı
hash	On-chain işlemin hash'i
transactionDatetime	On-chain işlemin tarihi ve saati (UTC)
invoice	Fatura parametrelerini içeren blok. Ödemeyle bir fatura eşleştirilmişse bulunur
invoice.id	UUID biçiminde fatura ID'si
invoice.uid	Fatura ID'si (alıcı için)
invoice.projectId	UUID biçiminde proje ID'si
invoice.createDatetime	Faturanın oluşturulma tarihi ve saati (UTC)
invoice.timeToPayDatetime	Faturanın geçerli olduğu son tarih ve saat (UTC)
invoice.commissionFiatUSD	Hizmet ücreti tutarı. invoice.amountFiatUSD tutarından hesaplanır
invoice.amountFiatUSD	USD'ye dönüştürülmüş fatura tutarı. Fatura oluşturulurken invoice.amountFiat değerinden güncel kura göre hesaplanır. Ödeme anında üzerine, o andaki kurla USD'ye dönüştürülerek fiilen alınan tutar yazılır. invoice.commissionFiatUSD içindeki ücret de bundan yeniden hesaplanır
invoice.amountFiat	Faturanın itibari para cinsinden orijinal tutarı. Değişmez
invoice.currencyFiat	İtibari para birimi
invoice.description	Fatura oluşturulurken ayarlanan açıklama
invoice.serviceData	Fatura oluşturulurken ayarlanan hizmet verisi
invoice.views	Ödeme sayfası görüntülenme sayısı
invoice.status	Fatura durumu
wallet	Cüzdan parametrelerini içeren blok
wallet.id	UUID biçiminde cüzdan ID'si
wallet.name	Cüzdan adı
wallet.blockchain	Kripto cüzdanının blockchain'i
wallet.cryptocurrency	Cüzdanın kripto parası
wallet.address	Kripto cüzdanının adresi