API شبکهٔ پذیرنده › پذیرنده
موجودیت پذیرنده
پذیرنده کسبوکاری است که شبکهٔ شما در رینگپی ثبت کرده. دریافت پذیرنده پروفایل کامل را برمیگرداند و فهرست پذیرندهها برای هر پذیرنده وضعیت و تاریخ عضویت را.
{
"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"
}{
"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توضیح کوتاه دربارهٔ کسبوکار.
linkstringلینک خود پذیرنده؛ مثلاً سایتش.
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زمان ثبت پذیرنده.