إيصال رمز SMS من Mercado Pago إلى تشغيل الاختبار لديك

ما المشكلة التي تحلّها الفرق في خطوة الهاتف بـ Mercado Pago؟

Mercado Pago، منصة المدفوعات والمحفظة الرقمية التابعة لـ Mercado Libre، جزء من التجارة اليومية في أمريكا اللاتينية. وكما في معظم التطبيقات المالية، يرتبط الحساب برقم هاتف: يؤكد رمز SMS الرقم عند التسجيل، وقد يطلب التطبيق رمزًا جديدًا عندما يسجّل أحدهم الدخول على جهاز جديد أو يستعيد الوصول. وبالنسبة للفرق التي تبني حول المنصة، كالتجار الذين يربطون صفحة الدفع، أو الوكالات التي تدير حساب بائع لعميل، أو مهندسي الجودة الذين يختبرون سوقًا إلكترونيًا يعرض Mercado Pago عند الدفع، كثيرًا ما تكون خطوة SMS هذه هي الجزء المزعج. إذ ينتهي الموظفون بوضع أرقام هواتفهم الشخصية على حسابات الأعمال، أو تتعطل حالة اختبار لأن الشخص الوحيد الذي يملك الشريحة المناسبة غير متصل.

يحوّل OTP Route هذه الخطوة إلى شيء تستطيع أدواتك التعامل معه: رقم عند الطلب للسوق الذي تحتاجه، مع تسليم الرمز إلى أنظمتك. وهذا جوهر التحقق عبر SMS في Mercado Pago لأغراض الاختبار.

كيف يعمل مسار API لرمز التحقق من Mercado Pago؟

تتجه كل الطلبات إلى https://otproute.com/api/v1 بمفتاح Bearer (بادئة or_live_) من Developer console. معرّف الخدمة هو mercado_pago؛ ومعرّف الدولة هو قيمة api_country لسوقك، مثل br للبرازيل أو mx للمكسيك.

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

استخدم GET /api/v1/balance كفحص مسبق. يحصل كل حساب على 10 مفاتيح و5 نقاط نهاية webhook و300 طلب في الدقيقة؛ وبقية التفاصيل في الوثائق.

كيف ينبغي أن يتعامل معالج webhook مع رموز Mercado Pago؟

يحمي التسليم بالدفع مشغّلات الاختبار من الدوران في حلقات الاستعلام. يأتي كل حدث مع X-OTPRoute-Signature: t=<unix>,v1=<hex>؛ احسب HMAC-SHA256 لـ <t>.<raw body> بسر نقطة النهاية، وقارن في زمن ثابت، وأسقط الطلبات ذات الطوابع الزمنية القديمة. ثم اجعل المعالج idempotent: خزّن معرّف التفعيل وتجاهل التسليم الثاني للحدث نفسه، لأن إعادة المحاولة تحدث. وأصغِ أيضًا إلى activation.expired وactivation.cancelled كي يحرر المشغّل موضعه ويُعلّم الاختبار لمحاولة أخرى. وإذا فضّلت ألا تستضيف نقطة نهاية، فإن الاستعلام عن التفعيل كل بضع ثوانٍ يبقى ضمن حد الطلبات بكل راحة. تضم مقالة تأمين webhooks الخاصة بـ OTP قائمة تحقق أوفى.

من أي دولة يجب أن يأتي رقم Mercado Pago؟

خدمة mercado_pago مدرجة في 201 دولة على OTP Route، لكن الخيار المفيد هو في الغالب السوق الذي ينتمي إليه الحساب. يشتهر Mercado Pago في البرازيل والأرجنتين والمكسيك وتشيلي وكولومبيا وأوروغواي وبيرو، ولذلك تتركز فيها معظم حالات الاختبار. ويصل الكتالوج أيضًا إلى الإكوادور وبوليفيا وباراغواي وكوستاريكا وبنما والجمهورية الدومينيكية وإسبانيا والبرتغال والولايات المتحدة، وغيرها كثير.

