API شبکهٔ پذیرنده › پذیرنده
لینک ورود به پنل
/merchant-network-api/v1/merchants/login-linkیک لینک یکبارمصرف ورود به پنل پذیرنده برای مالک میسازد و لینک قبلی را، استفادهشده یا نه، باطل میکند. وقتی کاربر در سامانهٔ شما روی «پنل پذیرنده» میزند آن را بسازید و همان لحظه کاربر را به login_url بفرستید.
پذیرنده را با merchant_id، external_id یا هر دو مشخص کنید؛ اگر هر دو را بفرستید باید به یک پذیرنده برسند، وگرنه 422 merchant_id_mismatch.
curl -X POST "$RINGPAY_BASE_URL/merchant-network-api/v1/merchants/login-link" \
-H "Authorization: Bearer $RINGPAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"merchant_id": "86Rf07xd4z"
}'{
"expires_at": "2026-11-02T09:02:00Z",
"login_url": "https://panel.ring.ir/home?login_token=…",
"merchant_id": "86Rf07xd4z"
}پارامترها
merchant_idstringدستکم یکیشناسهٔ پذیرنده در رینگپی.
external_idstringدستکم یکیشناسهٔ پذیرنده در سامانهٔ شما. حداکثر 128 نویسه.
پاسخ
login_url لینک یکبارمصرف ورود مالک به پنل پذیرنده است و تا expires_at، یعنی دو دقیقه، اعتبار دارد. همان لحظه کاربر را به آن بفرستید و لینک را ذخیره یا پیامک نکنید.
خطاها
کدهای مشترک و رفتار هر کد در خطاها آمده.
invalid_request400بدنه یا پارامترها نامعتبرند؛ مثلاً مبلغ صفر، موبایل بدون قالب E.164،
callback_urlبدون https یاcursorساختگی.invalid_access_key401کلید فرستاده نشده، نامعتبر است، منقضی شده یا باطل شده.
access_denied403کلید دسترسی این API را ندارد (
gateway_accessبرای درگاه،merchant_accessبرای پذیرندهها)، یا درخواست از IPی بیرون از فهرست مجاز کلید آمده.merchant_not_found404پذیرندهای با این شناسه در شبکهٔ شما نیست.
merchant_id_mismatch422merchant_idوexternal_idبه یک پذیرنده نمیرسند.internal_error500خطای رینگپی. کمی بعد همان درخواست را تکرار کنید.