vellTRDocs
API Referansına DönİşlemlerKart Erişim Denetimi

Kart Erişim Denetimi

GET/v1/transactions/card-accessOptional

Üye işyeri kapsamındaki card-vault denetim kayıtları (hangi kart token'ının kim tarafından ve ne zaman detokenize edildiği).

Kimlik Doğrulama

İmza Deseni

HMAC-SHA256(secretKey, "{timestamp}\nGET\n/v1/transactions/card-access\n{sha256(\"\")}")
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
fromstringİsteğe BağlıISO 8601 lower bound
tostringİsteğe BağlıISO 8601 upper bound
limitintegerİsteğe BağlıPage size
cursorstringİsteğe BağlıOpaque keyset cursor

Yanıt Parametreleri

AlanTürÖrnek
itemsarray[…]
items[].opstring"detokenize"
items[].cardTokenstring"tok_9f8e7d6c5b4a"
items[].callerServicestring"payment-engine"
items[].resultstring"ok"
items[].createdAtstring"2026-04-13T10:00:01Z"

Yanıt Örneği

JSONYanıt
{
  "items": [
    {
      "op": "detokenize",
      "cardToken": "tok_9f8e7d6c5b4a",
      "callerService": "payment-engine",
      "result": "ok",
      "createdAt": "2026-04-13T10:00:01Z"
    }
  ]
}

Durum Kodları

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