توسعه دهندگان

استفاده از درگاه ردپی

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

افزونه‌ها
نمونه کد
نمونه کد استفاده از وب سرویس - ردپی

نمونه کد استفاده از وب سرویس
وردپرس
جوملا
فروشگاه ساز ها
سایر
متد ساخت فاکتور

قبل از هدایت کردن پرداخت کننده به صفحه پرداخت ، پذیرنده باید یک فاکتور بسازد. برای این کار از متد "ساخت فاکتور" استفاده میشود. این متد شامل 4 ورودی به شرح جدول زیر میباشد.

apikey کلید ارتباط 20 کاراکتری
in factor فاکتور یکتای داخلی نهایتا 35 کاراکتری
amount مقدار واریزی به تومان بین 2,000 و 50,000,000 تومان
callback آدرس برگشت به سایت پذیرنده نهایتا 150 کاراکتری
language گزینه های موجود per - eng (اختیاری)

از language برای تغییر زبان صفحه پرداخت استفاده میشود، مقدار پیش فرض آن per یا همان زبان فارسی (تومان) است ، در صورتی که مقدار ارسال شده eng باشد زبان صفحه پرداخت انگلیسی و مبالغ به دلار نمایش داده خواهند شد.

مقادیر برگشتی شامل موارد زیر است:

0 دستور یافت نشد
1 دستور صحیح است
4 آی پی شما مسدود شده است
5 کلید ارتباط صحیح نیست
6 مقدار باید بین 2,000 و 50,000,000 تومان باشد
7 فاکتور داخلی قبلا ثبت شده است
8 کلید ارتباط صحیح نیست
9 فاکتور داخلی نهایتا میتواند 35 کاراکتری باشد
10 آدرس برگشت باید کمتر از 150 کاراکتری باشد
11 آدرس برگشت معتبر نیست
12 کلید ارتباط غیرفعال است

در صورتی که دستور صحیح باشد ، مقادیر زیر هم ارسال میشود

outFactor فاکتور خارجی
toman مبلغ به تومان
btc مقدار بیت کوین
btc_fee کارمزد تراکش شبکه بیت کوین (که از مشتری دریافت میشود)
pay_fee کارمزد تراکش ردپی (که از پذیرنده دریافت میشود)

بعد از دریافت "outFactor" ، پرداخت کننده را به آدرس "https://www.rodpay.com/bitgate/outFactor" انتقال دهید.



محاسبه مبلغ برای نمایش دلار

اگر کالا یا خدماتی ارایه میدهید که مبلغ آن در سایت شما 40 دلار است برای نمایش این عدد در صفحه پرداخت ، مقدار مربوط به "amount" را در 4000 ضرب کنید.

amount = 40 $ x 4000

متد بررسی فاکتور

بعد از پرداخت و دریافت تایید (confirm) مورد نیاز ، پرداخت کننده لینک برگشت به سایت پذیرنده (فروشگاه یا ارایه دهنده خدمات) را دریافت میکند. وبسایت پذیرنده با متد بررسی فاکتور اقدام به تشخیص درستی پرداخت میکند. این متد شامل 2 ورودی به شرح جدول زیر میباشد.

apikey کلید ارتباط
out factor رشته 32 کاراکتری دریافتی از متد ساخت فاکتور

مقادیر برگشتی شامل موارد زیر است:

0 دستور یافت نشد
1 پرداخت موفق بود
4 آی پی شما مسدود شده است
5 کلید ارتباط یا فاکتور صحیح نیست
6 این فاکتور قبلا بررسی شده است
7 این فاکتور پرداخت نشده است
8 خطا

در صورتی که دستور صحیح باشد ، مقادیر زیر هم ارسال میشود

toman مبلغ به تومان
btc مقدار بیت کوین