Các phương thức liên kết đối tác

Mỗi đối tác hoặc hệ thống quản lý hội viên xác định từng cơ sở hoặc địa điểm bằng ID riêng của họ, chẳng hạn ID chi nhánh, số cửa hàng hoặc ID cơ sở. Chúng tôi có hai cách để xác định địa điểm khi đồng bộ hoặc đẩy dữ liệu.

1. Liên kết trực tiếp

Khi đẩy dữ liệu, đối tác sẽ sử dụng ID cơ sở từ hệ thống Performance Hub.

Ví dụ, với Đối tác A, ID nội bộ của họ cho một cơ sở ở Tokyo là branch_tokyo. Tuy nhiên, để chuẩn hóa dữ liệu trong hệ sinh thái Performance Hub, chúng tôi gán một ID mới cho địa điểm này và đối tác này, ví dụ UUID: 550e8400-e29b-41d4-a716-446655440000.

Đối tác nên sử dụng facility_id này khi gọi API của chúng tôi để đẩy dữ liệu.

Để lấy đúng facility_id cho việc liên kết (theo yêu cầu của phương thức Direct Link), đối tác có thể gọi endpoint API /partner/v1/facilities. Endpoint này sẽ trả về danh sách tất cả các cơ sở hiện đang bật tích hợp đối tác của bạn trong Performance Hub, cùng với các giá trị facility_id tương ứng.

Ví dụ: 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. Định danh liên kết

Đối tác duy trì hệ thống riêng với mã định danh duy nhất cho từng địa điểm (ví dụ: "Branch ID", "Location Code", "Store Number"). Phương thức liên kết này cho phép đối tác xác định các cơ sở trong Performance Hub bằng mã định danh của riêng họ thay vì ID cơ sở của chúng tôi.

Thiết lập cơ sở: Khi một cơ sở bật đối tác này, cơ sở đó sẽ được yêu cầu cung cấp mã định danh duy nhất mà đối tác dùng để xác định địa điểm của họ, trong phần cấu hình cơ sở trên Performance Hub.

Tích hợp API: Khi đối tác thực hiện lệnh gọi API đến Performance Hub, họ có thể cung cấp mã định danh duy nhất của riêng mình trong yêu cầu. Performance Hub sẽ tra cứu nội bộ linking_identifier để khớp lệnh gọi API với đúng cơ sở.

Ví dụ: Nếu đối tác gọi các địa điểm là "Branch ID" trong hệ thống của họ, hãy đặt nhãn bên dưới thành "Branch ID". Khi đó, mỗi cơ sở sẽ cung cấp giá trị Branch ID của mình khi bật tích hợp, giúp đồng bộ dữ liệu liền mạch giữa các hệ thống.

Ví dụ về cấu hình từ màn hình Tích hợp của cơ sở (giao diện cơ sở chính của Performance Hub), cho thấy mã định danh liên kết / ID nội bộ từ hệ thống quản lý hội viên được cấu hình trong màn hình tích hợp đối tác

Ví dụ: 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"
      }
    ]
  }'