Sumber · Pusat Pembangun

Shopify, Kedai Amazon & TikTok

Hubungkan saluran e-dagang anda supaya pesanan dalam talian mendapat kesetiaan. Shopify menyegerakkan produk dan menganugerahkan mata pada pesanan secara automatik; Amazon dan TikTok Shop membolehkan ahli memperoleh mata untuk pesanan yang kami sahkan terhadap pasaran — bukan sekali-kali kata-kata pembeli. Anda mengkonfigurasi ketiga-tiganya dalam aplikasi di bawah Tetapan → Kedai Dalam Talian.

Buka tetapan saluran Layari API

Tiga saluran, satu tempat

Ketiga-tiganya berada di halaman Tetapan → Kedai Dalam Talian sebagai kad tab tunggal. Shopify ialah penyegerakan penuh (produk + mata pesanan automatik). Amazon dan TikTok Shop ialah saluran pesanan-disahkan: ahli melaporkan sendiri pesanan mereka number di portal dan platform mengambil pesanan berwibawa daripada API yang dibenarkan oleh penjual sebelum memberikan mata. PII Pembeli tidak pernah dikekalkan.

Kedai Dalam Talian

Shopify

Segerakkan produk ke dalam kempen dan dapatkan mata kesetiaan untuk pesanan secara automatik. Berhubung dengan domain kedai + Pentadbir API token akses.

Pasaran

Amazon

Ahli memperoleh mata untuk pesanan Amazon mereka yang disahkan — disemak dengan Amazon SP-API dengan kelayakan penjual anda, bukan kata-kata pembeli.

Pasaran

Kedai TikTok

Ahli memperoleh mata untuk pesanan Kedai TikTok mereka yang disahkan — disemak dengan Rakan Kongsi Kedai TikTok API. Model sahkan-jangan-percaya yang sama seperti Amazon.

Kedai Dalam Talian

Shopify

Hubungkan kedai Shopify anda untuk membawa data produk ke dalam kempen anda dan menukar pesanan yang telah dipenuhi kepada mata kesetiaan — tiada kod, hanya domain kedai dan token akses Pentadbir API.

1 · Cipta token akses Pentadbir API dalam Shopify

Dalam Pentadbir Shopify anda, pergi ke Tetapan → Aplikasi dan saluran jualan → Bangunkan aplikasi → cipta aplikasi, berikannya read_products dan read_orders (tambah skop tulis hanya jika anda memerlukannya), dan pasangkannya untuk mendedahkan token akses Pentadbir API (shpat_…).

2 · Hubungkan kedai dalam SocialHub

Dalam aplikasi, Tetapan → Kedai Dalam Talian → tab Kedai Dalam Talian. Masukkan domain kedai anda (my-store.myshopify.com) dan token akses Pentadbir API. Token disahkan terhadap kedai anda sebelum disimpan dan disulitkan (AES-256-GCM) semasa rehat — tidak akan direkodkan atau ditunjukkan lagi.

3 · Segerakkan & peroleh

Tekan Segerak Sekarang untuk menarik katalog produk anda bagi kempen. Mulai daripada itu, pesanan yang telah dipenuhi akan memberikan mata kesetiaan secara automatik (formula yang sama seperti resit), dan pembelian pertama / berulang akan mengaktifkan peristiwa automasi selepas 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.

Pasaran

Amazon

Biarkan ahli memperoleh mata untuk pesanan Amazon mereka yang disahkan. Anda membenarkan aplikasi Amazon SP-API (Log masuk dengan Amazon) pada akaun Seller Central anda; platform menggunakan kelayakan tersebut untuk mendapatkan setiap pesanan yang dilaporkan sendiri dan memberikan mata hanya jika pesanan itu benar. Sediakannya di bawah Tetapan → Kedai Dalam Talian → Amazon (pentadbir pasukan & pentadbir sistem).

Tetapan sambungan

Nama Sambungan

Label untuk sambungan ini, contohnya “Amazon US - BrandX”. Berbilang penjual? Gunakan nama yang berbeza bagi setiap sambungan.

