คู่มือการผสานรวม Stripe Apps
Stripe Apps ช่วยให้คุณฝังฟังก์ชันที่กำหนดเองลงใน Stripe Dashboard ได้โดยตรง ส่วนนี้คือ คู่มือการสร้าง ซึ่งอธิบายว่าแอปสำหรับการผสานรวม Tajo กับ Brevo จะถูกสร้าง ทดสอบ และเผยแพร่อย่างไร
Caution
สถานะ: ยังไม่เผยแพร่ ปัจจุบันยังไม่มีแอป Tajo บน Stripe App Marketplace และตัวระบุแอป URL รวมถึงข้อมูลรับรองในหน้าเหล่านี้เป็นตัวอย่างประกอบคำอธิบาย ไม่ใช่ปลายทางที่ใช้งานได้จริง หากต้องการเชื่อม Stripe เข้ากับ Tajo ในตอนนี้ ให้ใช้ คอนเน็กเตอร์ Stripe (restricted API key ซิงค์แบบอ่านอย่างเดียว)
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 App
เริ่มต้น
| คู่มือ | คำอธิบาย |
|---|---|
| เผยแพร่บน 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 ที่กำหนดค่าแล้ว
เริ่มต้นอย่างรวดเร็ว
# Install Stripe CLIbrew install stripe/stripe-cli/stripe
# Login to your Stripe accountstripe login
# Create a new Stripe App projectstripe apps create tajo-brevo-integration
# Start local developmentstripe 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
คีย์ลับสำหรับลงลายเซ็น
แอปแต่ละตัวจะได้รับคีย์ลับสำหรับลงลายเซ็น เพื่อใช้ตรวจสอบลายเซ็นของการติดตั้งและรักษาความปลอดภัยของการสื่อสารระหว่างระบบหลังบ้านของคุณกับ Stripe
ขั้นตอนการพัฒนา
- กำหนด manifest ของคุณพร้อม permissions และ viewports ที่ต้องใช้
- สร้าง UI extension ด้วยไลบรารี React components ของ Stripe
- พัฒนา endpoints ฝั่งหลังบ้านสำหรับการซิงค์ข้อมูลกับ Brevo ผ่าน Tajo
- ทดสอบ ในเครื่องด้วย
stripe apps start - อัปโหลด ด้วย
stripe apps upload - ส่ง เพื่อตรวจสอบผ่าน Stripe Dashboard
- เผยแพร่ และติดตามผลผ่าน analytics
Caution
Stripe กำหนดให้แอปต้องเขียนเป็นภาษาอังกฤษสำหรับการเผยแพร่บน marketplace รายละเอียดแอป ข้อความใน UI และเอกสารประกอบของคุณต้องเป็นภาษาอังกฤษทั้งหมด
ขั้นตอนถัดไป
เริ่มต้นด้วย Publishing Guide เพื่อเข้าใจข้อกำหนดทั้งหมด จากนั้นดำเนินการผ่าน technical references สำหรับการกำหนดค่า manifest และ permissions ของแอป