API شبکهٔ پذیرنده › پذیرنده
دریافت پذیرنده
GET
/merchant-network-api/v1/merchants/{merchant_id}پروفایل پذیرنده را برمیگرداند. فقط با شناسهٔ رینگپی کار میکند؛ برای پیدا کردن پذیرنده با شناسهٔ سامانهٔ خودتان فهرست پذیرندهها را با external_id بخوانید.
curl "$RINGPAY_BASE_URL/merchant-network-api/v1/merchants/86Rf07xd4z" \
-H "Authorization: Bearer $RINGPAY_API_KEY"{
"description": "لوازم خانگی",
"external_id": "shop-1",
"kyc_status": "accepted",
"link": "https://shop.example.com",
"logo_url": "https://shop.example.com/logo.png",
"merchant_id": "86Rf07xd4z",
"title": "فروشگاه نمونه"
}پارامترها
merchant_idstringالزامیشناسهٔ پذیرنده در رینگپی.
پاسخ
موجودیت پذیرنده. پذیرندهٔ شبکهٔ دیگر 404 merchant_not_found میگیرد.
خطاها
کدهای مشترک و رفتار هر کد در خطاها آمده.
invalid_access_key401کلید فرستاده نشده، نامعتبر است، منقضی شده یا باطل شده.
access_denied403کلید دسترسی این API را ندارد (
gateway_accessبرای درگاه،merchant_accessبرای پذیرندهها)، یا درخواست از IPی بیرون از فهرست مجاز کلید آمده.merchant_not_found404پذیرندهای با این شناسه در شبکهٔ شما نیست.
internal_error500خطای رینگپی. کمی بعد همان درخواست را تکرار کنید.