POST/v1/sms/orders/:id/cancel

إلغاء طلب

يلغي طلباً معلّقاً قبل وصول الرمز ويرد المبلغ بالكامل.

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

المعطيات

idstringمطلوب

معرّف الطلب.

أمثلة الكود

curl -X POST "https://samaprime.com/api/v1/sms/orders/smsord_01J8X9AABBCCDD/cancel" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json"

الاستجابة

→ 200
{
  "data": {
    "id": "ord_01J8X9AABBCCDD",
    "status": "cancelled",
    "refunded_usd": "0.8000"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-06T12:00:00Z"
  }
}

الأخطاء

الحالة	الرمز
404	`not_found` لا يوجد طلب بهذا المعرّف يخص هذا المستخدم.
409	`already_finalized` الطلب لديه رمز بالفعل، أو وصل إلى حالة نهائية.