Wilayah

Rantau AWS pada titik akhir SP-API, contohnya us-east-1.

Titik tamat

Hos SP-API untuk rantau anda, cth. https://sellingpartnerapi-na.amazon.com.

ID Pasaran

Dipisahkan koma, cth. ATVPDKIKX0DER (Amazon AS).

ID Penjual

Pilihan — Rakan Jualan / id pedagang anda.

Rahsia (disulitkan semasa rehat · tulis sahaja)

Token Segar Semula LWA

Atzr|… — daripada membenarkan aplikasi SP-API anda di Seller Central.

ID Klien LWA

amzn1.application-oa2-client… — id klien aplikasi SP-API anda.

Rahsia Pelanggan LWA

Rahsia klien aplikasi SP-API anda.

Simpan & Sahkan menjalankan semakan langsung terhadap SP-API dan menyenaraikan pasaran yang boleh dilihatnya. Token segar semula LWA tidak berputar — sahkan semula pada bila-bila masa dari baris sambungan.

Pasaran

Kedai TikTok

Model sahkan-jangan-percaya yang sama seperti Amazon, berbanding Rakan Kongsi Kedai TikTok API. Anda membenarkan aplikasi Rakan Kongsi Kedai TikTok di kedai anda untuk mendapatkan Kunci Aplikasi / Rahsia Aplikasi dan token segar semula. Sediakannya di bawah Tetapan → Kedai Dalam Talian → Kedai TikTok (pentadbir pasukan & pentadbir sistem).

Tetapan sambungan

Nama Sambungan

Label untuk sambungan ini, contohnya “TikTok AS - BrandX”.

Wilayah

Kawasan kedai, mis. kami.

Sifer Kedai

Pilihan — biarkan kosong; Simpan & Sahkan menemuinya daripada kedai sah anda.

Rahsia (disulitkan semasa rehat · tulis sahaja)

Kunci Aplikasi

Kunci aplikasi Rakan Kongsi Kedai TikTok anda.

Rahsia Aplikasi

Rahsia aplikasi Rakan Kongsi Kedai TikTok anda.

Token Segar Semula

ROW_… — daripada membenarkan aplikasi di kedai anda. TikTok memutarkannya pada setiap penyegaran; platform meneruskan putaran untuk anda.

Biarkan Sifer Kedai kosong — Simpan & Sahkan menemuinya dari kedai sah anda. TikTok memutarkan token segar semula pada setiap segar semula; platform tersebut membuat siri dan mengekalkan putaran supaya kerja serentak tidak akan membatalkan satu sama lain.

// 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.

Cara kelayakan disimpan dengan selamat

Disulitkan semasa rehat

Setiap rahsia (token akses, token segar semula, rahsia klien/aplikasi) disulitkan AES-GCM sebaik sahaja ia tiba. Rahsia adalah untuk menulis sahaja — tidak pernah dikembalikan ke pelayar, tidak pernah ditulis ke log atau e-mel.

Diasingkan daripada penyewa

Kelayakan saluran terikat kepada satu pasukan. Pentadbir pasukan (org_owner / org_admin) dan pentadbir sistem mengurusnya dan hanya boleh membaca atau menulis sambungan pasukan mereka sendiri.

Sahkan, jangan percaya

Untuk Amazon & TikTok Shop, mata diberikan hanya untuk pesanan yang diambil oleh platform daripada penjual yang dibenarkan API. PII pembeli dipadankan-kemudian-dibuang dan tidak pernah dikekalkan dalam rekod pesanan.

Pendapatan idempoten

Shopify webhook pesanan dan nombor pesanan pasaran dikunci oleh id pesanan, jadi ulangan atau penyerahan pendua tidak akan memberikan mata dua kali.

Berkaitan: REST API · POS · OMS · ERP · Portal Ahli Benamkan

Menyambungkan saluran jualan?

Bercakap dengan jurutera tentang skop Shopify, kebenaran SP-API, aplikasi Rakan Kongsi Kedai TikTok atau cara mata pesanan yang disahkan berfungsi.

Bercakap dengan jurutera