قائمة تحقق قبل استقبال رموز SMS من كوراساو (+599)

ما الذي ينبغي أن يكون في قائمة التحقق قبل طلب رقم +599؟

تكافئ أسواق الجزر قليلًا من الإعداد المسبق، لأن توفر المسارات يتغير خلال اليوم والاختبار المتعجل يهدر الوقت. أنجز هذه البنود قبل الطلب الأول:

• مفتاح API من وحدة تحكم المطورين. تبدأ المفاتيح بـor_live_؛ ويستطيع الحساب حمل ما يصل إلى 10، فامنح CI وstaging مفتاحًا خاصًا لكل منهما.
• محفظة بالدولار فيها رصيد، أو حساب تطوير حُوِّل إلى sandbox عند الطلب إن أردت تجربة التكامل فقط.
• المعرّفات الصحيحة. كوراساو هي cw في API؛ ويأتي معرّف الخدمة من GET /api/v1/services.
• نقطة webhook مع حفظ سرّها، أو حلقة استعلام دوري بفاصل معقول. يُسمح بما يصل إلى 5 نقاط لكل حساب.
• قاعدة تخزين لأرقام +599 (نوضحها أدناه)، لتتطابق بيانات الاختبار مع بيانات الإنتاج.
• خطة للحالة الفارغة: ماذا يفعل اختبارك إذا انتهت النافذة دون رمز.

ما الخدمات التي يغطيها مسار رقم التحقق لكوراساو؟

تذكر اللقطة الحية لكوراساو أكثر من 400 خدمة. ومن الشائعة Telegram وGoogle (Gmail & YouTube) وFacebook وInstagram وTikTok وX (Twitter) وChatGPT (OpenAI) وMicrosoft & Outlook وAmazon وDiscord وLinkedIn وSignal وNetflix وUber وAirbnb. وأسماء السفر والمراسلة هي التي تلجأ إليها فرق كوراساو أولًا، لأن منتجات الضيافة والموجهة للزوار تقود كثيرًا من تسجيلات الجزيرة الرقمية.

اعتبر هذه القائمة نقطة بداية لا وعدًا. فالمخزون يتحرك خلال اليوم، ولهذا بالذات يعيد API التوفر مع كل استعلام عن السعر.

خطوة بخطوة: استدعاء واجهة OTP API لكوراساو

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

1. اقرأ GET /api/v1/prices?country=cw&service=<id> للتأكد من أن المسار مفتوح ورؤية السعر الحالي لذلك الزوج.
2. أنشئ الطلب عبر POST /api/v1/activations مرسلًا {"service": "telegram", "country": "cw"} أو أي معرّف خدمة تحتاجه. تحمل الاستجابة معرّف التفعيل ورقم +599.
3. أدخل ذلك الرقم في شاشة التسجيل أو الدخول التي تختبرها.
4. انتظر activation.sms_received على webhook، أو استعلم عن GET /api/v1/activations/{id} بفاصل هادئ.
5. إذا هُجر الاختبار فاستدعِ POST /api/v1/activations/{id}/cancel ليُقيَّد المبلغ في المحفظة فورًا.

قبل الوثوق بأي webhook افحص الترويسة X-OTPRoute-Signature: احسب HMAC-SHA256 على "<t>.<raw body>" بسر نقطة النهاية، وارفض الطوابع الزمنية القديمة. ويشرح دليل توقيع webhook ذلك بمزيد من العمق.

كيف يُخزَّن رقم +599 ويُوحَّد؟

تتشارك كوراساو رمز الدولة +599 مع بونير وسينت أوستاتيوس وسابا، وتتبع أرقام مشتركي كوراساو هذا الرمز بالرقم 9. وذلك الرقم 9 جزء من الرقم لا بادئة محلية، لذا فإن دالة توحيد تحذفه ستفسد السجل. خزّن سلسلة E.164 الكاملة (+5999 يتبعها بقية الأرقام) دون مسافات، وأضف التنسيق عند العرض فقط.

ومن المفيد أيضًا التأكد من أن أداة إدخال الهاتف لديك تعرض كوراساو كبند مستقل بدلًا من دمجها في خيار عام لجزر الأنتيل الهولندية، وهو ما تفعله المكتبات القديمة.

