Sumber Daya · Pusat Pengembang

Shopify, Toko Amazon & TikTok

Hubungkan saluran e-commerce Anda sehingga pesanan online mendapatkan loyalitas. Shopify menyinkronkan produk dan memberikan poin pada pesanan secara otomatis; Amazon dan TikTok Shop memungkinkan anggota mendapatkan poin untuk pesanan yang kami verifikasi terhadap pasar — bukan berdasarkan kata-kata pembeli. Anda mengkonfigurasi ketiganya di aplikasi di bawah Pengaturan → Toko Online.

Pengaturan saluran terbuka Jelajahi API

Tiga saluran, satu tempat

Ketiganya tersedia di halaman Pengaturan → Toko Online sebagai kartu bertab tunggal. Shopify adalah sinkronisasi penuh (produk + poin pesanan otomatis). Amazon dan TikTok Shop adalah saluran pesanan terverifikasi: anggota melaporkan sendiri pesanan mereka number di portal dan platform mengambil pesanan resmi dari API yang diotorisasi penjual sebelum memberikan poin. Informasi pribadi pembeli tidak pernah disimpan.

Toko Online

Shopify

Sinkronkan produk ke dalam kampanye dan dapatkan poin loyalitas pada pesanan secara otomatis. Terhubung dengan domain toko + token akses Admin API.

Marketplace

Amazon

Anggota mendapatkan poin untuk pesanan Amazon terverifikasi mereka — diperiksa terhadap Amazon SP-API dengan kredensial penjual Anda, bukan berdasarkan kata-kata pembeli.

Marketplace

Toko TikTok

Anggota mendapatkan poin untuk pesanan TikTok Shop terverifikasi mereka — diperiksa terhadap Mitra TikTok Shop API. Model verifikasi-jangan-percaya yang sama seperti Amazon.

Toko Online

Shopify

Hubungkan toko Shopify Anda untuk memasukkan data produk ke dalam kampanye Anda dan ubah pesanan yang terpenuhi menjadi poin loyalitas — tanpa kode, hanya domain toko dan token akses Admin API.

1 · Buat token akses Admin API di Shopify

Di Admin Shopify Anda, buka Pengaturan → Aplikasi dan saluran penjualan → Kembangkan aplikasi → buat aplikasi, berikan hak akses read_products dan read_orders (tambahkan hak akses tulis hanya jika Anda membutuhkannya), dan instal untuk menampilkan token akses Admin API (shpat_…).

2 · Hubungkan toko di SocialHub

Di aplikasi, Pengaturan → Toko Online → tab Toko Online. Masukkan domain toko Anda (my-store.myshopify.com) dan token akses Admin API. Token tersebut diverifikasi terhadap toko Anda sebelum disimpan dan dienkripsi (AES-256-GCM) saat disimpan — tidak pernah dicatat atau ditampilkan lagi.

3 · Sinkronisasi & dapatkan

Klik Sinkronkan Sekarang untuk menarik katalog produk Anda untuk kampanye. Mulai saat itu, pesanan yang terpenuhi akan memberikan poin loyalitas secara otomatis (rumus yang sama seperti tanda terima), dan pembelian pertama / berulang akan memicu peristiwa otomatisasi pasca-pembelian.

// What the platform exposes for the Online Shop connection:
POST /api/shopify/connect      { "shopDomain": "my-store.myshopify.com", "accessToken": "shpat_…" }
GET  /api/shopify/status       // → { connected, shopDomain, status, lastSyncedAt, productCount, apiVersion }
POST /api/shopify/sync         // pull products now
POST /api/shopify/disconnect   // remove the connection + synced product data
//
// Orders: SocialHub receives Shopify order webhooks (order.fulfilled) and awards points
// keyed by the order id — idempotent, so a replayed webhook never double-awards.
// Connecting an Online Shop requires the Omnichannel plan.

Marketplace

Amazon

Biarkan anggota mendapatkan poin untuk pesanan Amazon mereka yang terverifikasi. Anda mengotorisasi aplikasi Amazon SP-API (Masuk dengan Amazon) di akun Seller Central Anda; platform menggunakan kredensial tersebut untuk mengambil setiap pesanan yang dilaporkan sendiri dan memberikan poin hanya jika pesanan tersebut nyata. Atur di bawah Pengaturan → Toko Online → Amazon (admin tim & admin sistem).

Pengaturan koneksi

Nama Koneksi

Label untuk koneksi ini, misalnya “Amazon US - BrandX”. Multi-penjual? Gunakan nama yang berbeda untuk setiap koneksi.

