Fitur Baru
1. Dukungan Analitik Pihak Ketiga
Lacak perilaku pelanggan di Storefront, Checkout, dan Customer Portal dengan Google Analytics 4, Google Tag Manager, dan Meta Pixel. Tambahkan ID pelacakan Anda di Settings → Analytics untuk mulai mengumpulkan event e-commerce.
Platform yang Didukung
| Platform | ID Format |
|---|
| Google Analytics 4 | G-XXXXXXXXXX |
| Google Tag Manager | GTM-XXXXXXX |
| Meta Pixel | Numeric (10-20 digits) |
purchase, add_payment_info, view_item, dan view_item_list secara otomatis dikirim ke platform analitik Anda saat pelanggan menjelajah dan menyelesaikan pembelian.
Didukung di Storefront, hosted Checkout, overlay/inline Checkout, dan Customer Portal.
2. Kustomisasi Tema Checkout
Sesuaikan tampilan checkout melalui parameter customization.theme_config saat membuat sesi checkout. Konfigurasikan warna, font, radius border, dan teks tombol untuk mode terang dan gelap.
Opsi Konfigurasi
| Property | Description |
|---|
light / dark | Skema warna untuk setiap mode |
font_primary_url | URL font khusus |
font_size | xs, sm, md, lg, xl, 2xl |
radius | Radius border (misalnya 8px) |
pay_button_text | Teks tombol khusus |
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_123', quantity: 1 }],
customization: {
theme_config: {
radius: '8px',
pay_button_text: 'Complete Purchase',
light: { button_primary: '#0066ff', text_primary: '#1a1a1a' },
dark: { button_primary: '#3385ff', text_primary: '#ffffff' }
}
},
return_url: 'https://yoursite.com/return'
});
3. Cegah Perubahan Paket saat Pembayaran Gagal
Parameter on_payment_failure baru untuk perubahan paket langganan mengendalikan perilaku saat pembayaran gagal.
| Mode | Perilaku |
|---|
prevent_change | Pertahankan langganan pada paket saat ini sampai pembayaran berhasil |
apply_change | Terapkan perubahan paket segera terlepas dari hasil pembayaran (default) |
await client.subscriptions.changePlan('sub_123', {
product_id: 'prod_pro',
proration_billing_mode: 'prorated_immediately',
on_payment_failure: 'prevent_change'
});
Gunakan prevent_change untuk peningkatan kritis di mana Anda ingin memastikan pembayaran sebelum memberikan akses ke fitur premium.
Pembaruan API
API Buku Besar Saldo
Endpoint GET /balances/ledger baru untuk mengambil entri buku besar akun Anda dengan penyaringan dan paginasi.
| Parameter | Description |
|---|
created_at_gte / created_at_lte | Menyaring berdasarkan rentang tanggal |
event_type | Menyaring berdasarkan payment, refund, dispute, payout, dan lainnya |
currency | Menyaring berdasarkan kode mata uang |
reference_object_id | Menyaring berdasarkan ID pembayaran/pengembalian/kontroversi tertentu |
Respons Pembayaran: refund_status
Menambahkan field refund_status ke respons GET /payments/{paymentId} untuk memeriksa dengan cepat apakah pembayaran telah dikembalikan tanpa harus meminta endpoint refund secara terpisah.