أما اللغة: فالبابيامنتو والهولندية والإنجليزية كلها رسمية، وترسل معظم الخدمات العالمية الرموز بالإنجليزية أو بلغة الحساب. وإذا كان منتجك يُوطَّن بالهولندية أو البابيامنتو فأجرِ مرورًا واحدًا على الأقل لكل لغة لترى القالب الحقيقي لا بديلًا احتياطيًا. وتختبر الفرق هنا عادةً عند الإطلاق في الكاريبي الهولندي، أو خدمة الزوار الذين يحجزون من الخارج، أو إدارة عمليات إقليمية من الجزيرة.

ما مسار لوحة التحكم لمن لا يكتب الشيفرة؟

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

1. أنشئ حسابًا ببريدك ورمز من 6 أرقام، أو بتسجيل الدخول عبر Google، وفعّل المصادقة الثنائية TOTP.
2. عبّئ المحفظة.
3. افتح OTP Gateway، واختر الخدمة، ثم اختر كوراساو؛ ويظهر السعر قبل أن تؤكد.
4. انسخ رقم +599 إلى التطبيق وراقب بطاقة التفعيل حتى يظهر الرمز.

وتنطبق نافذة الـ20 دقيقة وقاعدة الاسترداد نفسها كما في API.

استكشاف الأخطاء: لم يظهر الرمز الكوراساوي

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

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

وتبيّن صفحة حل اختبار الجودة كيف تدمج الفرق إعادات المحاولة هذه في مجموعاتها الآلية.

الخطوط طويلة الأمد والمحفظة والفوترة لمشاريع كوراساو

لا يوجد رقم طويل الأمد بالخدمة الذاتية لكوراساو. وإن احتجت خطًا تحتفظ به لأشهر فراسل [email protected] وسيتحقق الفريق مما تسمح به القواعد المحلية؛ ولا شيء موعود. والخطوط المخصصة منتج للولايات المتحدة وكندا، بدءًا من $1.95/month، موصوفة في صفحة الأرقام الافتراضية.

تُسحب تفعيلات كوراساو من محفظة واحدة مدفوعة مسبقًا بالدولار الأمريكي، بلا رسوم شهرية ولا باقة تختارها. تعمل مدفوعات البطاقة وعملات USDT/USDC معًا في التعبئة، وتولّد كل عملية تعبئة فاتورة PDF بالبريد لحسابات مشروعك في كوراساو. والأسعار الحالية في صفحة الأسعار. استخدم OTP Route لمنتجاتك الخاصة وحساباتك المشروعة فقط، والتزم بشروط كل خدمة، وتذكّر أن سياسة الاستخدام المقبول لدى OTP Route سارية.

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

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

نعم. اطلب رقم +599 من OTP Gateway للخدمة قيد الاختبار واقرأ الرمز في لوحة التحكم أو عبر API، دون شريحة أو هاتف في الجزيرة.

ما معرّف الدولة الذي يستخدمه OTP Route لكوراساو؟

كوراساو هي cw. ادمج cw مع معرّف الخدمة الذي يسرده GET /api/v1/services في كل فحص سعر وطلب.

هل الرقم 9 بعد +599 بادئة محلية ينبغي حذفها؟

لا. في كوراساو يشكّل الرقم 9 جزءًا من رقم المشترك، لذا أبقِه في قيمة E.164 المخزنة.

هل أُحاسَب عندما ينتهي تفعيل كوراساو دون رمز؟

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

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

ليس عبر الخدمة الذاتية. الأرقام المخصصة طويلة الأمد تُباع للولايات المتحدة وكندا فقط؛ أما لكوراساو فيمكنك مراسلة الدعم للاستفسار، دون أي وعد بالتوفر.

كيف أربط التكامل قبل إنفاق رصيد المحفظة؟

اطلب من الدعم وضع sandbox لحساب التطوير. فهو يعيد أرقامًا ورموزًا محاكاة، فيمكن تجربة مسار API وwebhook كاملًا من البداية إلى النهاية.

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