قد يفشل رقم من دولة خاطئة في التحقق أو يستدعي فحوصات إضافية، ولا يخبرك شيئًا عن تجربة المستخدمين الحقيقيين في ذلك السوق للمسار. طابق حالة الاختبار: التسجيل البرازيلي برقم برازيلي، والتشيلي برقم تشيلي.

ماذا أفعل من لوحة التحكم بدلًا من ذلك؟

يصل غير المطورين إلى النتيجة نفسها بلا كود. افتح OTP Gateway، واختر Mercado Pago كخدمة، واختر الدولة، وراجع السعر المعروض قبل الطلب. انسخ الرقم إلى التطبيق، واطلب الرسالة، فيظهر الرمز على بطاقة التفعيل فور تسليمه. يُحجز الرقم 20 دقيقة؛ وإذا لم يصل شيء فلا يُخصم شيء، إذ يعود المبلغ إلى محفظتك تلقائيًا.

لماذا قد لا يصل رمز Mercado Pago؟

تتوخى منصات الدفع الحذر مع أرقام الهواتف، وقد يُرفض الرقم الافتراضي لـ Mercado Pago في بعض المسارات أو كلها. كما تتغير المسارات خلال اليوم. إذا لم يظهر الرمز:

• دع نافذة الـ 20 دقيقة تنتهي؛ فالاسترداد تلقائي.
• تجنب إعادة الطلب في حلقة سريعة. باعد بين المحاولات أو عد لاحقًا.
• جرّب مسارًا آخر للسوق نفسه إذا ظل أحد المسارات ينتهي دون رسالة.
• تأكد من أن حقل الهاتف استلم الرقم بالصيغة التي يتوقعها التطبيق.

وعندما يرفض مسار الأرقام الافتراضية باستمرار، تقبّل هذه النتيجة واستخدم خطًّا حقيقيًا لذلك الحساب. يغطي تقليل إخفاقات تسليم OTP التشخيص الأوسع.

متى يكون الرقم المخصص أنسب؟

يتعامل الرقم لمرة واحدة مع رمز واحد. أما حساب أعمال سيطلب رمزًا جديدًا بعد أشهر فيحتاج رقمًا ما زلت تتحكم فيه. تؤدي الأرقام المخصصة (Dedicated Numbers) من OTP Route هذا الدور في الولايات المتحدة وكندا، بدءًا من $1.95 شهريًا: استقبال SMS الوارد في لوحة التحكم وعلى webhook الخاص بك (number.sms_received)، وإرسال SMS صادر ومكالمات عبر المتصفح، مع التجديد من المحفظة إلى أن تحرر الخط. خارج هاتين الدولتين لا يوجد خط طويل الأمد بالخدمة الذاتية؛ راسل [email protected] للاستفسار، علمًا أن التوفر يعتمد على القواعد المحلية. راجع الأرقام الافتراضية للتفاصيل.

ما القواعد التي تنطبق عند استخدام هذه الأرقام مع Mercado Pago؟

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

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

هل يمكنني استقبال رمز OTP من Mercado Pago دون شريحة محلية في البرازيل أو المكسيك؟

نعم، عندما تختبر حسابك الخاص أو تشغّله. اطلب رقمًا للخدمة mercado_pago للدولة المناسبة واقرأ الرمز من لوحة التحكم أو API أو webhook.

ما معرّف خدمة Mercado Pago في API؟

إنه mercado_pago. اجمعه مع معرّف الدولة في جسم الطلب POST /api/v1/activations.

هل يقبل Mercado Pago الأرقام الافتراضية؟

ليس دائمًا. فقد يرفضها في بعض المسارات، ولهذا يُرد المبلغ كاملًا عندما لا يصل أي رمز خلال 20 دقيقة.

كم يكلف رقم هاتف للتحقق في Mercado Pago؟

من $0.20 لكل رمز. يعتمد السعر الدقيق على الدولة ويعرضه API ولوحة التحكم قبل الطلب.

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

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

هل يستطيع خط CI لدي تجربة مسار Mercado Pago دون رسوم فعلية؟

نعم. اطلب وضع sandbox لحساب تطوير؛ فهو يعيد أرقامًا ورموزًا محاكاة عبر نقاط النهاية نفسها.

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