Shopify, Amazon 및 TikTok 상점

Shopify

Shopify 스토어를 연결하여 제품 데이터를 캠페인에 활용하고, 완료된 주문을 로열티 포인트로 전환하세요. 코드는 필요 없고, 스토어 도메인과 관리자 API 액세스 토큰만 있으면 됩니다.

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

틱톡 샵

TikTok Shop 파트너 API에 대해 Amazon과 동일한 검증-신뢰하지 않음 모델. 상점에서 TikTok Shop 파트너 앱을 승인하여 앱 키/앱 비밀 및 새로 고침 토큰을 얻습니다. 설정 → 온라인 상점 → TikTok Shop(팀 관리자 및 시스템 관리자)에서 설정하세요.

연결 설정

비밀 정보 (저장 시 암호화됨 · 쓰기 전용)

Shop Cipher 필드를 비워 두세요. Save & Verify 기능이 승인된 상점에서 자동으로 찾아줍니다. TikTok은 새로 고침할 때마다 새로 고침 토큰을 갱신합니다. 플랫폼은 갱신된 토큰을 직렬화하여 저장하므로 동시 작업으로 인해 토큰이 무효화되는 일은 없습니다.

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