Wilayah

Wilayah AWS dari endpoint SP-API, misalnya us-east-1.

Titik akhir

Host SP-API untuk wilayah Anda, misalnya https://sellingpartnerapi-na.amazon.com.

ID Marketplace

Dipisahkan koma, misalnya ATVPDKIKX0DER (Amazon AS).

ID Penjual

Opsional — ID Mitra Penjualan / pedagang Anda.

Rahasia (dienkripsi saat istirahat · hanya tulis)

Token Refresh LWA

Atzr|… — dari mengotorisasi aplikasi SP-API Anda di Seller Central.

ID Klien LWA

amzn1.application-oa2-client… — ID klien aplikasi SP-API Anda.

Rahasia Klien LWA

Rahasia klien aplikasi SP-API Anda.

Save & Verify menjalankan pemeriksaan keaktifan langsung terhadap SP-API dan mencantumkan pasar yang dapat dilihatnya. Token penyegaran LWA tidak berputar — verifikasi ulang kapan saja dari baris koneksi.

Marketplace

Toko TikTok

Model verifikasi-jangan-percaya yang sama seperti Amazon, terhadap Mitra Toko TikTok API. Anda mengotorisasi aplikasi Mitra Toko TikTok di toko Anda untuk mendapatkan Kunci Aplikasi / Rahasia Aplikasi dan token penyegaran. Atur di bawah Pengaturan → Toko Online → Toko TikTok (admin tim & admin sistem).

Pengaturan koneksi

Nama Koneksi

Label untuk koneksi ini, misalnya “TikTok US - BrandX”.

Wilayah

Wilayah toko, mis. kita.

Shop Cipher

Opsional — biarkan kosong; Simpan & Verifikasi akan menemukannya dari toko resmi Anda.

Rahasia (dienkripsi saat istirahat · hanya tulis)

Kunci Aplikasi

Kunci aplikasi TikTok Shop Partner Anda.

Rahasia Aplikasi

Rahasia aplikasi Mitra Toko TikTok Anda.

Token Penyegaran

BARIS_… — dari otorisasi aplikasi di toko Anda. TikTok memutar ini setiap kali halaman diperbarui; platform menyimpan rotasi untuk Anda.

Biarkan Kode Toko kosong — Simpan & Verifikasi akan menemukannya dari toko resmi Anda. TikTok memutar token penyegaran setiap kali penyegaran; platform menserialisasi dan menyimpan rotasi sehingga pekerjaan bersamaan tidak pernah saling membatalkan.

// Marketplace credentials (Amazon / TikTok Shop) are saved + liveness-checked here.
// Open to team admins (org_owner / org_admin) and system admins; tenant-isolated —
// an admin can only ever read/write their OWN team's channels.
POST /api/admin/channels            { teamId, kind: "amazon" | "tiktok", name, config, secrets }
POST /api/admin/channels/{id}/ping  // re-verify the connection (discovers shop refs / cipher)
//
// Secrets (refresh_token, client_secret, app_secret, …) are AES-GCM encrypted the
// instant they arrive — write-only, never returned, never logged.

Bagaimana kredensial dijaga keamanannya

Dienkripsi saat tidak aktif

Setiap rahasia (token akses, token penyegaran, rahasia klien/aplikasi) dienkripsi AES-GCM saat tiba. Rahasia hanya dapat ditulis — tidak pernah dikembalikan ke browser, tidak pernah ditulis ke log atau email.

Terisolasi oleh penyewa

Kredensial saluran terikat pada satu tim. Admin tim (org_owner / org_admin) dan admin sistem mengelolanya, dan hanya dapat membaca atau menulis koneksi tim mereka sendiri.

Verifikasi, jangan percaya

Untuk Amazon & TikTok Shop, poin hanya diberikan untuk pesanan yang diambil platform dari API penjual yang diotorisasi. Informasi pribadi pembeli dicocokkan lalu dibuang dan tidak pernah disimpan ke dalam catatan pesanan.

Pendapatan idempoten

Shopify webhook pesanan dan nomor pesanan pasar dikunci berdasarkan ID pesanan, sehingga pemutaran ulang atau pengajuan duplikat tidak pernah memberikan poin dua kali.

Terkait: REST API · POS · OMS · ERP · Anggota Penyematan Portal

Menghubungkan saluran penjualan?

Bicaralah dengan teknisi tentang cakupan Shopify, otorisasi SP-API, aplikasi Mitra Toko TikTok, atau cara kerja poin pesanan terverifikasi.

Bicara dengan bagian teknik