İş Ortağı Bağlama Yöntemleri

Farklı iş ortakları veya üye yönetim sistemleri, her tesisi ya da konumu şube kimliği, mağaza numarası veya tesis kimliği gibi kendi kimlikleriyle tanımlar. Verilerin eşitlenmesi veya gönderilmesi sırasında konumları tanımlamanın iki yolu vardır.

1. Doğrudan Bağlantı

Veri gönderirken iş ortağı, Performance Hub sistemindeki tesis kimliğini kullanır.

Örneğin, İş Ortağı A'nın Tokyo'daki bir tesis için dahili kimliği branch_tokyo olsun. Ancak verileri Performance Hub ekosisteminde normalleştirmek için bu konum ve bu iş ortağı için yeni bir kimlik atarız; örneğin UUID: 550e8400-e29b-41d4-a716-446655440000.

İş ortakları, veri göndermek için API'lerimizi çağırırken bu facility_id değerini kullanmalıdır.

Bağlama için doğru facility_id değerini almak üzere (Direct Link yönteminde gerektiği gibi) iş ortakları /partner/v1/facilities API uç noktasını çağırabilir. Bu uç nokta, Performance Hub'da iş ortağı entegrasyonunuzun şu anda etkin olduğu tüm tesislerin listesini, karşılık gelen facility_id değerleriyle birlikte döndürür.

Örnek: 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. Bağlantı Tanımlayıcısı

İş ortağı, her konum için benzersiz tanımlayıcılara (ör. "Branch ID", "Location Code", "Store Number") sahip kendi sistemini yönetir. Bu bağlama yöntemi, iş ortağının Performance Hub tesislerini bizim Tesis Kimliğimiz yerine kendi tanımlayıcısıyla tanımlamasını sağlar.

Tesis kurulumu: Bir tesis bu iş ortağını etkinleştirdiğinde, Performance Hub'daki tesis yapılandırmasında iş ortağının konumunu tanımlamak için kullandığı benzersiz tanımlayıcıyı girmesi istenir.

API entegrasyonu: İş ortağı Performance Hub'a API çağrısı yaptığında, istekte kendi benzersiz tanımlayıcısını sağlayabilir. Performance Hub, API çağrısını doğru tesisle eşleştirmek için linking_identifier değerini dahili olarak arar.

Örnek: İş ortağı kendi sisteminde konumlara "Branch ID" diyorsa aşağıdaki etiketi "Branch ID" olarak ayarlayın. Ardından her tesis, entegrasyonu etkinleştirirken kendi Branch ID değerini girer ve böylece sistemler arasında sorunsuz veri eşitlemesi sağlanır.

İş ortağı entegrasyonları ekranında yapılandırılan, üye yönetim sistemindeki bağlama tanımlayıcısını / dahili kimliği gösteren bir Tesis Entegrasyonları Ekranından (Ana Performance Tesis Görünümü) örnek yapılandırma

Örnek: 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"
      }
    ]
  }'