اختبار مسارات التحقق +27: قائمة تحقق لإطلاقات جنوب أفريقيا

قبل أول طلب +27: قائمة جاهزية قصيرة

أنجز هذه البنود ويُفترض أن يمر أول تفعيل جنوب أفريقي دون مفاجآت:

1. محفظة ممولة. تموّل محفظة واحدة مسبقة الدفع بالدولار كل شيء؛ اشحنها بالبطاقة أو بـUSDT/USDC. لا يوجد اشتراك.
2. مفتاح صادر. أنشئ مفتاح Bearer في وحدة تحكم المطورين (يبدأ بـor_live_). احتفظ بمفاتيح منفصلة لـCI وللتجهيز (staging)، بحد أقصى 10.
3. webhook مسجّلة. أضف نقطة نهاية HTTPS واحفظ سر التوقيع. يمكنك تسجيل حتى خمس.
4. مُوحِّد الأرقام مُختبَر. غذِّه بمدخل بصيغة 082 123 4567 وتأكد أنه ينتج +2782... بعد حذف الصفر الأول.
5. معرّف الخدمة مؤكد. اجلب الكتالوج من GET /api/v1/services بدلاً من تخمين المعرّفات.
6. sandbox اختياري. يمكن للدعم تحويل حساب تطوير إلى sandbox لتمر أرقام ورموز محاكاة عبر شيفرتك قبل أي إنفاق حقيقي.

يوضح دليل اختبار CI كيفية ربط هذه القطع في خط إنتاج.

كيف تُخزَّن الأرقام الجنوب أفريقية وتُوحَّد؟

تستخدم جنوب أفريقيا بادئة الخط 0. يتكون رقم الجوال المكتوب محلياً من عشرة أرقام مثل 082 123 4567، وتبدأ نطاقات الجوال عادة بـ06 أو 07 أو 08 في هذه الصيغة الوطنية. في الصيغة الدولية يختفي الصفر: يصبح الخط نفسه +27 82 123 4567، أو +27821234567 بعد إزالة المسافات، أي تسعة أرقام بعد رمز الدولة.

الخطأ الكلاسيكي هو قيمة مخزنة مثل +270821234567، تنتج حين يلصق نموذج رمز الدولة بالرقم المحلي دون حذف الصفر. وحّد عند الإدخال، وخزّن E.164 فقط، واعرض الصيغة المحلية المفصولة بمسافات للعرض وحده. وإذا كنت ترسل رسائل SMS صادرة بنفسك، فالقاعدة نفسها تُبقي تقارير التسليم وعمليات البحث عن المستخدمين متسقة.

ما الخدمات التي تستطيع إرسال رموز إلى رقم تحقق جنوب أفريقي؟

من المسارات الشائعة لـza الآن WhatsApp وFacebook وInstagram وTikTok وGoogle (Gmail & YouTube) وUber وTelegram وMicrosoft & Outlook وLinkedIn وNetflix وAmazon وX (Twitter) وChatGPT (OpenAI) وDiscord. وعلى مستوى الكتالوج كله يدعم البلد أكثر من 1,700 خدمة، ولأن المخزون يتحرك على مدار اليوم، فالواجهة البرمجية هي المكان الذي تقرأ منه التوفر الحالي.

لماذا تختار الفرق هذا السوق؟ جوهانسبرغ وكيب تاون مركزان راسخان للتقنية والمال، وتتخذ شركات كثيرة جنوب أفريقيا قاعدة لإطلاق أوسع في الجنوب الأفريقي. وللبلد عدة لغات رسمية منها الإنجليزية والزولو والخوسا والأفريقانية، لكن معظم رسائل التحقق تصل بالإنجليزية، ولذلك يتركز اختبار التوطين على الشاشات المحيطة لا على نص الرسالة نفسه.

الخطوات: استدعاء واجهة OTP لجنوب أفريقيا من بيئة الاختبار لديك

تذهب الطلبات إلى https://otproute.com/api/v1 مع مفتاح Bearer، بحد 300 طلب في الدقيقة.

1. GET /api/v1/prices?country=za&service=<id> يعيد السعر الحي للزوج الذي تريده.
2. POST /api/v1/activations مع {"service": "<id>", "country": "za"} يحجز رقم +27 ويعيد معرّف تفعيل.
3. يُدخل اختبارك الرقم في التطبيق ويطلق الرسالة.
4. يصل الحدث activation.sms_received إلى webhook لديك. قبل أن تثق به، أعد بناء HMAC-SHA256 للقيمة <t>.<raw body> بسر نقطة النهاية، وقارنه مع v1 في X-OTPRoute-Signature، وارفض الطلبات التي طابعها الزمني قديم جداً.
5. تفضّل الاستعلام؟ اقرأ GET /api/v1/activations/{id} بفاصل هادئ بدلاً من ذلك.
6. على التشغيلات المتروكة أن تستدعي POST /api/v1/activations/{id}/cancel، ويتيح GET /api/v1/balance لمهمة ما التوقف مبكراً حين ينخفض الرصيد.

