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

توضیحات

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

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

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

در ووکامرس فقط یک کلید API ووی‌بیت که به درگاه وصل است وارد می‌شود. افزونه وب‌هوک HTTPS و نشانی بازگشت را خودکار ثبت می‌کند و رمز امضای وب‌هوک را پس از چرخش روی فروشگاه ذخیره می‌کند. هیچ‌کدام از این رمزها به مرورگر فرستاده نمی‌شوند.

چطور کلید API را بگیریم

  1. در https://dashboard.voybit.com/ حساب فروشنده بسازید یا وارد شوید.
  2. درگاه‌ها را در https://dashboard.voybit.com/?view=gateways باز کنید و New gateway را بزنید.
  3. برای فروشگاه نام بگذارید، هر رمزارزی را که مشتری می‌تواند استفاده کند انتخاب کنید، Gateway status را active نگه دارید و ذخیره کنید.
  4. کلیدهای API را در https://dashboard.voybit.com/?view=keys باز کنید و Create secret key را بزنید.
  5. درگاه مرحلهٔ ۲ را انتخاب کنید، کلید را بسازید و مقدار کامل را کپی کنید. با vb_live_ شروع می‌شود و فقط یک بار نشان داده می‌شود.
  6. در وردپرس، ووکامرس، تنظیمات، پرداخت‌ها، درگاه پرداخت ووی‌بیت را باز کنید. کلید را بچسبانید، «فعال‌سازی ووی‌بیت» را انتخاب کنید و ذخیره کنید.

تصاویر ۱ تا ۸ گام‌های داشبورد را نشان می‌دهند: برای درگاه نام بگذارید، رمزارزها را انتخاب کنید، نشانی وب‌هوک و بازگشت را خالی بگذارید، آن را Live ذخیره کنید، سپس یک کلید API بسازید که به همان درگاه وصل است.

نشانی فروشگاه در وردپرس باید HTTPS باشد. تا وقتی کلید API ذخیره نشود و راه‌اندازی خودکار موفق نشود، درگاه پرداخت در تسویه‌حساب دیده نمی‌شود. رمز وب‌هوک یا شناسهٔ دارایی را وارد نمی‌کنید.

ووکامرس علامت تجاری Automattic Inc. است. این افزونه به Automattic وابسته نیست.

عکس‌های صفحه

نصب

  1. ووکامرس ۸٫۳ یا جدیدتر را نصب و فعال کنید.
  2. پوشهٔ voybit-for-woocommerce را در wp-content/plugins کپی کنید، یا همان پوشه را زیپ کنید و از افزونه‌ها، افزودن، بارگذاری افزونه بفرستید.
  3. درگاه پرداخت ووی‌بیت برای ووکامرس را فعال کنید.
  4. ووکامرس، تنظیمات، پرداخت‌ها، درگاه پرداخت ووی‌بیت را باز کنید.
  5. طبق راهنما داشبورد ووی‌بیت را باز کنید، یک درگاه فعال بسازید و یک کلید API مخفی بسازید که به همان درگاه وصل است. کلید با vb_live_ شروع می‌شود.
  6. کلید API را بچسبانید، «فعال‌سازی ووی‌بیت» را انتخاب کنید و ذخیره کنید. افزونه وب‌هوک و نشانی بازگشت را خودکار ثبت می‌کند.

نشانی فروشگاه در وردپرس باید HTTPS باشد. تا وقتی کلید API ذخیره نشود و راه‌اندازی خودکار موفق نشود، درگاه پرداخت در تسویه‌حساب دیده نمی‌شود.

سوالات متداول

وردپرس می‌گوید افزونه‌های لازم نیستند یا غیرفعال‌اند.

اول ووکامرس ۸٫۳ یا جدیدتر را نصب و فعال کنید. وردپرس با سربرگ وابستگی افزونه، این درگاه پرداخت را تا وقتی ووکامرس آماده نباشد غیرفعال نگه می‌دارد.

کلید API را کجا وارد کنم؟

ووکامرس، تنظیمات، پرداخت‌ها، درگاه پرداخت ووی‌بیت. اول در داشبورد ووی‌بیت درگاه و یک کلید مخفی وصل به درگاه بسازید. کلید با vb_live_ شروع می‌شود. افزونه رمز امضای وب‌هوک را خودش می‌گیرد و ذخیره می‌کند.

رمز وب‌هوک یا شناسهٔ دارایی را کجا وارد کنم؟

