नई सुविधाएँ
1. थर्ड-पार्टी एनालिटिक्स समर्थन
Google Analytics 4, Google Tag Manager और Meta Pixel के साथ Storefront, Checkout और Customer Portal में ग्राहक व्यवहार को ट्रैक करें। ई-कॉमर्स इवेंट संग्रह शुरू करने के लिए अपने ट्रैकिंग आईडीज़ को Settings → Analytics में जोड़ें।
समर्थित प्लेटफ़ॉर्म
| 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, और view_item_list जैसे इवेंट ग्राहक ब्राउज़ करते और खरीदारी पूरी करते समय स्वचालित रूप से आपके एनालिटिक्स प्लेटफ़ॉर्म पर भेजे जाते हैं।
Storefront, hosted Checkout, overlay/inline Checkout और Customer Portal पर समर्थित।
2. चेकआउट थीम अनुकूलन
चेकआउट सत्र बनाते समय customization.theme_config पैरामीटर के माध्यम से चेकआउट की दिखावट को अनुकूलित करें। दोनों लाइट और डार्क मोड के लिए रंग, फॉन्ट, बॉर्डर रेडियस और बटन टेक्स्ट कॉन्फ़िगर करें।
कॉन्फ़िगरेशन विकल्प
| Property | Description |
|---|
light / dark | प्रत्येक मोड के लिए रंग योजनाएँ |
font_primary_url | कस्टम फ़ॉन्ट URL |
font_size | xs, sm, md, lg, xl, 2xl |
radius | बॉर्डर रेडियस (उदा. 8px) |
pay_button_text | कस्टम बटन टेक्स्ट |
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. भुगतान विफलता पर योजना परिवर्तन रोकें
सब्सक्रिप्शन योजना परिवर्तन के लिए नया on_payment_failure पैरामीटर भुगतान विफल होने पर व्यवहार को नियंत्रित करता है।
| Mode | Behavior |
|---|
prevent_change | भुगतान सफल होने तक सब्सक्रिप्शन को वर्तमान योजना पर रखें |
apply_change | भुगतान परिणाम की परवाह किए बिना तुरंत योजना परिवर्तन लागू करें (डिफ़ॉल्ट) |
await client.subscriptions.changePlan('sub_123', {
product_id: 'prod_pro',
proration_billing_mode: 'prorated_immediately',
on_payment_failure: 'prevent_change'
});
एक्सेस देने से पहले भुगतान सुनिश्चित करने के लिए महत्वपूर्ण अपडेट्स के दौरान prevent_change का उपयोग करें।
एपीआई अपडेट
बैलेंस लेजर एपीआई
अपने खाते की लेजर एंट्रीज़ को फ़िल्टरिंग और पेजिनेशन के साथ प्राप्त करने के लिए नया GET /balances/ledger एंडपॉइंट।
| Parameter | Description |
|---|
created_at_gte / created_at_lte | तिथि सीमा के अनुसार फ़िल्टर करें |
event_type | payment, refund, dispute, payout आदि के अनुसार फ़िल्टर करें |
currency | मुद्रा कोड के द्वारा फ़िल्टर करें |
reference_object_id | विशिष्ट भुगतान/रिफंड/डिस्प्यूट आईडी के अनुसार फ़िल्टर करें |
भुगतान प्रतिक्रिया: refund_status
GET /payments/{paymentId} प्रतिक्रिया में refund_status फ़ील्ड जोड़ी गई है ताकि अलग से रिफंड्स एंडपॉइंट को क्वेरी किए बिना जल्दी यह जांचा जा सके कि भुगतान रिफंड हुआ है या नहीं।
