مستندات
این مستند چگونگی پرداخت الكترونیك در محیط وب از جانب فروشگاههای اینترنتی و با استفاده از درگاه پرداخت فینوپال را شرح میدهد. این سرویس برای انجام پرداخت الکترونیک از روش استاندارد web service بر روی پروتكل امن https استفاده کرده و راهی برای پرداخت خریداران از طریق كارتهای عضو شبکه شتاب را فراهم میکند. هدف از ارائه این سند، معرفی سرویسهای به هم پیوستهای میباشد كه مجموعه خدمات درگاه پرداخت اینترنتی فینوپال برای پذیرنده را شكل میدهند. محدوده این سند، شرح كلی عملیات لازم برای انجام عملیات پرداخت درخواستی از سوی پذیرنده روی درگاه پرداخت اینترنتی فینوپال است و در كنار آن، تمامی متدهای مربوط به این عملیات شرح داده شده اند. این سند شامل شرح كلی موارد موردنیاز برای درخواست عملیات پرداخت از سوی پذیرنده روی درگاه پرداخت اینترنتی فینوپال است؛ علاوه بر آن، تمامی متدهای مربوط به این عملیات نیز توضیح داده شده اند.
واژگان
- پذیرنده: شخص ، سازمان و یا شركتی كه محصول یا سرویسی را از در بستر اینترنت ارائه میكند.
- خریدار: شخص دارنده كارتهای بانکی عضو شبکه شتاب كه قصد دارد از پذیرنده، کالا یا خدماتی را به صورت اینترنتی خرید کند.
- تراكنش: یك عملیات مالی است، كه در این سند مصداق آن یك خرید اینترنتی میباشد.
اطلاعات فنی سیستم
- کد درگاه پرداخت merchant_id: كدی یكتا و 24 كاراكتری است كه فینوپال به ازای هر درخواست درگاه پرداخت به پذیرنده اختصاص میدهد.
- آدرس آیپی IP پذیرنده: آدرس IP Main Server وبسایت پذیرنده كه شخص پذیرنده میباید از طریق ورود به قسمت راهنمای اتصال، بخش نمونه کدها، فایلها و آموزشهای لازم برای دریافت آیپی صحیح را دریافت کرده و آن را به وبسایت فینوپال اعلام كند.
- شناسهی مرجع Authority: آتوریتی یک شناسهی یکتاست که وبسایت فینوپال به ازای هر درخواست خرید به پذیرنده ارسال میكند، جنس این پارامتر از نوع UUID universally unique identifier بوده كه مطابق RFC با طول 35 كاراكتر و String میباشد که با حرف FP شروع میشود.
- وضعیت Code: عددی است كه توسط وب سرویس فینوپال به عنوان وضعیت تراكنش به پذیرنده نمایش داده میشود.
- شماره تراكنش خرید ref_id: شناسهی یکتایی كه فینوپال بعد از اتمام موفق تراكنش به پذیرنده ارائه میدهد. این شناسه جهت پیگیریهای مالی استفاده میشود.
- توضیحات تراکنش description: متنی که به صورت خلاصه توسط پذیرنده برای معرفی کالا یا خدماتی که قصد فروش آن را دارد، نوشته می شود.
- شماره تماس خریدار mobile: توسط پذیرنده در وبسرویس تعیین میشود كه جهت سهولت در پیگیریهای پس از پرداخت استفاده خواهد شد؛ این پارامتر اختیاری است.
- ایمیل خریدار email: توسط پذیرنده در وبسرویس تعیین میشود كه جهت سهولت در پیگیریهای پس از پرداخت استفاده خواهد شد؛ این پارامتر اختیاری است.
- آدرس بازگشت callback_url: آدرسی که بعد از پایان عملیات در سمت فینوپال خریدار به آنجا بازگشت داده میشود.
نیازمندی های امنیتی
-
از آنجاییکه وبسایت فینوپال دارای گواهینامه SSL معتبر است، ارتباط خریدار با فینوپال و همچنین ارتباط پذیرنده با فینوپال میتواند در بستر SSL انجام شود. چنانچه پذیرنده نیز دارای گواهینامه SSL معتبر باشد، ارتباط بین خریدار و پذیرنده نیز در بستر SSL و به صورت امن خواهد بود. دارا بودن این گواهینامه برای پذیرنده اجباری نیست، اما داشتن آن به نفع خریدار و پذیرنده خواهد بود.
-
همچنین پذیرنده و فینوپال نباید از هیچ کدام از اطلاعات مالی خریدار مانند شماره كارت، رمز كارت، میزان موجودی و غیره مطلع شوند. به همین دلیل پذیرنده و فینوپال خریدار هیچ نوع اطلاعات مالی و بانکی دریافت نمیكنند و تمامی این اطلاعات شخصا توسط خریدار در درگاه پرداخت اینترنتی وارد میشود.