پرش به مستندات
API

روشن یا خاموش کردن پرداخت به‌اندازهٔ مصرف

کلید روشن و خاموش در طرح‌ها و صورت‌حساب، و کارتی که بار اول لازم دارد.

PATCH/billing/pay-as-you-go

هر کدام از 2 فراخوانی را روی فضای کاری شما اجرا می‌کند.

PATCH /billing/pay-as-you-go

کلید روشن و خاموش در طرح‌ها و صورت‌حساب، و کارتی که بار اول لازم دارد.

نمونه

به billing:write نیاز دارد. خاموش کردن فوراً اثر می‌کند و مصرف در سهمیه‌ها متوقف می‌شود. روشن کردن وقتی کارتی ذخیره شده باشد فوراً اثر می‌کند. بار اول، checkoutUrl پیوندی است که شخص در آن کارتی می‌افزاید، و پرداخت به‌اندازهٔ مصرف پس از آن شروع می‌شود. theme و locale ظاهر صفحه‌ای را که پیوند باز می‌کند تعیین می‌کنند.

curl
curl -X PATCH "$OE/billing/pay-as-you-go" -H "$AUTH" -H 'content-type: application/json' \  -d '{ "enabled": true, "locale": "de" }'
پاسخ
{  "object": "pay_as_you_go_switch",  "enabled": false,  "suspended": false,  "activating": false,  "checkoutUrl": "https://checkout.example.com/c/7Yw2kq9RzX4mB1vN?locale=de"}

از راه API چیزی پرداخت نمی‌شود. پیوند صفحهٔ ارائه‌دهندهٔ پرداخت را باز می‌کند، جایی که شخص پرداخت می‌کند، کارت را عوض می‌کند یا لغو می‌کند، همان‌طور که از برنامه انجام می‌دهد.

توکن دسترسی OAuth برای این فراخوانی کد تأیید هویت لازم دارد. تا برنامه در 60 دقیقهٔ گذشته کدی را تأیید نکرده، فراخوانی 403 step_up_required برمی‌گرداند و چیزی را تغییر نمی‌دهد. از کلید API هرگز خواسته نمی‌شود. صفحهٔ احراز هویت نشان می‌دهد چطور کد بخواهید و آن را تأیید کنید.

پس از پرداخت

به billing:write نیاز دارد. پس از آنکه شخص کارت را افزود، POST /billing/pay-as-you-go/confirm نزد ارائه‌دهندهٔ پرداخت بررسی می‌کند و آن را ثبت می‌کند، همان‌طور که برنامه هنگام بازگشت او انجام می‌دهد. enabled می‌گوید آیا پرداخت به‌اندازهٔ مصرف اکنون روشن است، و فراخوانی دوباره بی‌خطر است.

curl
curl -X POST "$OE/billing/pay-as-you-go/confirm" -H "$AUTH"
پاسخ
{ "object": "pay_as_you_go_confirmation", "enabled": true }

activating: true از کلید روشن و خاموش یعنی کارتی همین حالا ذخیره شد و پرداخت به‌اندازهٔ مصرف در حال روشن شدن است، پس کمی بعد دوباره آن را بخوانید.

توکن دسترسی OAuth برای این فراخوانی کد تأیید هویت لازم دارد. تا برنامه در 60 دقیقهٔ گذشته کدی را تأیید نکرده، فراخوانی 403 step_up_required برمی‌گرداند و چیزی را تغییر نمی‌دهد. از کلید API هرگز خواسته نمی‌شود. صفحهٔ احراز هویت نشان می‌دهد چطور کد بخواهید و آن را تأیید کنید.

مرجع