unVerified

جهت استفاده از خدمات وب‌سرویس فینوپال باید از آدرس‌های وب‌سرویس، متد ها و پارامترهای ذکر شده استفاده نمایید.

افزونه‌ها

از نسخه‌ فعلی فینوپال، یک رابط برنامه‌نویسی (API) برای ارائه‌ی خدمات به مشتریان تحت پروتکل oAuth 2.0 و زبان پرس‌و‌جوی GraphQL (opens new window) معرفی و در دسترس قرار داده شده است.

مستندات API

از نسخه‌ فعلی فینوپال، یک رابط برنامه‌نویسی (API) برای ارائه‌ی خدمات به مشتریان تحت پروتکل oAuth 2.0 و زبان پرس‌و‌جوی GraphQL (opens new window) معرفی و در دسترس قرار داده شده است.

با استفاده از اینAPI، می‌توانید تغییراتی در حساب‌های کاربری احراز هویت‌شده مانند ایجاد تیکت، تأیید مدارک و مشخصات، ایجاد درگاه پرداخت و غیره ایجاد کنید.

Javascript

                        
                            // Source - https://stackoverflow.com/a/30810322
                            // Posted by Dean Taylor, modified by community. See post 'Timeline' for change history
                            // Retrieved 2026-02-16, License - CC BY-SA 4.0
                            
                            function fallbackCopyTextToClipboard(text) {
                            var textArea = document.createElement("textarea");
                            textArea.value = text;
                            
                            // Avoid scrolling to bottom
                            textArea.style.top = "0";
                            textArea.style.left = "0";
                            textArea.style.position = "fixed";
                            
                            document.body.appendChild(textArea);
                            textArea.focus();
                            textArea.select();
                            
                            try {
                            var successful = document.execCommand('copy');
                            var msg = successful ? 'successful' : 'unsuccessful';
                            console.log('Fallback: Copying text command was ' + msg);
                            } catch (err) {
                            console.error('Fallback: Oops, unable to copy', err);
                            }
                            
                            document.body.removeChild(textArea);
                            }
                        
                    

درگاه پرداخت

این مستند چگونگی پرداخت الكترونیك در محیط وب از جانب فروشگاه‌های اینترنتی و با استفاده از درگاه پرداخت فینوپال را شرح می‌دهد. این سرویس برای انجام پرداخت الکترونیک از روش استاندارد web service بر روی پروتكل امن https استفاده کرده و راهی برای پرداخت خریداران از طریق كارت‌های عضو شبکه شتاب را فراهم می‌کند. هدف از ارائه این سند، معرفی سرویس‌های به هم پیوسته‌ای می‌باشد كه مجموعه خدمات درگاه پرداخت اینترنتی فینوپال برای پذیرنده را شكل می‌دهند. محدوده این سند، شرح كلی عملیات لازم برای انجام عملیات پرداخت درخواستی از سوی پذیرنده روی درگاه پرداخت اینترنتی فینوپال است و در كنار آن، تمامی متدهای مربوط به این عملیات شرح داده شده اند. این سند شامل شرح كلی موارد موردنیاز برای درخواست عملیات پرداخت از سوی پذیرنده روی درگاه پرداخت اینترنتی فینوپال است؛ علاوه بر آن، تمامی متدهای مربوط به این عملیات نیز توضیح داده شده اند.

  • پذیرنده: شخص ، سازمان و یا شركتی كه محصول یا سرویسی را از در بستر اینترنت ارائه می‌كند.
  • خریدار: شخص دارنده كارت‌های بانکی عضو شبکه شتاب كه قصد دارد از پذیرنده، کالا یا خدماتی را به صورت اینترنتی خرید کند.
  • تراكنش: یك عملیات مالی است، كه در این سند مصداق آن یك خرید اینترنتی می‌باشد.
  1. همچنین پذیرنده و فینوپال نباید از هیچ کدام از اطلاعات مالی خریدار مانند شماره كارت، رمز كارت، میزان موجودی و غیره مطلع شوند. به همین دلیل پذیرنده و فینوپال از خریدار هیچ نوع اطلاعات مالی و بانکی دریافت نمی‌كنند و تمامی‌ این اطلاعات شخصا توسط خریدار در درگاه پرداخت اینترنتی وارد می‌شود.
  2. از آنجایی‌که وب‌سایت فینوپال دارای گواهینامه‌ SSL معتبر است، ارتباط خریدار با فینوپال و هم‌چنین ارتباط پذیرنده با فینوپال می‌تواند در بستر SSL انجام شود. چنانچه پذیرنده نیز دارای گواهینامه SSL معتبر باشد، ارتباط بین خریدار و پذیرنده نیز در بستر SSL و به صورت امن خواهد بود. دارا بودن این گواهینامه برای پذیرنده اجباری نیست، اما داشتن آن به نفع خریدار و پذیرنده خواهد بود.