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