بدء عملية دفع
الرابط الذي يشتري خطة مدفوعة.
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
POST /billing/checkout
الرابط الذي يشتري خطة مدفوعة.
مثال
يتطلب billing:write. يكون plan هو starter أو business أو enterprise، ويكون interval هو month، وهو الافتراضي، أو year. لا يُحصَّل شيء حتى يدفع الشخص هناك، وتبدأ الخطة بعد أن يفعل.
curl -X POST "$OE/billing/checkout" -H "$AUTH" -H 'content-type: application/json' \ -d '{ "plan": "business", "interval": "year" }'{ "object": "checkout", "url": "https://checkout.example.com/c/3Hq8vXnP2sT6kL0w" }مساحة العمل التي تدفع لخطة بالفعل تعيد 409 plan_conflict: غيّر الخطة من بوابة الفوترة بدلًا من ذلك. والخطة أو الفترة التي لا يبيعها هذا التثبيت تعيد 422 plan_unavailable.
لا يُدفع شيء عبر API. يفتح الرابط صفحة مزوّد الدفع، حيث يدفع الشخص أو يغيّر البطاقة أو يلغي، كما يفعل من التطبيق.
يحتاج رمز وصول OAuth إلى رمز تحقق لهذا الاستدعاء. وإلى أن يتحقق التطبيق من رمز خلال آخر 60 دقيقة، يردّ الاستدعاء بـ 403 step_up_required ولا يغيّر شيئًا. ولا يُطلب ذلك من مفتاح API أبدًا. وتبيّن صفحة المصادقة كيف تطلب رمزًا وتتحقق منه.