ملی ای‌پی‌آی

صورتحساب و بازگشت مبلغ

هر فراخوان یا هزینه دارد یا ندارد، و پاسخ API همان لحظه می‌گوید کدام.

هزینه کسر نمی‌شود وقتی…

  • سامانه مرجع در دسترس نباشد و استعلام انجام نشود.
  • خطایی از سمت سرویس‌دهنده رخ دهد که نتیجه‌ای تولید نکند.
  • ورودی نامعتبر باشد و پیش از تماس با سامانه مرجع رد شود.
  • موجودی کافی نباشد، یا فراخوان از سقف نرخ عبور کند.

مبلغ هر فراخوان پیش از تماس با سامانه مرجع از موجودی قفل می‌شود. اگر پاسخی نیاید، کل مبلغ همان لحظه به موجودی برمی‌گردد.

هزینه کسر می‌شود وقتی…

استعلام انجام شده و پاسخ معتبر داده است، حتی اگر آن پاسخ «موردی یافت نشد» باشد.

«رکوردی نیست» نتیجهٔ واقعی یک استعلام است و ما بابتش به سامانه مرجع هزینه پرداخته‌ایم. همین‌طور پاسخ قطعی سامانه مرجع، مثلاً اینکه کارتی منقضی شده، استعلامی است که کار خودش را انجام داده.

از کجا بفهمم چه مبلغی کسر شد؟

هر پاسخی که به مرحلهٔ تسویه برسد، فیلد billing دارد و مبلغ کسرشده و موجودی باقی‌مانده را می‌گوید. همین ارقام در گزارش مصرف پنل هم با شناسهٔ هر فراخوان ثبت است. جزئیات در مستندات API آمده است.

اگر فکر می‌کنم مبلغی اشتباه کسر شده

شناسهٔ فراخوان (requestId) را در یک تیکت پشتیبانی بفرستید. هر فراخوان در سوابق ما ردیف دارد و بررسی از روی همان ردیف انجام می‌شود، نه از روی حدس.