مستندات فنی پذیرندگان (API)
هر آنچه برای اتصال فروشگاه آنلاین شما به درگاه پرداخت اعتباری راتک لند نیاز است: راهنمای جامع پیاده‌سازی، کالکشن Postman و نمونه‌کدهای آماده.
راهنمای جداگانهٔ نمایه کالا برای دیده شدن در جستجوراهنمای جامع اتصال (PDF)
سند مرجع پیاده‌سازی — نسخه ۲.۰؛ شامل قرارداد کامل API، جریان پرداخت، ماشین وضعیت، پروتکل ضد مغایرت و کدهای خطا.
کالکشن Postman
تمام سرویس‌ها با نمونه‌درخواست آماده؛ کافی است base_url و کلیدهای صادرشده را تنظیم و چرخهٔ کامل را تست کنید.
پکیج کامل توسعه‌دهنده
راهنمای PDF + کالکشن Postman + نمونه‌کدهای چهار زبان، در یک فایل فشرده برای تحویل به تیم فنی.
نمونه‌کدهای آماده
پیاده‌سازی کامل چرخهٔ پرداخت (دریافت توکن، ایجاد جلسه، تأیید و نهایی‌سازی) در چهار زبان/ابزار رایج:
نگاهی به سرویس‌ها
درگاه پرداخت اعتباری راتک لند یک REST API با احراز هویت JWT است. قالب همهٔ پاسخ‌ها یکسان است ({ ok, data } / { ok, error }) و جزئیات کامل هر سرویس در راهنمای PDF آمده است:
- POST
/api/v1/auth/tokenدریافت توکن دسترسی (JWT) - GET
/api/v1/credit-offers/eligibilityبررسی امکان پرداخت اعتباری - POST
/api/v1/credit-payments/initiateایجاد جلسهٔ پرداخت - POST
/api/v1/credit-payments/confirmتأیید سفارش - POST
/api/v1/credit-payments/finalizeنهایی‌سازی سفارش - POST
/api/v1/credit-payments/reverseبرگشت تراکنش - POST
/api/v1/credit-payments/voidابطال سفارش نهایی‌شده - POST
/api/v1/credit-payments/amendاصلاح مبلغ سفارش - GET
/api/v1/credit-payments/statusاستعلام وضعیت تراکنش
نکته: پس از پرداخت مشتری، نتیجه از طریقcallbackUrlبه سرور شما بازگردانده می‌شود و نهایی‌سازی سفارش فقط با فراخوانی سرویس‌هایconfirm وfinalizeمعتبر است — به هیچ‌وجه به تنهایی به بازگشت کاربر اعتماد نکنید.
مسیر اتصال در چهار گام
صدور کلید تست
از پنل پذیرنده، بخش «کلیدهای API»، اعتبارنامهٔ محیط تست (Staging) را دریافت کنید.
پیاده‌سازی
با کالکشن Postman و نمونه‌کدها، چرخهٔ کامل پرداخت را در محیط تست پیاده‌سازی کنید.
دموی فنی
جلسهٔ pre-demo با کارشناسان فنی راتک‌لند و مرور سناریوهای موفق و ناموفق.
صدور کلید پروداکشن
پس از تأیید دمو، اعتبارنامهٔ پروداکشن صادر و IP سرور شما در وایت‌لیست ثبت می‌شود.
هنوز پذیرندهٔ راتک لند نیستید؟ از اینجا ثبت‌نام کنید و پس از فعال‌سازی، کلیدهای API را از پنل پذیرنده دریافت کنید.