پرش به محتوای اصلی
فروشگاه‌ساز·Drupal Commerce

درگاه پرداخت شی‌پی برای دروپال کامرس

ماژول sheypay_commerce یک درگاه پرداخت off-site برای Drupal Commerce اضافه می‌کند. پرداخت پس از بازگشت مشتری سمت سرور و با مبلغ سفارش تأیید می‌شود، نتیجهٔ دیررس بانک با Notify URL امضاشده تکمیل می‌شود و استرداد کامل یا جزئی از صفحهٔ پرداخت‌های سفارش انجام می‌شود.

  • استرداد از داخل پنل
  • وب‌هوک امضاشده
  • وضعیت «در انتظار» درست
  • تومان و ریال
  • حالت آزمایشی با sk_test_

این نسخه بتا است: کامل است ولی هنوز روی فروشگاه‌های واقعی کافی اجرا نشده. اول روی نسخهٔ آزمایشی سایتتان و با کلید sk_test_ امتحانش کنید و هر اشکالی دیدید به پشتیبانی بگویید.

نصب

  1. ۱

    پوشهٔ sheypay_commerce را در modules/custom قرار دهید.

  2. ۲

    ماژول را از Extend یا با drush en sheypay_commerce فعال کنید.

  3. ۳

    در Commerce › Configuration › Payment gateways یک درگاه با افزونهٔ «SheyPay (شی‌پی)» بسازید و کلید API (sk_test_ برای آزمایش) را وارد کنید.

  4. ۴

    Notify URL نمایش‌داده‌شده در فرم را در پنل شی‌پی › وب‌هوک‌ها ثبت و رمزش را در «رمز وب‌هوک» بگذارید.

تنظیمات

کلید API
sk_test_ برای آزمایش و sk_live_ برای فروش واقعی؛ حالت از روی کلید تشخیص داده می‌شود.
واحد مبلغ فروشگاه
ارز IRR ریال و IRT/TMN تومان تشخیص داده می‌شود؛ برای کدهای دیگر واحد را انتخاب کنید.
رمز وب‌هوک
برای تکمیل پرداخت‌هایی که مشتری‌شان برنمی‌گردد.
پیشوند شناسهٔ سفارش
فقط وقتی یک درگاه را روی چند فروشگاه استفاده می‌کنید.

تست در محیط آزمایشی

با کلید sk_test_ پول واقعی جابه‌جا نمی‌شود و در صفحهٔ بانک آزمایشی نتیجه را خودتان انتخاب می‌کنید.

  • کلید sk_test_ را وارد کنید؛ پول واقعی جابه‌جا نمی‌شود.
  • یک سفارش ثبت کنید و در بانک آزمایشی «موفق» را انتخاب کنید؛ یک Payment با وضعیت Completed و کد پیگیری ثبت می‌شود.
  • «ناموفق» شما را با پیام خطا به مرحلهٔ پرداخت برمی‌گرداند و «در انتظار» Payment را در وضعیت New نگه می‌دارد.
  • از صفحهٔ Payments سفارش یک استرداد جزئی بزنید.

مشکلات رایج

خطای «دامنهٔ آدرس بازگشت تأیید نشده است».

دامنهٔ سایت دروپال باید روی دامنهٔ تأییدشدهٔ درگاه در پنل شی‌پی باشد.

مبلغ در درگاه ده برابر یا یک‌دهم است.

«واحد مبلغ فروشگاه» را با واحد واقعی ارز فروشگاه یکی کنید.

موبایل مشتری به درگاه نمی‌رسد.

ماژول فیلد field_phone پروفایل صورتحساب را می‌خواند؛ در صورت نیاز این فیلد را اضافه کنید.

تغییرات

  1. نسخهٔ ۱.۰.۰

    • نسخهٔ اول: درگاه off-site، تأیید سمت سرور، Notify URL امضاشده، وضعیت در انتظار و استرداد.

اولین رسیدتان را امروز صادر کنید

ثبت‌نام با شمارهٔ موبایل انجام می‌شود و تا تأیید مدارک، همه‌چیز را در محیط آزمایشی امتحان می‌کنید.

هزینهٔ ثبت‌نامندارد
کارمزدفقط تراکنش موفق