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

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

OpenAPI
GET/merchant-network-api/v1/merchants/{merchant_id}

پروفایل پذیرنده را برمی‌گرداند. فقط با شناسهٔ رینگ‌پی کار می‌کند؛ برای پیدا کردن پذیرنده با شناسهٔ سامانهٔ خودتان فهرست پذیرنده‌ها را با external_id بخوانید.

GET /merchant-network-api/v1/merchants/{merchant_id}
curl "$RINGPAY_BASE_URL/merchant-network-api/v1/merchants/86Rf07xd4z" \
  -H "Authorization: Bearer $RINGPAY_API_KEY"
Response 200
{
  "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

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

صفحه‌ها

endpointها