المزيد عن خيارات التوجيه في توجيه OTP حسب الدولة.

خطوات لموظفي التشغيل عبر لوحة التحكم

لا حاجة إلى شيفرة: افتح OTP Gateway، واختر جنوب أفريقيا والخدمة، وتحقق من السعر المعروض، وأكّد، ثم الصق رقم +27 في التطبيق. تظهر الرسالة في صفحة التفعيل فور وصولها، وتعمل نافذة الـ20 دقيقة والاسترداد التلقائي تماماً كما تعملان عبر الواجهة البرمجية.

استكشاف أخطاء الرموز الجنوب أفريقية المتأخرة

أولاً، الجانب المالي: إذا لم تصل رسالة خلال 20 دقيقة، أو ألغيت، يعود المبلغ كاملاً إلى المحفظة تلقائياً. ثم شخّص:

• الصبر أولاً. تعتمد سرعة التسليم على الخدمة والمسار، فدع التفعيل يكمل مدته.
• سياسة القبول. ترفض بعض الخدمات الأرقام الافتراضية؛ والاسترداد في هذه الحالة سلوك متوقع لا عطل.
• وقت أو مسار مختلف. أعد المحاولة لاحقاً، أو استخدم مساراً مجاوراً مثل ناميبيا أو بوتسوانا إذا سمحت حالة الاختبار.
• لا تُغرق الطلبات. إلغاء الطلب وإعادته في حلقة سريعة نادراً ما يفيد ويستهلك حد المعدل.

استخدم الأرقام لاختبار منتجك أو تشغيل حساباتك التجارية فقط، والتزم بشروط كل خدمة، وتذكّر أن سياسة الاستخدام المقبول في OTP Route سارية.

الخطوط الجنوب أفريقية طويلة الأمد ونموذج الفوترة

لا يوجد رقم +27 طويل الأمد بالخدمة الذاتية. الأرقام المخصصة (Dedicated Numbers)، من $1.95/month، متاحة في الولايات المتحدة وكندا فقط؛ ويمكن للفرق التي تحتاج خطاً جنوب أفريقياً دائماً مراسلة [email protected]، وإمكانية ذلك تعتمد على القوانين المحلية. الفوترة بنظام الدفع حسب الاستخدام من المحفظة مسبقة الدفع، مع فاتورة PDF تصل بالبريد عن كل شحن. راجع الأسعار للصورة الكاملة.

الأسئلة الشائعة

هل يمكنني اختبار مسار التسجيل الجنوب أفريقي في تطبيقي دون شريحة محلية؟

نعم. اطلب رقم +27 عبر OTP Gateway واقرأ الرمز في لوحة التحكم أو عبر الواجهة. التكلفة من $0.20 لكل رمز، ولا تُحتسب إلا عند وصول الرمز.

هل أبقي الصفر الأول عند تحويل رقم جنوب أفريقي إلى E.164؟

لا. احذف الصفر الخاص ببادئة الخط وأضف +27، فيصبح 082 123 4567 هو +27821234567.

ما معرّف الدولة لجنوب أفريقيا في الواجهة؟

إنه za، ويوضع في استعلام السعر وفي جسم JSON عند إنشاء تفعيل +27.

بأي لغة تصل رسائل التحقق الجنوب أفريقية؟

في الغالب بالإنجليزية، رغم أن للبلد عدة لغات رسمية. الصياغة تحددها الخدمة المرسلة.

هل هناك استرداد إذا لم يُسلَّم الرمز؟

نعم. يبقى التفعيل مفتوحاً 20 دقيقة، وإذا لم يصل شيء أو ألغيت، يعود المبلغ كاملاً إلى محفظتك تلقائياً.

هل يمكنني شراء رقم جنوب أفريقي أحتفظ به أشهراً؟

ليس بالخدمة الذاتية. الأرقام المخصصة (Dedicated Numbers) منتج للولايات المتحدة وكندا؛ وبالنسبة لجنوب أفريقيا راسل الدعم للاستفسار، دون وعد بالتوفر.

كم خدمة يمكنني التحقق منها برقم +27 على OTP Route؟

أكثر من 1,700 في آخر لقطة. راجع الكتالوج الحي عبر الواجهة، لأن التوفر يتغير على مدار اليوم.

أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.