price والباقـة وApplication في الاستجابة قبل الدفع.
الأعمال التحضيرية
- أنشئ Account Token.
- احصل على
application_idمن قائمة Application. - اختر
package_idالقابل للشراء والمتوافق مع نوع Application منpackagesفي تفاصيل الخدمة.
نظرة عامة على الواجهة
جسم الطلب
يستخدم طلب Application واحدapplication_id + package_id؛ ويستخدم الطلب المجمع application_ids + package_ids ذات الأطوال المتطابقة. تختار الطلبات العادية طريقة الدفع في طلب /pay/ اللاحق. عند إنشاء طلب شراء iOS داخل التطبيق، مرّر pay_way: "AppleIAP"، ولا يمكن اختيار سوى باقة Usage واحدة تحتوي على metadata.apple_product_id وmetadata.apple_price. يستخدم شراء Apple داخل التطبيق أسعارًا مستقلة محددة مسبقًا بالدولار الأمريكي، ولا تُضاف إليه خصومات العضوية أو خصومات طريقة الدفع أو الزيادات السعرية للموقع؛ ويعتمد مبلغ الخصم بالعملة المحلية في المناطق الأخرى على صفحة تأكيد الدفع من Apple.
شرح الاستجابة
تعيد العملية الناجحة201 وكائن Order الذي تم إنشاؤه حديثًا. تشمل الحقول الرئيسية id وprice وdiscount وstate وapplication_id/application_ids وpackage_id/package_ids وexpired_at وحقول الوقت. يكون الطلب الجديد عادةً Pending، ثم استدعِ دفع الطلب.
priceهو المبلغ المستحق الذي يحسبه الخادم بناءً على الباقة والزيادة السعرية للموقع والخصومات؛ لا تحسبه من جهة العميل بنفسك.- يتم إرجاع
400عندما لا تتطابق Package مع خدمة أو نوع Application. - لا يمكن المطالبة بـ Package المجانية والمدارة من النظام ذاتيًا عبر واجهة الطلبات العامة.
- سيتم رفض إنشاء طلب لـ Application لا تنتمي إلى الحساب الحالي.