vellTRDocs
API Referansına DönİşlemlerKayıt Dışa Aktarımı Kuyruğa Al

Kayıt Dışa Aktarımı Kuyruğa Al

POST/v1/transactions/exportsOptional

Filtrelenmiş işlemlerin PDF veya CSV dışa aktarımını kuyruğa alır. Tamamlanma durumunu dönen exportId üzerinden sorgulayın.

Kimlik Doğrulama

İmza Deseni

HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/transactions/exports\n{sha256(body)}")
BaşlıkDeğerAçıklama
X-Api-Keypk_live_a1b2c3d4e5f6g7h8Merchant public API key
X-Signature{hmac_sha256_hex}Hex HMAC-SHA256 request signature
X-Timestamp2026-04-13T10:00:00ZISO 8601 UTC request time (±5 min)

İstek Parametreleri

AdTürZorunluAçıklama
formatstringZorunlu"pdf" or "csv"
filtersobjectİsteğe BağlıSame filters as list: {storeId?, status?, from?, to?, amountMin?, amountMax?, customerId?, paymentId?}

İstek Örneği

JSONİstek Gövdesi
{
  "format": "csv",
  "filters": {
    "from": "2026-04-01T00:00:00Z",
    "to": "2026-04-30T23:59:59Z",
    "status": "captured"
  }
}

Yanıt Parametreleri

AlanTürÖrnek
exportIdstring"exp_3c4d5e6f7081"
statusstring"queued"

Yanıt Örneği

JSONYanıt
{
  "exportId": "exp_3c4d5e6f7081",
  "status": "queued"
}

Durum Kodları

200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
POSThttps://api.pay.sandbox.kvell.group