Konsol Mitra

Partner Console menyediakan antarmuka web untuk mengelola integrasi Anda dengan Performance Hub.

Jika Anda belum memiliki akses ke Partner Console, silakan hubungi kami dengan mengirimkan pertanyaan kemitraan melalui Situs Web Utama Performance Hub. Tim kami akan memandu Anda melalui proses orientasi mitra dan membantu menyiapkan akses konsol Anda.

Mengakses Konsol

Untuk mengakses Partner Console, Anda memerlukan:

1. Partner ID - Pengidentifikasi unik yang diberikan Performance Hub kepada setiap mitra
2. One-Time Password (OTP) - Kode verifikasi yang dikirim ke Partner Email Anda

Masuk di partner-api.performancehub.co/partner/v1/console

Isi Konsol

Partner Console menyediakan alat untuk mengelola integrasi Anda dengan Performance Hub:

• Secret Keys - Buat dan kelola kunci API dengan tingkat akses yang berbeda (live, dryrun, read-only)
• Integration Settings - Konfigurasikan cara integrasi Anda terhubung dengan fasilitas
• Partner Details - Lihat dan perbarui informasi profil mitra Anda
• Logs - Pantau aktivitas API dan pecahkan masalah
• Connected Organisations - Lihat semua organisasi yang menggunakan integrasi Anda
• Ask AI - Dapatkan bantuan instan dengan pintasan ⌘I

Untuk informasi terperinci tentang setiap fitur, lihat Fitur Partner Console.

Fitur Partner Console

Partner Console mencakup empat bagian utama yang dapat diakses melalui tab navigasi:

1. Kunci Rahasia

Kelola kunci rahasia API Anda dengan kendali penuh atas jenis akses dan izin.

Fitur Utama:

• Create New Keys - Buat kunci API baru dengan tingkat akses tertentu
• Jenis Kunci:
  • Live - Akses baca-tulis penuh ke data produksi
  • Dryrun - Uji operasi tulis tanpa memengaruhi data produksi (penulisan disimulasikan)
  • Read-only - Akses hanya-baca untuk konsumsi data yang aman (operasi tulis diblokir)
• Pengelolaan Kunci - Lihat detail kunci dan stempel waktu terakhir digunakan, rotasi kunci, dan cabut kunci secara instan
• Pemfilteran Kunci - Filter kunci berdasarkan status (All, Active, Revoked)
• Rotasi Kunci - Rotasi kunci dengan mulus tanpa waktu henti

Setiap kunci rahasia menampilkan:

• Label - Nama yang dapat disesuaikan agar mudah dikenali
• Key ID - Pengidentifikasi unik (format UUID)
• Secret - Kunci rahasia yang disamarkan sebagian (12 karakter pertama dan 4 karakter terakhir terlihat)
• Type - Tingkat akses kunci (live, dryrun, read-only)
• Status - Status saat ini (active, revoked)
• Created - Tanggal kunci dibuat
• Last Used - Stempel waktu panggilan API terbaru
• Actions - Rotasi atau cabut kunci

2. Pengaturan Integrasi

Konfigurasikan cara integrasi Anda terhubung dengan fasilitas Performance Hub.

Fitur Utama:

• Data Linking Method - Pilih salah satu dari dua metode penautan:
  • Direct Link - Gunakan ID fasilitas Performance Hub untuk panggilan API
  • Linking Identifier - Gunakan pengidentifikasi lokasi Anda sendiri (Branch ID, Store Number, dll.)
  • Pelajari lebih lanjut tentang Metode Penautan Mitra
• Linking Identifier Label - Sesuaikan nama bidang yang ditampilkan kepada fasilitas (misalnya, "Branch ID", "Location Code")
• Partner Prefix - Tetapkan prefiks unik untuk integrasi Anda
• Integration Fields - Konfigurasikan bidang kustom khusus untuk integrasi Anda

3. Detail Mitra

Lihat dan kelola informasi profil mitra Anda.

Bidang yang Dapat Diedit:

• Partner Email - Email kontak utama untuk pemberitahuan
• Description - Deskripsi singkat integrasi Anda
• Logo URL - URL ke logo mitra Anda
• Website - Situs web perusahaan atau integrasi Anda
• Category - Klasifikasi kategori integrasi
• Details - Informasi mitra tambahan

Informasi Hanya-Baca:

• Partner ID (pengidentifikasi unik)
• Nama Mitra
• Status Integrasi
• Jumlah Organisasi yang Terhubung

4. Log

Pantau aktivitas API dan pecahkan masalah integrasi.

Data yang Tersedia:

• Log Permintaan API
• Kode Status Respons
• Pesan Kesalahan
• Informasi Stempel Waktu
• Payload Permintaan/Respons

Organisasi yang Terhubung

Lihat semua organisasi yang telah mengaktifkan integrasi Anda. Setiap kartu organisasi menampilkan:

• Nama Organisasi
• Merek Terkait
• Jumlah Fasilitas Aktif
• Status Integrasi

Ask AI

Dapatkan bantuan instan tentang topik terkait kemitraan menggunakan asisten AI (pintasan ⌘I).

Tanyakan Tentang:

• Penggunaan dan contoh endpoint API
• Autentikasi dan pengelolaan kunci rahasia
• Praktik terbaik sinkronisasi data
• Pemecahan masalah integrasi yang umum
• Fitur dan navigasi Partner Console

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.

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

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

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