Faturaları Listele
GET
/v1/invoicesOptionalKeyset sayfalama ile faturaları listeler. Filtreler: storeId, status.
Kimlik Doğrulama
İmza Deseni
HMAC-SHA256(secretKey, "{timestamp}\nGET\n/v1/invoices\n{sha256(\"\")}")| Başlık | Değer | Açıklama |
|---|---|---|
X-Api-Key | pk_live_a1b2c3d4e5f6g7h8 | Merchant public API key |
X-Signature | {hmac_sha256_hex} | Hex HMAC-SHA256 request signature |
X-Timestamp | 2026-04-13T10:00:00Z | ISO 8601 UTC request time (±5 min) |
İstek Parametreleri
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
storeId | string | İsteğe Bağlı | Filter by store |
status | string | İsteğe Bağlı | draft|sent|activated|viewed|paid|expired|cancelled |
limit | integer | İsteğe Bağlı | Page size |
cursor | string | İsteğe Bağlı | Opaque keyset cursor |
Yanıt Parametreleri
| Alan | Tür | Örnek |
|---|---|---|
items | array | […] |
items[].id | string | "inv_7a8b9c0d1e2f" |
items[].storeId | string | "sto_5a6b7c8d" |
items[].status | string | "sent" |
items[].amountMinor | integer | 50000 |
items[].currency | string | "TRY" |
items[].createdAt | string | "2026-04-13T10:00:00Z" |
nextCursor | string | "eyJjcmVhdGVkQXQiOiIyMDI2LTA0LTEzVDEwOjAw… |
Yanıt Örneği
JSONYanıt
{
"items": [
{
"id": "inv_7a8b9c0d1e2f",
"storeId": "sto_5a6b7c8d",
"status": "sent",
"amountMinor": 50000,
"currency": "TRY",
"createdAt": "2026-04-13T10:00:00Z"
}
],
"nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTA0LTEzVDEwOjAwOjAwWiJ9"
}Durum Kodları
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
GEThttps://api.pay.sandbox.kvell.group