درگاه واسط وبمانی
درگاه واسط وبمانی
امکان جدیدی روی سایت فرهاد اکسچنج اضافه کرده ایم تا با استفاده ی از API بتوان از سایت فرهاد اکسچنج به عنوان درگاه واسط وبمانی – WebMoney Payment Gateway – استفاده کرد.
شرکت وب مانی، از طریق سایت MegaStock.ru درگاه مرچنت – Merchant Gateway – ارائه می کند. کسانی که مایلند درگاه اختصاصی وبمانی داشته باشند، لازم است که به این سایت مراجعه کنند و تقاضای درگاه اختصاصی وبمانی – Merchant Account – را بدهند.
آنچه ما روی API سایت فرهاد اکسچنج ارائه می کنیم صرفا یک درگاه واسط هست که عملیات دریافت و پرداخت وبمانی روی آن با نام فرهاد اکسچنج – FarhadExchange – انجام می شود و دریافت و ارسال اطلاعات صرفا از سایت https://farhadexchange.com انجام می شود. این امکان برای کسانی مناسب هست که به هر دلیل امکان استفاده از خدمات مستقیم Merchant وبمانی را ندارند و یا می خواهند از اعتبار سایت FarhadExchange.com در معاملات خود استفاده کنند.
در حال حاضر فقط API مربوط به دریافت وبمانی و ارسال وبمانی روی سایت فرهاد اکسچنج فعال شده است و با فعال شدن امکانات دیگر این API اطلاع رسانی خواهد شد (امکانات دیگر در حال حاضر غیر فعال هستند).
در این راهنما، استفاده از API ارسال و دریافت وبمانی از طریق Gateway وبمانی توضیح داده شده است. توجه به نکات زیر ضروری است:
- در این روش شما باید یک حساب وبمانی (حداقل فرمال) از خودتان داشته باشید و مشتری شما نیز باید حساب وبمانی (حداقل آلیاس) از خودش داشته باشد (باز کردن حساب وبمانی خیلی راحت هست). مشتری از طریق درگاه ما و به حساب ما وبمانی واریز می کند و بلافاصله به طور اتوماتیک، حساب وبمانی شما شارژ می شود. نحوه ی باز کردن حساب وبمانی در لینک زیر موجود است:
- از طریق این API می توانید با یک لینک یا فرم ساده، اطلاعات پرداخت را به صورت POST یا GET به سایت فرهاد اکسچنج منتقل کنید. سایت فرهاد اکسچنج شما را به درگاه وبمانی – به نام فرهاد اکسچنج – منتقل می کند. پرداخت از طریق درگاه وبمانی انجام می شود. بازگشت به سایت فرهاد اکسچنج انجام می شود، و اطلاعات موفق یا عدم موفق بودن پرداخت به صورت CallBack برای سایت شما ارسال می شود.
- کل پروسه بر اساس نیاز شما می تواند تمام اتوماتیک یا دستی انجام شود. توضیحات این راهنما بر این پیش فرض است که بخواهید کل مراحل را اتوماتیک انجام دهید. طبعا هر جا که بخواهید می توانید مرحله ی مورد نظر را دستی انجام دهید.
- واریز کاربر فقط به صورت وبمانی و از طریق درگاه وبمانی FarhadExchange خواهد بود اما برداشت شما از سایت ما می تواند به صورت وبمانی (تمام اتوماتیک)، پی پال (دستی) یا ریال (دستی) انجام شود. طبق قوانین شرکت وبمانی امکان برداشت به بیت کوین و یا پرفکت مانی را نخواهید داشت.
- زمینه ی فعالیت شما باید جزو فعالیت هایی باشد که توسط سایت وبمانی مجاز شمرده می شود. دسترسی کسانی که فعالیت غیر مجاز انجام دهند مسدود خواهد شد.
- ممکن است بر اساس شرایط جدید، برخی امکانات این API تغییر کند. تغییرات البته در همین راهنما بروز رسانی خواهد شد و استفاده کننده از API باید تغییرات جدید را در پروسه ی کاری خود اعمال نماید.
- در سایت ثبت نام کنید. نحوه ی ثبت نام در سایت فرهاد اکسچنج در لینک زیر توضیح داده شده است:
http://blog.farhadexchange.com/%D9%86%D8%AD%D9%88%D9%87-%D8%AB%D8%A8%D8%AA-%D9%86%D8%A7%D9%85-%D8%AF%D8%B1-%D9%88%D8%A8-%D9%85%D8%A7%D9%86%DB%8C/
راهنمای استفاده از API سایت فرهاد اکسچنج
http://blog.farhadexchange.com/%d9%86%d8%ad%d9%88%d9%87-%db%8c-%d8%ab%d8%a8%d8%aa-%d9%86%d8%a7%d9%85-%d8%af%d8%b1-%d8%b3%d8%a7%db%8c%d8%aa-%d9%81%d8%b1%d9%87%d8%a7%d8%af-%d8%a7%da%a9%d8%b3%da%86%d9%86%d8%ac/
۲٫ با مشخصات یوزرنیم و پسوردی که ساختید به سایت لاگین کنید و به لینک “لیست زیر مجموعه ها بروید و عدد مربوط به UID خود را یادداشت کنید. برای استفاده از API سایت فرهاد اکسچنج به این عدد احتیاج خواهید داشت. در مثال شکل زیر UID برابر با ۹۸ می باشد. این عدد شماره ی کاربری شما در سایت فرهاد اکسچنج می باشد. توجه کنید که شماره ی کاربری -UID – با نام کاربری – UserName – تفاوت دارد.
۳٫ اکنون روی سایت خود لینک یا فرمی ایجاد کنید که متغیرهای زیر را به صورت POST یا GET به آدرس زیر در سایت ما بفرستد:
https://farhadexchange.com/exchange_step.php
متغیرهای قابل استفاده عبارتند از:
UUID (اختیاری): عدد مربوط به UID شما. برای اینکه کلیه ی دریافتی و پرداختی ها در کنترل پنل شما ضبط شود، لازم است این عدد به لینک مربوطه ارسال گردد. چنانچه این عدد ارسال نشود، امکان پیگیری دریافتی و پرداختی خود را از طریق کنترل پنل خودتان در سایت فرهاد اکسچنج نخواهید داشت.
SRC_AMOUNT (اجباری): مقدار دلاری که قصد دریافت آن را از مشتری دارید. مشتری شما باید حساب وبمانی از خودش داشته باشد و مبلغ مربوطه در حسابش موجود باشد تا بتواند از طریق درگاه واسط فرهاد اکسچنج، مبلغ را پرداخت کند. این عدد می تواند تا دو رقم اعشار داشته باشد.
توجه: سیستم ما ۲٫۲ درصد کارمزد از مبلغ فوق کسر می کند و ۰٫۸ درصد نیز کارمزد شرکت وبمانی هست. بنابراین روی هم رفته شما ۳ درصد کارمزد پرداخت می کنید. وقتی مثلا عدد مربوط به SRC_AMOUNT مقدار ۱۰۰ دلار وبمانی باشد، بعد از پرداخت موفقیت آمیز مشتری شما، حساب وبمانی شما به طور اتوماتیک ۹۷ دلار شارژ خواهد شد.
CALLBACK (اختیاری): یک URL همانند مثال بدون http (مثل : farhadexchange.net) . اگر می خواهید پس از پرداخت موفق یا ناموفق مشتری، اطلاعات کامل به سایت شما ارسال شود، این متغیر حتما باید ارسال شود. اگر سایت شما اتوماتیک نیست و احتیاج به برگشت اطلاعات ندارید و می خواهید پرداخت های مشتریان را از کنترل پنل خودتان روی سایت ما – فرهاد اکسچنج – چک بفرمایید، ارسال این متغیر لازم نیست.
API_REFERENCE (اختیاری): شماره سفارشی است که شما به هر مشتری اختصاص می دهید. می تواند عددی از یک رقم تا بیست رقم باشد. قاعدتا باید یک عدد منحصر بفرد باشد تا هر تراکنش روی سایت شما از تراکنش دیگر متمایز شود. این عدد با شماره تراکنش منحصر به فردی که سایت ما به تراکنش شما اختصاص می دهد متفاوت است.
srcID (اجباری) : عدد مربوط به وبمانی دریافتی از مشتری که باید ۹ انتخاب شود. این عدد را مساوی با ۹ می باشد. (srcID=9)
dstID (اجباری): عدد مربوط به ارز دریافتی. در این راهنما شما وبمانی از مشتری می گیرید و از ما به طور اتوماتیک وبمانی دریافت می کنید بنابراین این عدد را با شماره ی ۱۱ بفرستید (dstID=11)
DST_ACCOUNT (اجباری): شماره کیف وبمانی خودتان یا شماره کیف وبمانی مقصد را می فرستید. شماره کیف دلاری وبمانی با حرف Z انگلیسی شروع می شود. پس از دریافت وبمانی از کاربر شما، ما بلافاصله و به طور اتوماتیک وبمانی دریافت شده را به این حساب وبمانی واریز می کنیم.
STEP (اجباری): این متغیر باید روی goTopaY تنظیم شود (STEP=goTopaY)
EMAIL (اختیاری): جزییات هر خرید و فروش به صورت پیش فرض به ایمیل ثبت شده ی شما در سایت فرهاد اکسچنج ارسال می شود (در صورتیکه متغیر UUID را ارسال کرده باشید). لیکن چنانچه UUID را ارسال نکرده باشید، با ارسال متغیر EMAIL و تعریف یک ایمیل معتبر برای آن، جزییات تراکنش به این ایمیل ارسال خواهد شد.
۴٫ مشتری شما با ثبت فرم یا لینکی که شما با متغیرهای بالا در اختیارش گذاشته اید، به سایت ما – فرهاد اکسچنج – هدایت می شود، با قوانین و مقررات سایت ما موافقت می کند و مبلغ وبمانی مربوطه را پرداخت می کند. پس از پرداخت دوباره به سایت ما بازمی گردد و سایت ما جزییات تراکنش را به صورت CallBack برای سایت شما ارسال می کند.
جزییات ارسال شده به صورت POST هستند. در CallBack اطلاعات و جزییات زیر به URL که شما در مرحله ی قبل برای ما فرستاده بودید ارسال می شود:
referenceid : شماره تراکنش منحصر بفردی که سایت ما به تراکنش اختصاص داده است. از طریق این شماره تراکنش شما همیشه به جزییات تراکنش دسترسی خواهید داشت. کافی است این لینک را Call کنید تا جزییات تراکنش و CallBack برای شما مجددا ارسال شود.
https://farhadexchange.com/exchange_status.php?referenceid=111111111
که بجای ۱۱۱۱۱۱۱۱۱ باید شماره سفارش مربوطه را قرار دهید. شماره سفارش ها روی سایت فرهاد اکسچنج اعداد ۹ رقمی هستند. بهتر است از طریق لینک فوق مقادیر مربوط به CallBack دوباره فراخوان شوند تا احتمال هر گونه دخالت هکرها در سیستم شما به صفر برسد.
API_REFERENCE : شماره سفارش منحصر بفرد که شما در هنگام ارسال درخواست برای سایت ما فرستاده اید. بهتر است جزییات مربوط به این سفارش را از روی دیتا بیس سایت خود با مقادیر CallBack چک کنید که امکان هر گونه حملات هکری به صفر برسد.
SRC_AMOUNT: مقدار وبمانی که مشتری به حساب ما واریز کرده است. این مقدار یک عدد و به دلار -WMZ – می باشد. باید چک شود که این مقدار با مقدار مورد نظر شما یکی باشد.
srcID: همانطور که قبلا گفتیم باید مساوی با عدد ۹ باشد.
dstID: همانطور که قبلا گفتیم باید مساوی با عدد ۱۱ باشد.
SRC_STATUS: مقدار صفر برای این متغیر به این معنی است که تراکنش ناموفق بوده و ما از مشتری شما وبمانی دریافت نکرده ایم. مقدار یک برای این متغیر به این معنی است که تراکنش موفق بوده و ما از مشتری شما وبمانی مربوطه را دریافت کرده ایم.
DST_STATUS: مقدار صفر برای این متغیر به این معنی است که وبمانی از حساب ما به حساب شما منتقل نشده است. مقدار یک برای این متغیر به این معنی است که تراکنش کاملا اتوماتیک و با موفقیت انجام شده است. یعنی هم وبمانی از مشتری شما دریافت شده و هم وبمانی مربوطه با موفقیت به حساب وبمانی شما منتقل شده است.
DST_AMOUNT: مقدار وبمانی دلاری که به حساب شما منتقل شده است. ما از مقدار وبمانی دریافت شده از مشتری، با کسر کارمزد، این مبلغ را به حساب وبمانی شما منتقل می کنیم.
DST_ACCOUNT: حساب گیرنده ی وبمانی که قاعدتا باید شماره کیف وبمانی شما باشد.
SRC_ACCOUNT: حساب فرستنده ی وبمانی که قاعدتا باید حساب وبمانی مشتری شما باشد.
SRC_BATCH: شماره تراکنش وبمانی دریافت شده از کیف مشتری شما
DST_BATCH: شماره تراکنش وبمانی ارسال شده به کیف وبمانی شما
درگاه واسط وبمانی - تمام اتوماتیک - تسویه در همان لحظه
