واجهة ربط المتاجر

الفئات المتاحة

يتضمن الرد معرّف المنتج والفئات المتاحة ووحدة كل فئة.

إرسال طلب

احصل على مفتاح خاص بمتجرك من مالك X Plus واستخدمه من خادم متجرك. أعطِ كل طلب مرجعًا فريدًا. عند إعادة المحاولة، أرسل نفس المرجع والتفاصيل لتسترجع نفس الطلب.

curl -X POST 'https://xpluscard.plus/api/v1/orders' \
  -H "Authorization: Bearer $XPLUS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"reference":"shop-001","product":"pubg","amount":60,"player_id":"123456789"}'

لبطاقة جوجل بلاي الأمريكية استخدم البيانات التالية مع استبدال المرجع بمرجع الطلب.

{"reference":"shop-002","product":"google-play-us","amount":10}

الاستعلام عن طلب

GET /api/v1/orders/{id}
Authorization: Bearer YOUR_API_KEY

استخدم رقم id من رد إنشاء الطلب والمفتاح نفسه. يشير الرد 201 إلى تسجيل طلب جديد، و400 إلى بيانات غير صالحة، و401 إلى مفتاح غير مقبول، و409 إلى استخدام المرجع سابقًا بتفاصيل مختلفة.