Metode Penautan Mitra

Setiap mitra atau sistem manajemen anggota mengidentifikasi setiap fasilitas atau lokasi dengan ID mereka sendiri, seperti ID cabang, nomor toko, atau ID fasilitas. Kami memiliki dua cara untuk mengidentifikasi lokasi saat menyinkronkan atau mengirimkan data.

1. Tautan Langsung

Saat mengirimkan data, mitra akan menggunakan ID fasilitas dari sistem Performance Hub.

Sebagai contoh, bagi Mitra A, ID internal mereka untuk sebuah fasilitas di Tokyo adalah branch_tokyo. Namun, untuk menormalkan data di dalam ekosistem Performance Hub, kami menetapkan ID baru untuk lokasi dan mitra ini, misalnya UUID: 550e8400-e29b-41d4-a716-446655440000.

Mitra harus menggunakan facility_id ini saat memanggil API kami untuk mengirimkan data.

Untuk mendapatkan facility_id yang benar untuk penautan (sebagaimana diperlukan dalam metode Direct Link), mitra dapat memanggil endpoint API /partner/v1/facilities. Endpoint ini akan mengembalikan daftar semua fasilitas yang saat ini mengaktifkan integrasi mitra Anda di Performance Hub, beserta nilai facility_id masing-masing.

Contoh: 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. Pengidentifikasi Tautan

Mitra mengelola sistemnya sendiri dengan pengidentifikasi unik untuk setiap lokasi (misalnya, "Branch ID", "Location Code", "Store Number"). Metode penautan ini memungkinkan mitra mengidentifikasi fasilitas Performance Hub menggunakan pengidentifikasi mereka sendiri, bukan ID Fasilitas kami.

Penyiapan Fasilitas: Saat sebuah fasilitas mengaktifkan mitra ini, fasilitas tersebut akan diminta memberikan pengidentifikasi unik yang digunakan mitra untuk mengidentifikasi lokasinya, di dalam konfigurasi fasilitas di Performance Hub.

Integrasi API: Saat mitra melakukan panggilan API ke Performance Hub, mitra dapat memberikan pengidentifikasi uniknya sendiri dalam permintaan. Performance Hub akan mencari linking_identifier secara internal untuk mencocokkan panggilan API dengan fasilitas yang benar.

Contoh: Jika mitra menyebut lokasi sebagai "Branch ID" di sistemnya, atur label di bawah ini menjadi "Branch ID". Setiap fasilitas kemudian akan memberikan nilai Branch ID-nya saat mengaktifkan integrasi, sehingga data tersinkronisasi dengan mulus antarsistem.

Contoh konfigurasi dari Layar Integrasi Fasilitas (Tampilan Fasilitas Performance Utama) yang menunjukkan pengidentifikasi penautan / ID internal dari sistem manajemen anggota yang dikonfigurasi di layar integrasi mitra

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