पार्टनर लिंकिंग विधियाँ

अलग-अलग पार्टनर या सदस्य प्रबंधन सिस्टम हर सुविधा या स्थान की पहचान अपनी स्वयं की ID से करते हैं, जैसे ब्रांच ID, स्टोर नंबर या सुविधा ID। डेटा को सिंक करने या पुश करने के दौरान स्थानों की पहचान करने के हमारे पास दो तरीके हैं।

1. डायरेक्ट लिंक

डेटा पुश करते समय, पार्टनर Performance Hub सिस्टम की सुविधा ID का उपयोग करेगा।

उदाहरण के लिए, Partner A के लिए टोक्यो में स्थित एक सुविधा की आंतरिक ID branch_tokyo है। लेकिन Performance Hub इकोसिस्टम के भीतर डेटा को सामान्यीकृत करने के लिए, हम इस स्थान और इस पार्टनर के लिए एक नई ID निर्दिष्ट करते हैं, उदाहरण के लिए UUID: 550e8400-e29b-41d4-a716-446655440000।

डेटा पुश करने के लिए हमारे API को कॉल करते समय पार्टनर को इसी facility_id का उपयोग करना चाहिए।

लिंकिंग के लिए सही facility_id प्राप्त करने के लिए (जैसा कि Direct Link विधि में आवश्यक है), पार्टनर /partner/v1/facilities API एंडपॉइंट को कॉल कर सकते हैं। यह एंडपॉइंट उन सभी सुविधाओं की सूची लौटाएगा जिनमें Performance Hub में वर्तमान में आपका पार्टनर इंटीग्रेशन सक्षम है, साथ ही उनके संबंधित facility_id मान भी।

उदाहरण: Direct Link

curl -X POST https://partner-api.performancehub.co/partner/v1/membership-plans \
  -u sk_live_YOUR_PARTNER_SECRET_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "membership_plans": [
      {
        "membership_plan_id": "plan_unlimited_monthly",
        "facility_id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Unlimited Monthly Access",
        "billing_cycle": "monthly",
        "price": 10058,
        "currency": "JPY"
      }
    ]
  }'

2. लिंकिंग आइडेंटिफायर

पार्टनर अपना स्वयं का सिस्टम बनाए रखता है जिसमें हर स्थान के लिए अद्वितीय पहचानकर्ता होते हैं (जैसे, "Branch ID", "Location Code", "Store Number")। यह लिंकिंग विधि पार्टनर को हमारी सुविधा ID के बजाय अपने स्वयं के पहचानकर्ता का उपयोग करके Performance Hub सुविधाओं की पहचान करने देती है।

सुविधा सेटअप: जब कोई सुविधा इस पार्टनर को सक्षम करती है, तो उससे Performance Hub के भीतर अपने सुविधा कॉन्फ़िगरेशन में वह अद्वितीय पहचानकर्ता देने के लिए कहा जाएगा जिसका उपयोग पार्टनर उसके स्थान की पहचान करने के लिए करता है।

API इंटीग्रेशन: जब पार्टनर Performance Hub को API कॉल करता है, तो वह अनुरोध में अपना स्वयं का अद्वितीय पहचानकर्ता दे सकता है। Performance Hub, API कॉल को सही सुविधा से मिलाने के लिए आंतरिक रूप से linking_identifier खोजेगा।

उदाहरण: यदि पार्टनर अपने सिस्टम में स्थानों को "Branch ID" कहता है, तो नीचे दिए गए लेबल को "Branch ID" पर सेट करें। फिर हर सुविधा इंटीग्रेशन सक्षम करते समय अपना Branch ID मान देगी, जिससे सिस्टमों के बीच डेटा का सहज सिंक्रोनाइज़ेशन संभव होगा।

सुविधा इंटीग्रेशन स्क्रीन (मुख्य Performance सुविधा व्यू) से एक उदाहरण कॉन्फ़िगरेशन, जिसमें पार्टनर इंटीग्रेशन स्क्रीन में कॉन्फ़िगर किया गया, सदस्य प्रबंधन सिस्टम का लिंकिंग पहचानकर्ता / आंतरिक ID दिखाया गया है

उदाहरण: Linking Identifier

curl -X POST https://partner-api.performancehub.co/partner/v1/membership-plans \
  -u sk_live_YOUR_PARTNER_SECRET_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "membership_plans": [
      {
        "membership_plan_id": "plan_unlimited_monthly",
        "linking_identifier": "branch_tokyo",
        "name": "Unlimited Monthly Access",
        "billing_cycle": "monthly",
        "price": 10058,
        "currency": "JPY"
      }
    ]
  }'