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

موجودیت پذیرنده

OpenAPI

پذیرنده کسب‌وکاری است که شبکهٔ شما در رینگ‌پی ثبت کرده. دریافت پذیرنده پروفایل کامل را برمی‌گرداند و فهرست پذیرنده‌ها برای هر پذیرنده وضعیت و تاریخ عضویت را.

The merchant object
{
  "merchant_id": "86Rf07xd4z",
  "external_id": "shop-1",
  "title": "فروشگاه نمونه",
  "description": "لوازم خانگی",
  "link": "https://shop.example.com",
  "logo_url": "https://shop.example.com/logo.png",
  "kyc_status": "accepted"
}
The merchant object · list item
{
  "merchant_id": "86Rf07xd4z",
  "external_id": "shop-1",
  "title": "فروشگاه نمونه",
  "logo_url": "https://shop.example.com/logo.png",
  "status": "activated",
  "kyc_status": "accepted",
  "joined_at": "2026-11-01T08:00:00Z"
}

در دریافت پذیرنده

  • merchant_idstring

    شناسهٔ پذیرنده در رینگ‌پی.

  • external_idstring

    شناسهٔ پذیرنده در سامانهٔ شبکهٔ شما.

  • titlestring

    نام کسب‌وکار، همان که مشتری در صفحهٔ پرداخت می‌بیند.

  • descriptionstring

    توضیح کوتاه دربارهٔ کسب‌وکار.

  • logo_urlstring

    آدرس لوگو.

  • kyc_statusenum

    وضعیت احراز هویت مالک.

    • pending

      مدارک احراز هویت هنوز تأیید نشده؛ برداشت وجه ممکن نیست.

    • accepted

      احراز هویت تأیید شده.

در فهرست پذیرنده‌ها

هر عضو items در پاسخ فهرست.

  • merchant_idstring

    شناسهٔ پذیرنده در رینگ‌پی.

  • external_idstring

    شناسهٔ پذیرنده در سامانهٔ شبکهٔ شما.

  • titlestring

    نام کسب‌وکار.

  • logo_urlstring

    آدرس لوگو.

  • statusenum

    وضعیت پذیرنده در رینگ‌پی.

    • registered

      ثبت شده ولی هنوز فعال نشده؛ صورت‌حساب برایش ساخته نمی‌شود (409 merchant_not_payable).

    • activated

      فعال؛ می‌تواند پرداخت بگیرد.

    • blocked

      مسدود؛ پرداخت نمی‌گیرد.

  • kyc_statusenum

    وضعیت احراز هویت مالک.

    • pending

      مدارک احراز هویت هنوز تأیید نشده.

    • accepted

      احراز هویت تأیید شده.

  • joined_atstring

    زمان ثبت پذیرنده.

صفحه‌ها

endpointها