On this page

คู่มือการผสานรวม Stripe Apps

Stripe Apps ช่วยให้คุณฝังฟังก์ชันการทำงานที่กำหนดเองโดยตรงใน Stripe Dashboard ให้ผู้ค้าเข้าถึงการผสานรวม Tajo Brevo โดยไม่ต้องออกจาก payment workflow คู่มือนี้ครอบคลุมทุกสิ่งที่คุณต้องการในการสร้าง ทดสอบ และเผยแพร่ Stripe App ที่เชื่อมต่อ Stripe กับ Brevo ผ่าน Tajo

Tip

เป้าหมายคือการเผยแพร่ การผสานรวม Brevo บน Stripe App Marketplace ซึ่งจะช่วยให้ผู้ค้า Stripe ซิงค์ข้อมูลลูกค้า คำสั่งซื้อ และ events โดยตรงเข้าสู่ Brevo สำหรับ marketing automations และ CRM

Stripe Apps คืออะไร?

Stripe Apps ขยาย Stripe Dashboard ด้วย UI components และ backend integrations ที่กำหนดเอง ช่วยให้นักพัฒนาบุคคลที่สามสามารถ:

เพิ่ม views ที่กำหนดเองในหน้า Stripe Dashboard (ลูกค้า การชำระเงิน ใบแจ้งหนี้ ฯลฯ)
เข้าถึงข้อมูล Stripe ผ่านสิทธิ์ที่จำกัด
ซิงค์ข้อมูลระหว่าง Stripe และ external platforms อย่าง Brevo
ให้ onboarding และ configuration flows ภายใน Dashboard

เป้าหมายการผสานรวม Tajo + Brevo

Tajo Stripe App เชื่อมต่อ Stripe กับ Brevo และให้:

Customer Intelligence: ซิงค์ Stripe customer profiles ประวัติการชำระเงิน และ lifetime value เข้า Brevo contacts
Event Tracking: ส่ง Stripe events (การชำระเงิน การสมัครสมาชิก การคืนเงิน) เป็น transactional Brevo events
Automated Campaigns: เปิดใช้งาน Brevo email, SMS และ WhatsApp campaigns ตาม Stripe activity
Loyalty Programs: สร้าง retention workflows โดยใช้ข้อมูลการซื้อจาก Stripe ที่ซิงค์เข้า Brevo

ภาพรวมสถาปัตยกรรม

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Stripe Dashboard │────▶│   Tajo Platform  │────▶│     Brevo       │
│  (Stripe App UI) │◀────│   (Middleware)    │◀────│   (CRM/Email)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
   Customer Views          Data Sync &              Contacts,
   Payment Details          Event Routing            Campaigns,
   App Settings             Webhook Processing        Automations

เนื้อหาคู่มือ

เริ่มต้น

คู่มือ	คำอธิบาย
เผยแพร่บน Marketplace	ข้อกำหนดและขั้นตอนในการส่งแอปเพื่อตรวจสอบ
ข้อกำหนดการตรวจสอบแอป	มาตรฐานคุณภาพ ความปลอดภัย และ UX สำหรับการอนุมัติ

การกำหนดค่าและอ้างอิง

คู่มือ	คำอธิบาย
อ้างอิง App Manifest	Schema ครบถ้วนสำหรับไฟล์ manifest `stripe-app.json`
อ้างอิง Permissions	รายการสิทธิ์ Stripe API ที่ครบถ้วนและวิธีการขอ
อ้างอิง Viewports	ตำแหน่งใน Dashboard ที่ UI ของแอปสามารถแสดงได้

ฟีเจอร์และการผสานรวม

คู่มือ	คำอธิบาย
Embedded Stripe Apps	ใช้ Connect embedded components สำหรับ platform integrations
Install Links & Deep Links	สร้าง installation URLs และ deep links ไปยัง app views เฉพาะ
Post-Install Actions	กำหนดค่า onboarding flows หลังติดตั้งแอป

Operations และการเติบโต

คู่มือ	คำอธิบาย
App Analytics	ติดตาม installations, views และ conversion metrics
Partner Ecosystem	ใช้ประโยชน์จาก Stripe partner program สำหรับ co-marketing และการเติบโต

ข้อกำหนดเบื้องต้น

ก่อนสร้าง Stripe App ตรวจสอบให้แน่ใจว่าคุณมี:

บัญชี Stripe: บัญชี Stripe ที่เปิดใช้งาน (ไม่จำกัดเฉพาะ test mode)
Stripe CLI: ติดตั้ง Stripe CLI สำหรับการพัฒนาในเครื่องและการอัพโหลดแอป
Node.js: เวอร์ชัน 16 หรือใหม่กว่าสำหรับ UI extension ของแอป
การเข้าถึง Tajo Platform: บัญชี Tajo ที่ใช้งานได้พร้อม Brevo API credentials ที่กำหนดค่าแล้ว

เริ่มต้นอย่างรวดเร็ว

# ติดตั้ง Stripe CLI
brew install stripe/stripe-cli/stripe

# เข้าสู่ระบบบัญชี Stripe ของคุณ
stripe login

# สร้างโปรเจกต์ Stripe App ใหม่
stripe apps create tajo-brevo-integration

# เริ่มการพัฒนาในเครื่อง
stripe apps start

แนวคิดสำคัญ

App Manifest

Stripe App แต่ละตัวมี manifest stripe-app.json ที่ประกาศ permissions, viewports และการกำหนดค่า ดู App Manifest Reference สำหรับ schema ครบถ้วน

UI Extensions

Stripe Apps สามารถแสดง React-based UI components ใน Dashboard viewports เฉพาะ UI toolkit มีคอมโพเนนต์ที่สร้างไว้ล่วงหน้าที่ตรงกับ design system ของ Stripe Dashboard

Permissions

Apps ต้องประกาศ Stripe API resources เฉพาะที่ต้องการเข้าถึง ผู้ใช้อนุมัติ permissions เหล่านี้ระหว่างการติดตั้ง ดู Permissions Reference

ขั้นตอนถัดไป

เริ่มต้นด้วย Publishing Guide เพื่อเข้าใจข้อกำหนดทั้งหมด จากนั้นดำเนินการผ่าน technical references สำหรับการกำหนดค่า manifest และ permissions ของแอป