POST/v1/cards/:id/unfreeze

رفع التجميد عن بطاقة

يزيل التجميد الذي أجرته أنت، فتعود البطاقة إلى حالة active.

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

البطاقة التي أوقفها المزود ليست ملكك لترفع عنها التجميد — تلك الإجابة هي suspended_by_provider وتحتاج المزود نفسه، لا إعادة المحاولة.

المعطيات

idstringمطلوب

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

Idempotency-Keystringمطلوب

مطلوبة، 8 أحرف على الأقل. المفتاح المُعاد إرساله يعيد الإجابة المخزنة ولا يقلب حالة البطاقة مرتين.

أمثلة الكود

curl -X POST "https://samaprime.com/api/v1/cards/smsord_01J8X9AABBCCDD/unfreeze" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 0e7f5c1e-2b3a-4f6d-9c8b-1a2b3c4d5e6f"

الاستجابة

→ 200
{
  "data": {
    "id": "cm_card_01J8Z1A2BBCCDD",
    "status": "active"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-06T12:00:00Z"
  }
}

الأخطاء

الحالة	الرمز
404	`not_found` لا توجد بطاقة بهذا المعرّف تخصك لدى هذا المتجر.
409	`suspended_by_provider` هذه البطاقة موقوفة من المزود، لا مجمّدة منك.
409	`provider_error` رفض المُصدِر رفع التجميد. بقيت البطاقة كما هي، وما زالت مجمّدة.
400	`idempotency_key_required` لا توجد ترويسة Idempotency-Key، أو أنها أقصر من 8 أحرف. مطلوبة رغم أن رفع التجميد لا يحرك مالًا: لا يجوز أن يُطبَّق التبديل مرتين.
403	`test_key_not_allowed` مفتاح الاختبار (sk_test_) لا يحرّك المال: عمليات البطاقات تحتاج مفتاحًا حيًا. لم يُحجز شيء ولم يُمسّ رصيد المحفظة.