สมัครสมาชิก
คุณลักษณะการสมัครสมาชิกกำหนดการสมัครสมาชิกของเจ้าของบัญชีและการดำเนินการตามแผนที่เปิดเผยผ่านเส้นทางพร็อกซีของตัวจัดการกล่องจดหมายเข้า ช่วยให้เจ้าของสามารถควบคุมวงจรชีวิตของแผนได้โดยตรง ในขณะเดียวกันก็รักษาการตรวจสอบบัญชีและบทบาทอย่างเข้มงวด
ทำไมเรื่องนี้ถึงสำคัญ
คุณลักษณะนี้จะรวมการดำเนินการสมัครสมาชิกของเจ้าของไว้ภายใต้พื้นผิว Inbox Manager API ในขณะที่ยังคงรักษาการตรวจสอบบัญชีและบทบาทที่เข้มงวดจากการอ้างสิทธิ์โทเค็นผู้ถือ โดยเปิดเผยการดำเนินการชำระเงิน พอร์ทัล การซิงค์ และการเปลี่ยนแปลงแผน โดยไม่จำเป็นต้องให้ไคลเอ็นต์ทำซ้ำตรรกะการจัดการการสมัครสมาชิก
คอร์โฟลว์
การดำเนินงาน
| การดำเนินงาน | จุดสิ้นสุด | วัตถุประสงค์ |
|---|---|---|
| สมัครสมาชิกรายการ | GET /api/subscriptions | รับการสมัครสมาชิกสำหรับบัญชีที่เลือกโทเค็น |
| คุณสมบัติรายการ | GET /api/subscriptions/features | ดึงข้อมูลชุดคุณลักษณะการสมัครสมาชิกที่ใช้งานอยู่ |
| รับข้อมูลประจำตัวการสมัครสมาชิก | GET /api/subscriptions/identity | รับข้อมูลประจำตัวการสมัครสมาชิกสำหรับบัญชี |
| รายชื่อร้านค้า | GET /api/subscriptions/merchants | เรียกข้อมูลตัวเลือกผู้ค้า/ผู้ให้บริการ |
| ซิงค์การสมัครสมาชิก | POST /api/subscriptions/sync | รีเฟรชสถานะการสมัครสมาชิกจากผู้ให้บริการ |
| เปลี่ยนการสมัครสมาชิก | POST /api/subscriptions/:subscription_id/change | ปรับเปลี่ยนแผนหรือช่วงเวลา |
| ยกเลิกการสมัครสมาชิก | POST /api/subscriptions/:subscription_id/cancel | สิ้นสุดวงจรการสมัครรับข้อมูล |
| สร้างเซสชันการชำระเงิน | POST /api/subscriptions/stripe/checkout-session | เริ่มชำระเงินสำหรับแผนใหม่หรือแผนการเปลี่ยนแปลง |
| สร้างเซสชันพอร์ทัล | POST /api/subscriptions/stripe/portal-session | เปิดพอร์ทัลการสมัครสมาชิกแบบบริการตนเอง |
| ซิงค์เซสชันการชำระเงิน | POST /api/subscriptions/stripe/checkout-session-sync | ลิงก์การชำระเงินเสร็จสิ้นไปยังสถานะการสมัครสมาชิก |
ข้อมูลสำคัญและสถานะ
{
data: {
account_id: "acc_...",
subscription_id: "sub_...",
status: "active"
},
links: {
checkout_url: "https://checkout.stripe.com/..."
}
}การตอบกลับทั้งหมดใช้เพย์โหลดสไตล์ proxy-envelope ที่คีย์โดย data พร้อมด้วย links หรือไม่ก็ได้
โหมดความล้มเหลวและการควบคุม
การอ้างสิทธิ์ acc หายไปหรือไม่ถูกต้องจะปฏิเสธการดำเนินการสมัครสมาชิกของเจ้าของ และผู้โทรที่ไม่ใช่เจ้าของจะถูกบล็อกจากการดำเนินการสมัครสมาชิกในขอบเขตที่เจ้าของ ความล้มเหลวของพร็อกซีอัปสตรีมจะถูกส่งกลับเป็นความล้มเหลวในการดำเนินการที่ชัดเจน และการเปลี่ยนแปลงการสมัครรับข้อมูลยังคงจำกัดอยู่เฉพาะการเปลี่ยนแปลงหรือยกเลิกเส้นทางอย่างชัดเจน