توضیح تصویر
بسیاری از سایت‌ها با زبان برنامه نویسی php پیاده سازی شده اند، نمونه کد زیر به سادگی سایت PHP شما را به درگاه پرداخت متصل می‌کند. برای درک بهتر کدها و نحوه api درگاه پرداخت پیشنهاد می‌شود، مستندات مربوط به آن نیز را مطالعه نمایید.

در نمونه کد، سه فایل با نام‌های index , Ir_Gateway_RayanPAY و verify وجود دارد.

دانلود نمونه کد PHP برای درگاه پرداخت اینترنتی

فایل index

مربوط به طراحی فرم و دریافت اطلاعات از کاربر برای سفارش محصول می‌باشد، اطلاعات قیمت و شماره موبایل دو فیلد مهم برای ارتباط با درگاه می باشد که اگر این فیلد به درستی ارسال نشود، به درگاه متصل نخواهید شد. توجه داشته باشید قیمت ارسالی به ریال است و شماره موبایل نیز باید به فرمت 989XXXXXXXXX وارد شود. در غیر این صورت با خطای اتصال به درگاه خطا دارد (پرداخت ناموفق) مواجه خواهید شد.

در فراخوانی تابع درخواست پرداخت نیاز است که سه ورودی مبلغ،شماره موبایل و آدرس برگشتی از درگاه، ارسال شود.

request($amount, $mobile, $callbackUrl)

متغییر callbackUrl آدرس صفحه ای می‌باشد که کاربر بعد از درگاه پرداخت مشاهده خواهد کرد و الزامی است، در نمونه کد آدرس فایل verify در نظر گرفته شده است.

فایل Ir_Gateway_RayanPAY

این فایل برقراری ارتباط با درگاه پرداخت را با API رایان پی فراهم می‌کند. در گام اول شما باید مقادیر مربوط به درگاه خود را تنظیم نمایید.

public $username = 'کد مشتری';
public $password = 'رمز مشتری';
public $clientId = 'شناسه یکتا';

این اطلاعات، بعد از ثبت نام در رایان پی و دریافت درگاه پرداخت برای شما ایمیل شده است. اگر اطلاعات به درستی وارد نشده باشد شما با خطای "کد کاربری/رمز عبور /کلاینت/آی پی نامعتبر است" مواجه خواهید شد.

فایل verify

زمانی که کاربر به درگاه پرداخت متصل شود، صرف نظر از اینکه پرداخت موفق و یا ناموفق داشته باشد،اطلاعات این فایل به کاربر نمایش داده می‌شود. در این فایل شما می‌توانید تشکر از خرید در زمان پرداخت موفق و یا اطلاعاتی در جهت پیگیری تراکنش انجام شده و... در اختیار کاربر قرار دهید.