วิธีการเชื่อมโยงของพาร์ทเนอร์

พาร์ทเนอร์หรือระบบจัดการสมาชิกแต่ละรายจะระบุสถานที่หรือตำแหน่งที่ตั้งแต่ละแห่งด้วย ID ของตนเอง เช่น Branch ID หมายเลขร้านค้า หรือ ID สถานที่ เรามีวิธีระบุตำแหน่งที่ตั้งสองแบบในระหว่างการซิงค์หรือการส่งข้อมูล

1. ลิงก์โดยตรง

เมื่อส่งข้อมูล พาร์ทเนอร์จะใช้ ID สถานที่จากระบบ Performance Hub

ตัวอย่างเช่น สำหรับพาร์ทเนอร์ A ID ภายในของสถานที่แห่งหนึ่งในโตเกียวคือ branch_tokyo แต่เพื่อให้ข้อมูลเป็นมาตรฐานเดียวกันภายในระบบนิเวศของ Performance Hub เราจะกำหนด ID ใหม่ให้กับตำแหน่งที่ตั้งนี้และพาร์ทเนอร์รายนี้ เช่น UUID: 550e8400-e29b-41d4-a716-446655440000

พาร์ทเนอร์ควรใช้ facility_id นี้เมื่อเรียก API ของเราเพื่อส่งข้อมูล

หากต้องการรับ facility_id ที่ถูกต้องสำหรับการเชื่อมโยง (ตามที่วิธี Direct Link กำหนด) พาร์ทเนอร์สามารถเรียกปลายทาง API /partner/v1/facilities ปลายทางนี้จะส่งคืนรายการสถานที่ทั้งหมดที่เปิดใช้การผสานรวมพาร์ทเนอร์ของคุณใน 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") วิธีการเชื่อมโยงนี้ช่วยให้พาร์ทเนอร์ระบุสถานที่ใน Performance Hub ได้โดยใช้ตัวระบุของตนเองแทน ID สถานที่ของเรา

การตั้งค่าสถานที่: เมื่อสถานที่เปิดใช้พาร์ทเนอร์รายนี้ ระบบจะแจ้งให้สถานที่ระบุตัวระบุเฉพาะที่พาร์ทเนอร์ใช้ระบุตำแหน่งที่ตั้งของตน ในการกำหนดค่าสถานที่ภายใน Performance Hub

การผสานรวม API: เมื่อพาร์ทเนอร์เรียก API ของ Performance Hub พาร์ทเนอร์สามารถระบุตัวระบุเฉพาะของตนเองในคำขอได้ Performance Hub จะค้นหา linking_identifier ภายในระบบเพื่อจับคู่การเรียก API กับสถานที่ที่ถูกต้อง

ตัวอย่าง: หากพาร์ทเนอร์เรียกตำแหน่งที่ตั้งว่า "Branch ID" ในระบบของตน ให้ตั้งค่าป้ายกำกับด้านล่างเป็น "Branch ID" จากนั้นแต่ละสถานที่จะระบุค่า Branch ID ของตนเมื่อเปิดใช้การผสานรวม ทำให้ซิงโครไนซ์ข้อมูลระหว่างระบบได้อย่างราบรื่น

ตัวอย่างการกำหนดค่าจากหน้าจอการผสานรวมของสถานที่ (มุมมองสถานที่หลักของ Performance Hub) ซึ่งแสดงตัวระบุการเชื่อมโยง / 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"
      }
    ]
  }'