GET/v1/cards/:id/transactions

سجل معاملات البطاقة

دفتر أحوال البطاقة نفسها: الأذونات والاستردادات والعكسيات، الأحدث أولًا.

الصلاحية المطلوبة: cards.readحد الطلبات: 10 rps

المعطيات

idstringمطلوب

معرّف البطاقة.

limitintegerاختياري

أقصى عدد صفوف يُعاد، محصور بين 1 و100، افتراضيًا 50.

offsetintegerاختياري

عدد الصفوف التي يتم تخطّيها للصفحة التالية، 0 أو أكبر، افتراضيًا 0.

أمثلة الكود

curl -X GET "https://samaprime.com/api/v1/cards/smsord_01J8X9AABBCCDD/transactions" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json"

الاستجابة

→ 200
{
  "data": [
    {
      "id": "cm_cardtx_01J9A2B3BBCCDD",
      "type": "purchase",
      "direction": "debit",
      "amount_usd": "0.4900",
      "status": "completed",
      "occurred_at": "2026-08-10T14:20:00Z",
      "merchant_name": "GARENA ONLINE PRIVATE"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-06T12:00:00Z"
  }
}

الأخطاء

الحالة	الرمز
404	`not_found` لا توجد بطاقة بهذا المعرّف تخصك لدى هذا المتجر.