# Ö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

```bash
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:

```json
{
   "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:

```json
{
   "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 |