تخطَّ إلى المحتوى
Mena-Pin

الواجهة البرمجية

API شحن ألعاب وبطاقات رقمية لمتجرك

إن كان لك متجر شحن أو تطبيق أو منصّة تبيع منها، فالربط يغنيك عن إدخال كل طلب بيدك: واجهة REST تحت ‎/v1، ومفتاح واحد لحسابك، وكل ما تراه في لوحتك تقرأه وتفعله برمجياً.

افتح حساباً قائمة الأسعار

كل من يبيع هذه المنتجات يستطيع أن يفتح حساباً. الحساب حقيقي من الدقيقة الأولى، بلا فترة تجريبية ولا تفعيل: تؤكّد بريدك، تشحن رصيدك، وتطلب.

الطلب

curl -X POST https://mena-pin.com/v1/orders \
  -H "Authorization: Bearer mp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-invoice-84213" \
  -d '{"sku":"PUBG_MOBILE_60_UC","quantity":1}'
منتجات معروضة
121
تصنيفات
4
التسليم
فوري وآلي
الربط
واجهة REST واحدة

ما الذي تفعله الواجهة

  • مفتاح لكل شخص، وإيقاف فوري

    المفتاح يبدأ بـ mp_live_ ويُصدَر من صفحة الواجهة البرمجية في لوحتك، ولكل شخص في حسابك مفتاحه باسمه. وإصدار مفتاح جديد يُبطل القديم في اللحظة نفسها، فهو زرّ الإيقاف إن تسرّب.

  • الكتالوج بسعرك أنت

    GET /v1/catalog يعيد ما هو معروض بالأسعار المتّفق عليها لحسابك لا بأسعار القائمة، ومعه رمز كل فئة. ورصيد محفظتك من GET /v1/balance.

  • الطلب لا يُنفَّذ مرتين

    POST /v1/orders يقبل ترويسة Idempotency-Key. إعادة الإرسال بالمفتاح نفسه بعد انقطاع الاتصال تعيد الطلب الأول نفسه — لا طلباً ثانياً ولا خصماً ثانياً.

  • السعر يُحسب عندنا

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

  • إشعارات Webhook

    order.delivered عند التسليم، وorder.refunded عند عودة المبلغ إلى محفظتك، وwallet.credited عند تأكيد شحن الرصيد. وإشعار التسليم لا يحمل الكود نفسه: تقرأه من GET /v1/orders/{number} أو من لوحتك.

  • سقف طلبات لكل مفتاح

    ستون طلباً في الدقيقة لكل مفتاح ما لم نتّفق معك على غيره، والتجاوز يُردّ بخطأ rate_limited برمز 429.

الأصناف المتوفّرة الآن

هذه أقسام الكتالوج المتوفّرة الآن، وكل قسم تفتحه فيه منتجات جاهزة للطلب.

تصفّح الكتالوج كاملاً

أسئلة شائعة

أصدِر مفتاحك من صفحة الواجهة البرمجية في لوحتك، واقرأ الكتالوج لتعرف رموز الفئات وأسعارك، ثم أنشئ الطلب بـ POST /v1/orders برمز الفئة والكمية — ومعرّف حساب اللاعب إن كان المنتج شحناً مباشراً. التوثيق الكامل بالأمثلة في صفحة الواجهة البرمجية.

لا. كل مفتاح حقيقي وكل طلب يشتري بضاعة حقيقية بمال من محفظتك. لكن قراءة الكتالوج والرصيد والطلبات لا تشتري شيئاً، وهي ما تبني عليه قبل أول طلب.

أعِد الإرسال بترويسة Idempotency-Key نفسها. إن كان الطلب الأول قد وصل عاد جوابه هو، فلا طلب ثانٍ ولا خصم مرتين. وإن لم يصل، نُفِّذ الآن مرة واحدة.

افتح حساباً

تفتح الحساب بنفسك في دقيقة: تؤكّد بريدك، تشحن محفظتك، وتطلب بسعر القائمة. وسعرك الخاص نتّفق عليه معك متى راسلتنا.

افتح حساباً الواجهة البرمجية