‏API شبکهٔ پذیرنده › پذیرنده

لینک ورود به پنل

OpenAPI
POST/merchant-network-api/v1/merchants/login-link

یک لینک یک‌بارمصرف ورود به پنل پذیرنده برای مالک می‌سازد و لینک قبلی را، استفاده‌شده یا نه، باطل می‌کند. وقتی کاربر در سامانهٔ شما روی «پنل پذیرنده» می‌زند آن را بسازید و همان لحظه کاربر را به login_url بفرستید.

پذیرنده را با merchant_id، external_id یا هر دو مشخص کنید؛ اگر هر دو را بفرستید باید به یک پذیرنده برسند، وگرنه 422 merchant_id_mismatch.

POST /merchant-network-api/v1/merchants/login-link
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"
  }'
Response 200
{
  "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_mismatch422

    merchant_id و external_id به یک پذیرنده نمی‌رسند.

  • internal_error500

    خطای رینگ‌پی. کمی بعد همان درخواست را تکرار کنید.

صفحه‌ها

endpointها