شروع کار › خطاها
خطاها
هر پاسخ ناموفق کد HTTP غیر 2xx و بدنهٔ JSON با یک شیء error دارد. تصمیم را روی کد HTTP و code بگیرید: code پایدار است و معنایش عوض نمیشود. message توضیحی انگلیسی برای لاگ و پشتیبانی است، ممکن است تغییر کند و نباید به مشتری نشان داده شود.
{
"error": {
"code": "invoice_order_conflict",
"message": "external_order_id already has an invoice with another amount or payer_mobile"
}
}const res = await fetch(url, options);
if (!res.ok) {
const { error } = await res.json();
switch (error.code) {
case "invoice_order_conflict":
// same order, different amount: fix the order
break;
case "invalid_access_key":
// rotate the key in the network panel
break;
default:
log(res.status, error.code, error.message);
}
}بدنهٔ خطا
error.codestringشناسهٔ پایدار خطا، از جدول پایین. تصمیم را روی همین بگیرید.
error.messagestringتوضیح انگلیسی برای لاگ؛ ثابت نیست و نباید به مشتری نشان داده شود.
کدهای خطا
همهٔ کدهای API درگاه و API شبکهٔ پذیرنده. صفحهٔ هر endpoint کدهای خودش را هم فهرست میکند.
invalid_request400بدنه یا پارامترها نامعتبرند؛ مثلاً مبلغ صفر، موبایل بدون قالب E.164،
callback_urlبدون https یاcursorساختگی.invalid_access_key401کلید فرستاده نشده، نامعتبر است، منقضی شده یا باطل شده.
access_denied403کلید دسترسی این API را ندارد (
gateway_accessبرای درگاه،merchant_accessبرای پذیرندهها)، یا درخواست از IPی بیرون از فهرست مجاز کلید آمده.invoice_not_found404صورتحساب نیست، مال پذیرندهٔ شبکهٔ دیگری است یا صورتحساب حضوری است.
merchant_not_found404پذیرندهای با این شناسه در شبکهٔ شما نیست.
invoice_not_consumable409صورتحساب
paidنیست، یا ۳۰ دقیقهٔ تأیید مصرف گذشته.invoice_order_conflict409همین
external_order_idقبلاً با مبلغ یا موبایل دیگری ثبت شده.merchant_not_payable409پذیرنده هنوز فعال نشده یا مسدود است و نمیتواند پرداخت بگیرد.
owner_mobile_mismatch409این
external_idقبلاً با موبایل مالک دیگری ثبت شده.merchant_id_mismatch422merchant_idوexternal_idبه یک پذیرنده نمیرسند.internal_error500خطای رینگپی. کمی بعد همان درخواست را تکرار کنید.