คอนเน็กเตอร์ Stripe

เชื่อมต่อบัญชี Stripe ของคุณเข้ากับ Tajo เพื่อซิงค์ข้อมูลการชำระเงินแบบอ่านอย่างเดียว (ลูกค้า การเรียกเก็บเงิน การสมัครสมาชิก และใบแจ้งหนี้) เข้าสู่การจับคู่คอนแทกต์ การแบ่งกลุ่ม และการทำงานอัตโนมัติที่ขับเคลื่อนด้วยรายได้ (ผ่าน Brevo และผู้ให้บริการด้านการมีส่วนร่วมรายอื่น)

ภาพรวม

คุณสมบัติ	ค่า
การยืนยันตัวตน	Stripe secret key (sk_live_... / sk_test_...) หรือ restricted key
สิทธิ์การเข้าถึง	อ่านอย่างเดียว Tajo ไม่เขียนข้อมูลลงบัญชี Stripe ของคุณ
Base API	https://api.stripe.com/v1
ทิศทางการซิงค์	Stripe → Tajo
Webhook แบบเรียลไทม์	ยังไม่รองรับ ปัจจุบันการซิงค์ทำงานด้วยการดึงข้อมูลตามรอบ

การตั้งค่า

1. ใน Stripe Dashboard เปิด Developers → API keys
2. สร้าง restricted key โดยให้สิทธิ์อ่าน Customers, Charges, Subscriptions และ Invoices ก็เพียงพอแล้ว restricted key ดีกว่า secret key แบบเต็มอย่างชัดเจน เพราะ Tajo อ่านอย่างเดียว จึงควรให้สิทธิ์อ่านเท่านั้น
3. วางคีย์ลงในการเชื่อมต่อ Stripe ภายใน Tajo

การเชื่อมต่อจะถูกตรวจสอบด้วยคำขอแบบอ่านอย่างเดียวก่อนที่การซิงค์ใด ๆ จะเริ่มทำงาน คุณเปลี่ยนหรือเพิกถอนคีย์ใน Stripe ได้ทุกเมื่อ

ข้อมูลที่ซิงค์

ข้อมูล	Tajo นำไปทำอะไร
ลูกค้า	จับคู่เข้าเป็นคอนแทกต์ (อีเมล ชื่อ เบอร์โทร ที่อยู่) สำหรับการระบุตัวตนและการแบ่งกลุ่ม ความยินยอมจะไม่ถูกอนุมานจากการที่เรคคอร์ดลูกค้ามีอยู่
การเรียกเก็บเงิน	อีเวนต์รายได้สำหรับการทำงานอัตโนมัติตามวงจรชีวิตที่อิงการซื้อ และการแบ่งกลุ่มตาม LTV
การสมัครสมาชิก	สถานะในวงจรชีวิต (active, past_due, canceled…) สำหรับการทวงชำระ การดึงลูกค้ากลับ และโฟลว์รักษาฐานลูกค้า
ใบแจ้งหนี้	สถานะการชำระเงินสำหรับข้อความที่เกี่ยวข้องกับการเรียกเก็บเงิน

การแบ่งหน้าใช้โมเดลเคอร์เซอร์ของ Stripe (starting_after) บัญชีขนาดใหญ่จึงซิงค์ได้ครบถ้วนและกลับมาทำต่อจากจุดเดิมได้

ข้อจำกัดในปัจจุบัน

ระบุไว้ตรงไปตรงมาเพื่อให้คุณวางแผนรับมือได้

• ยังไม่มี webhook แบบเรียลไทม์ การเปลี่ยนแปลงจะมาตามรอบการซิงค์ ไม่ใช่ ณ วินาทีที่การชำระเงินสำเร็จ การรับ webhook อยู่ในแผนพัฒนา
• อ่านอย่างเดียว Tajo ไม่สร้างและไม่แก้ไขลูกค้า การชำระเงิน หรือการสมัครสมาชิกใน Stripe
• ไม่มี Stripe App ปัจจุบันยังไม่มีแอป Tajo บน Stripe App Marketplace การเชื่อมต่อจึงตั้งค่าใน Tajo ไม่ใช่ใน Stripe Dashboard

การแก้ไขปัญหา

อาการ	สาเหตุและวิธีแก้
Stripe ตอบกลับ 401	คีย์ถูกเพิกถอนหรือถูกเปลี่ยน ให้วางคีย์ปัจจุบันลงในการเชื่อมต่อ
ลูกค้าซิงค์ได้ แต่การเรียกเก็บเงินไม่ซิงค์	restricted key ขาดสิทธิ์อ่าน Charges
คอนแทกต์ไม่มีอีเมล	ลูกค้า Stripe ที่ไม่มีอีเมลจะซิงค์เข้ามาเป็นเรคคอร์ดรายได้แบบไม่ระบุตัวตน และจะเข้าร่วมกราฟคอนแทกต์เมื่อมีการเพิ่มอีเมลในภายหลัง

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

• การซิงค์ลูกค้า: การแมปลูกค้า Stripe เข้าสู่ระบบบันทึกข้อมูลหลักของคุณ
• สร้างการทำงานอัตโนมัติสำหรับการทวงชำระและการดึงลูกค้ากลับใน Tajo จากการเปลี่ยนสถานะการสมัครสมาชิก