هیچ‌کدام از این دو مقدار را وارد نمی‌کنید. افزونه وب‌هوک امضاشده را خودکار تنظیم می‌کند و مشتری از رمزارزهای فعال روی درگاهی که به کلید API وصل است انتخاب می‌کند.

مشتری برگشته و سفارش هنوز پرداخت نشده است.

این طبیعی است. صفحهٔ بازگشت سفارش را پرداخت‌شده علامت نمی‌زند. ووی‌بیت فقط بعد از آنکه یک وب‌هوک امضاشده بگوید پرداخت شده یا اضافه پرداخت شده، سفارش را پرداخت‌شده می‌کند.

مشتری کدام رمزارزها را می‌تواند استفاده کند؟

صفحهٔ پرداخت میزبانی‌شده فقط رمزارزهایی را نشان می‌دهد که برای پرداخت آماده‌اند و روی درگاه، در داشبورد ووی‌بیت، فعال شده‌اند. مشتری یکی را انتخاب می‌کند و پیش از ساخته شدن دستور پرداخت، نرخ تبدیل فعلی را تأیید می‌کند.

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

تأیید کنید درگاه پرداخت فعال است، نشانی فروشگاه HTTPS است، کلید API به یک درگاه فعال وصل است، و ذخیرهٔ تنظیمات بدون پیام راه‌اندازی یکپارچه‌سازی تمام شده است. تسویه‌حساب کلاسیک و بلوک تسویه‌حساب هر دو از همین تنظیمات استفاده می‌کنند.

اگر محصولات به دلار آمریکا قیمت نخورده باشند، مشتری می‌تواند بپردازد؟

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

اگر این با فروشگاه من جور نبود با چه کسی تماس بگیرم؟

از طریق https://voybit.com/contact با پشتیبانی ووی‌بیت تماس بگیرید.

نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

توسعه دهندگان و همکاران

“درگاه پرداخت ووی‌بیت برای ووکامرس” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.

مشارکت کنندگان

“درگاه پرداخت ووی‌بیت برای ووکامرس” به 3 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمک‌هایشان.

ترجمه “درگاه پرداخت ووی‌بیت برای ووکامرس” به زبان شما.

علاقه‌ مند به توسعه هستید؟

کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.

گزارش تغییرات

1.2.4

  • برای توضیح تبدیل خودکار واحد پول، تومان را مثال بزنید.

1.2.3

  • هنگام باز شدن تسویه‌حساب ووی‌بیت، هر مبلغ فروشگاه که دلار آمریکا نیست به‌صورت خودکار به معادل دلار آمریکا تبدیل می‌شود.

1.2.2

  • متن فهرست افزونه انگلیسی ماند تا فارسی روی translate.wordpress.org ترجمه شود.

1.2.1

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

1.2.0

  • ووکامرس از راه سربرگ وابستگی وردپرس به‌عنوان افزونهٔ لازم اعلام شد.
  • پیام‌های راه‌اندازی داخل صفحهٔ تنظیمات پرداخت ووی‌بیت ماندند، نه در بخش گسترده‌تر مدیریت.
  • یک راهنمای تصویری و لینک‌دار برای ساخت حساب ووی‌بیت، درگاه و کلید API وصل به درگاه اضافه شد.

1.1.1

  • سربرگ افزونه، نسخهٔ بسته و برچسب پایدار WordPress.org هم‌تراز ماندند.
  • راهنمای WordPress.org برای راه‌اندازی خودکار وب‌هوک و پرداخت میزبانی‌شده با انتخاب خریدار به‌روز شد.

1.1.0

  • مشتری می‌تواند در صفحهٔ پرداخت میزبانی‌شدهٔ ووی‌بیت از رمزارزهای فعال همان درگاه انتخاب کند.
  • وب‌هوک امضاشده و نشانی بازگشت خودکار تنظیم می‌شوند؛ فیلدهای دستی شناسهٔ دارایی و رمز وب‌هوک حذف شدند.

1.0.2

  • آزمون‌های مخصوص توسعه از بستهٔ نصب بیرون ماند تا بررسی WordPress Plugin Check تمیز بماند.

1.0.1

  • فعال‌سازی پیش از نصب ووکامرس ممکن شد و گام‌های لازم راه‌اندازی در وردپرس نشان داده می‌شود.

1.0.0

  • انتشار نخست.