• صفحه اصلی
  • تعرفه ها
  • پلاگین و ماژول ها
  • پرسش های متداول
  • وبلاگ
  • خدمات پرداخت
  • قوانین
  • درباره ما
  • تماس با ما
  • حساب کاربری ایجاد حساب
راهنمای اتصال به درگاه پرداخت

ارتباط با درگاه باید از طریق متد POST انجام شود.
برای این منظور باید یک درخواست به آدرس زیر ارسال کنید:

https://pay.zardis.net/invoice/request

مقادیری که باید ارسال شوند به شرح ذیل می‌باشد:
بعد از ارسال این درخواست یک آرایه با فرمت JSON در جواب شما ارسال می‌شود.
اگر ورودی‌ها صحیح باشند و خطایی رخ ندهد خروجی به صورت زیر خواهد بود:

وضعیت عدد (1) status
شناسه پرداخت invoice_key

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

https://pay.zardis.net/invoice/{invoice_key}

و کاربر را به این آدرس منتقل کنید.
ولی اگر خطایی رخ دهد خروجی به صورت زیر خواهد بود:

کد خطا errorCode
توضیحات خطا errorDescription

بررسی صحت پرداخت:
پس از اینکه کاربر به سایت شما برگشت داده شد، می‌توانید صحت پرداخت را چک کنید.
برای این منظور کافیست یک درخواست به آدرس زیر ارسال کنید:

https://pay.zardis.net/invoice/check/{invoice_key}

مقادیری که باید ارسال شوند به شرح ذیل می‌باشد

شناسه  درگاه api_key

اگر ورودی‌ها صحیح باشند و خطایی رخ ندهد خروجی به صورت زیر خواهد بود:

وضعیت عدد (1) status
مبلغ (به ریال) amount
شناسه پیگیری پرداخت که بانک برمی‌گرداند bank_code

سپس می‌توانید مبلغ را با مبلغ ثبت شده در دیتابیس تطابق دهید و در صورت صحیح بودن کالا یا سرویس مورد نظر را در اختیار کاربر قرار دهید.

ولی اگر خطایی رخ دهد خروجی به صورت زیر خواهد بود:

کد خطا توضیحات
100 نوع درخواست باید POST باشد
101 api_key ارسال نشده یا صحیح نیست
102 مبلغ ارسال نشده است یا کمتر از 1000 ریال است
103 آدرس بازگشت ارسال نشده است
301 خطایی در برقراری با سرور بانک رخ داده است
200 شناسه پرداخت صحیح نیست
201 پرداخت انجام نشده است
202 پرداخت کنسل شده است یا خطایی در مراحل پرداخت رخ داده است