# درگاه پرداخت
این مستند چگونگی پرداخت الكترونیك در محیط وب از جانب فروشگاه‌های اینترنتی و با استفاده از درگاه پرداخت زرین‌پال را شرح می‌دهد. این سرویس برای انجام پرداخت الکترونیک از روش استاندارد 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 و به صورت امن خواهد بود. دارا بودن این گواهینامه برای پذیرنده اجباری نیست، اما داشتن آن به نفع خریدار و پذیرنده خواهد بود.
همچنین پذیرنده و زرین‌پال نباید از هیچ کدام از اطلاعات مالی خریدار مانند شماره كارت، رمز كارت، میزان موجودی و غیره مطلع شوند. به همین دلیل پذیرنده و زرین‌پال از خریدار هیچ نوع اطلاعات مالی و بانکی دریافت نمی‌كنند و تمامی این اطلاعات شخصا توسط خریدار در درگاه پرداخت اینترنتی وارد می‌شود.