Langganan
Fitur langganan menentukan langganan pemilik akun dan operasi paket yang diekspos melalui rute proksi Inbox Manager. Ini memberi pemilik kontrol siklus hidup rencana langsung sambil menjaga pemeriksaan akun dan peran tetap ketat.
Mengapa Ini Penting
Fitur ini menggabungkan tindakan langganan pemilik di bawah permukaan API Inbox Manager sambil mempertahankan pemeriksaan akun dan peran yang ketat dari klaim token bearer. Ini mengekspos operasi checkout, portal, sinkronisasi, dan perubahan rencana tanpa mengharuskan klien untuk menduplikasi logika orkestrasi langganan.
Aliran Inti
Operasi
| Operasi | Endpoint | Tujuan |
|---|---|---|
| Daftar langganan | GET /api/subscriptions |
Ambil langganan untuk akun yang dipilih token |
| Fitur daftar | GET /api/subscriptions/features |
Ambil kumpulan fitur langganan aktif |
| Dapatkan identitas berlangganan | GET /api/subscriptions/identity |
Ambil pengikatan identitas langganan untuk akun |
| Daftar pedagang | GET /api/subscriptions/merchants |
Ambil opsi pedagang/penyedia |
| Sinkronkan langganan | POST /api/subscriptions/sync |
Segarkan status berlangganan dari penyedia |
| Ubah langganan | POST /api/subscriptions/:subscription_id/change |
Ubah rencana atau interval |
| Batalkan langganan | POST /api/subscriptions/:subscription_id/cancel |
Akhiri siklus hidup langganan |
| Buat sesi checkout | POST /api/subscriptions/stripe/checkout-session |
Mulai checkout untuk paket baru atau yang diubah |
| Buat sesi portal | POST /api/subscriptions/stripe/portal-session |
Buka portal berlangganan layanan mandiri |
| Sinkronkan sesi checkout | POST /api/subscriptions/stripe/checkout-session-sync |
Tautkan penyelesaian checkout ke status berlangganan |
Data dan Status Utama
{
data: {
account_id: "acc_...",
subscription_id: "sub_...",
status: "active"
},
links: {
checkout_url: "https://checkout.stripe.com/..."
}
}Semua respons menggunakan payload gaya amplop proxy yang dikunci oleh data dengan links opsional.
Mode dan Kontrol Kegagalan
Klaim acc yang hilang atau tidak valid menolak operasi langganan pemilik, dan penelepon non-pemilik diblokir dari tindakan langganan dalam cakupan pemilik. Kegagalan proksi hulu dikembalikan sebagai kegagalan operasi eksplisit, dan mutasi langganan tetap terbatas pada perubahan eksplisit atau pembatalan rute.