Stripe इंटीग्रेशन

डेवलपर सहायता की आवश्यकता है

Stripe चेकआउट सेशन बनाते समय मेटाडेटा (जर्नी, यूज़र, डिवाइस) पास करने के लिए आपको अपनी डेवलपमेंट टीम से मदद की आवश्यकता होगी। इस गाइड को उनके साथ साझा करें।

Stripe एक भुगतान प्लेटफ़ॉर्म है जो आपको भुगतान स्वीकार करने और सब्सक्रिप्शन प्रबंधित करने की सुविधा देता है। Stripe को Pushwoosh के साथ इंटीग्रेट करने से आप कैंपेन में भुगतान और सब्सक्रिप्शन को ट्रैक कर सकते हैं, जर्नी और प्रोडक्ट के अनुसार राजस्व का विश्लेषण कर सकते हैं, भुगतान इवेंट्स के आधार पर यूज़र्स को सेगमेंट कर सकते हैं, और राजस्व की जानकारी के लिए ManyMoney AI का उपयोग कर सकते हैं।

इंटीग्रेशन का अवलोकन

इंटीग्रेशन का प्रकार

स्रोत: भुगतान और सब्सक्रिप्शन इवेंट्स Stripe से Pushwoosh को भेजे जाते हैं।

पूर्वापेक्षाएँ

Pushwoosh के साथ Stripe इंटीग्रेशन सेट अप करने के लिए, सुनिश्चित करें कि निम्नलिखित शर्तें पूरी हों:

• आपके पास एक सक्रिय Pushwoosh अकाउंट है।
• आपके पास एक Stripe अकाउंट है।

शब्दावली (एंटिटी नामों की मैपिंग यदि वे अलग हैं)

नीचे दी गई तालिका दिखाती है कि Stripe एंटिटीज़ Pushwoosh से कैसे मैप होती हैं। यह मैपिंग चेकआउट सेशन बनाते समय मेटाडेटा के रूप में संबंधित फ़ील्ड पास करके प्राप्त की जाती है (देखें मेटाडेटा कॉन्फ़िगरेशन)।

Stripe	Pushwoosh
ग्राहक	मेटाडेटा में user_id (आवश्यक), device_id (वैकल्पिक)
भुगतान / चार्ज	इवेंट StripePaymentSucceeded (charge.succeeded)
इनवॉइस (भुगतान किया गया)	इवेंट StripeInvoicePaid (invoice.paid)
सब्सक्रिप्शन	StripeSubscriptionCreated + StripeInvoicePaid में एट्रिब्यूट्स
प्रोडक्ट / कीमत	मेटाडेटा और इवेंट एट्रिब्यूट्स में product_id, product_name
कैंपेन (जर्नी)	मेटाडेटा में journey_uuids

सिंक्रनाइज़ की गई एंटिटीज़

• भुगतान इवेंट्स (एकमुश्त भुगतान, सब्सक्रिप्शन इनवॉइस)
• सब्सक्रिप्शन इवेंट्स (सब्सक्रिप्शन बनाया गया, सब्सक्रिप्शन इनवॉइस का भुगतान किया गया)

इंटीग्रेशन कैसे काम करता है?

जब आप अपने Stripe अकाउंट को Stripe Connect के माध्यम से Pushwoosh से कनेक्ट करते हैं, तो Pushwoosh को Stripe से भुगतान और सब्सक्रिप्शन डेटा प्राप्त होता है। आप चेकआउट सेशन बनाते समय मेटाडेटा पास करके प्रत्येक लेन-देन को एक कैंपेन और यूज़र या डिवाइस से लिंक कर सकते हैं (देखें मेटाडेटा कॉन्फ़िगरेशन)।

Pushwoosh इवेंट्स बनाता है जिनका उपयोग आप सेगमेंटेशन और एनालिटिक्स के लिए कर सकते हैं।

डेटा प्रवाह

1. आप अपने Stripe अकाउंट को Settings → 3rd-party integrations में Stripe Connect के माध्यम से एक बार Pushwoosh से कनेक्ट करते हैं।
2. चेकआउट सेशन बनाते समय, आप मेटाडेटा पास करते हैं ताकि भुगतान को बाद में एट्रिब्यूट किया जा सके (देखें मेटाडेटा कॉन्फ़िगरेशन)।
3. जब Stripe में कोई भुगतान या सब्सक्रिप्शन इवेंट होता है (जैसे एकमुश्त के लिए charge.succeeded, सब्सक्रिप्शन के लिए invoice.paid), तो Stripe डेटा Pushwoosh को भेजता है।
4. Pushwoosh संबंधित इवेंट्स बनाता है और एट्रिब्यूशन के लिए मेटाडेटा का उपयोग करता है। यह डेटा Finance Overview, Audience → Events, और ManyMoney में दिखाई देता है।

उपयोग के मामले

भुगतानों को ट्रैक करें

सभी सफल भुगतानों और सब्सक्रिप्शन के बारे में स्वचालित रूप से जानकारी प्राप्त करें।

भुगतानों को कैंपेन से लिंक करें

मेटाडेटा पास करके लेन-देन को विशिष्ट कस्टमर जर्नी से जोड़ें (देखें मेटाडेटा कॉन्फ़िगरेशन)।

राजस्व का विश्लेषण करें

कैंपेन, प्रोडक्ट, यूज़र्स और डिवाइस के अनुसार आय देखें।

अपने ऑडियंस को सेगमेंट करें

भुगतान इवेंट्स के आधार पर सेगमेंट बनाएँ।

AI एनालिटिक्स

ManyMoney AI असिस्टेंट स्वचालित रूप से भुगतान और सब्सक्रिप्शन के आँकड़े प्राप्त करता है और इस डेटा के आधार पर निर्णय ले सकता है।

इंटीग्रेशन सेट अप करें

Stripe को Pushwoosh से कनेक्ट करें

1. कोई भी Pushwoosh एप्लिकेशन खोलें (Stripe अकाउंट आपके पूरे अकाउंट से जुड़ा होता है, किसी विशिष्ट एप्लिकेशन से नहीं) और Settings → 3rd-party integrations पर जाएँ।
2. Stripe कार्ड ढूंढें और LOGIN PAGE बटन पर क्लिक करें।

3. आपको Stripe ऑथराइज़ेशन पेज पर रीडायरेक्ट कर दिया जाएगा।

4. Stripe पेज पर, अपना ईमेल दर्ज करें और Continue पर क्लिक करें।
5. अपने Stripe अकाउंट में लॉग इन करें (या एक नया बनाएँ)। यदि आपके पास कई अकाउंट हैं, तो उस अकाउंट का चयन करें जिसे आप कनेक्ट करना चाहते हैं।
6. पुष्टि करने के लिए Connect पर क्लिक करें।
7. सफल ऑथराइज़ेशन के बाद, आपको Pushwoosh पर वापस रीडायरेक्ट कर दिया जाएगा। इंटीग्रेशन की स्थिति Connected में बदल जाएगी।

इंटीग्रेशन को डिस्कनेक्ट करें

तरीका 1. Pushwoosh के माध्यम से

1. Settings → 3rd-party integrations पर जाएँ।
2. Stripe कार्ड ढूंढें और SETTINGS बटन पर क्लिक करें।
3. पॉपअप विंडो में, Disconnect बटन पर क्लिक करें।

तरीका 2. Stripe डैशबोर्ड के माध्यम से

1. Stripe Dashboard में लॉग इन करें।
2. Settings → Team and security → Installed apps पर जाएँ।
3. Connect Extensions सेक्शन में एप्लिकेशन ढूंढें।

जब आप Stripe के माध्यम से डिस्कनेक्ट करते हैं, तो Pushwoosh स्वचालित रूप से एक सूचना प्राप्त करता है और इंटीग्रेशन को हटा देता है।

मेटाडेटा कॉन्फ़िगरेशन

Stripe भुगतान इवेंट्स Pushwoosh को भेजता है, लेकिन अतिरिक्त डेटा के बिना Pushwoosh यह नहीं बता सकता कि भुगतान किस कैंपेन या किस यूज़र का है। जब आप चेकआउट सेशन बनाते समय मेटाडेटा (कैंपेन आईडी, यूज़र या डिवाइस आईडी, प्रोडक्ट) पास करते हैं, तो प्रत्येक भुगतान सही जर्नी और यूज़र को एट्रिब्यूट किया जाता है।

इसके बाद आप Finance Overview में कैंपेन के अनुसार राजस्व देखते हैं, भुगतान करने वालों के आधार पर सेगमेंट बनाते हैं, और सही एट्रिब्यूशन के साथ ManyMoney का उपयोग करते हैं।

उपलब्ध मेटाडेटा फ़ील्ड

फ़ील्ड	विवरण	आवश्यक	उदाहरण
journey_uuids	सेमीकोलन द्वारा अलग की गई कैंपेन (जर्नी) आईडी	नहीं	bfab4bc0-b0a5-414b-befc-4aaddc429b0e;a2bff710-6b49-44d1-96a7-3232feeca6e9
user_id	यूज़र आइडेंटिफ़ायर। इवेंट कलेक्शन और device_id को लागू करने के लिए आवश्यक है	हाँ	user_12345 या email@example.com
device_id	डिवाइस हार्डवेयर आईडी (HWID)।	नहीं	hwid_abc123
product_id	प्रोडक्ट आईडी	नहीं	prod_premium
product_name	प्रोडक्ट का नाम	नहीं	Premium Plan

महत्वपूर्ण

• user_id के बिना, इवेंट्स एकत्र नहीं किए जाते हैं और device_id को अनदेखा कर दिया जाता है। व्यापक एनालिटिक्स के लिए, journey_uuids और device_id भी प्रदान करें।

• journey_uuids वैकल्पिक है और केवल मेटाडेटा के माध्यम से सेट किया जा सकता है। Stripe कैंपेन या जर्नी डेटा प्रदान नहीं करता है, इसलिए यदि आप चाहते हैं कि राजस्व किसी जर्नी को एट्रिब्यूट किया जाए तो चेकआउट सेशन बनाते समय इसे पास करें।

• product_id और product_name वैकल्पिक हैं। Pushwoosh पहले मेटाडेटा का उपयोग करता है। यदि मेटाडेटा में कोई भी गायब है, तो यह उपलब्ध होने पर Stripe से लिया जाता है। यदि किसी भी स्रोत में कोई मान नहीं है, तो फ़ील्ड संग्रहीत नहीं किया जाता है।

चेकआउट सेशन के माध्यम से मेटाडेटा पास करना

मेटाडेटा भुगतान के प्रकार के आधार पर चेकआउट सेशन बनाते समय पास किया जाता है:

भुगतान का प्रकार	पैरामीटर	Stripe इवेंट
एकमुश्त भुगतान (mode=payment)	payment_intent_data[metadata]	charge.succeeded
सब्सक्रिप्शन (mode=subscription)	subscription_data[metadata]	invoice.paid

प्रोसेसिंग के दौरान मेटाडेटा की प्राथमिकता

सब्सक्रिप्शन के लिए (invoice.paid इवेंट):

Invoice metadata → if empty → Subscription metadata

एकमुश्त भुगतान के लिए (charge.succeeded इवेंट):

Charge metadata (from payment_intent_data)

Stripe API (curl) के माध्यम से एक चेकआउट सेशन बनाना

एकमुश्त भुगतान (mode=payment)

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_live_YOUR_SECRET_KEY: \
  -d "mode=payment" \
  -d "success_url=https://example.com/success" \
  -d "cancel_url=https://example.com/cancel" \
  -d "line_items[0][price]=price_1234567890" \
  -d "line_items[0][quantity]=1" \
  -d "payment_intent_data[metadata][journey_uuids]=bfab4bc0-b0a5-414b-befc-4aaddc429b0e" \
  -d "payment_intent_data[metadata][user_id]=user_12345" \
  -d "payment_intent_data[metadata][device_id]=hwid_abc123" \
  -d "payment_intent_data[metadata][product_id]=prod_premium" \
  -d "payment_intent_data[metadata][product_name]=Premium Plan"

सब्सक्रिप्शन (mode=subscription)

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_live_YOUR_SECRET_KEY: \
  -d "mode=subscription" \
  -d "success_url=https://example.com/success" \
  -d "cancel_url=https://example.com/cancel" \
  -d "line_items[0][price]=price_monthly_premium" \
  -d "line_items[0][quantity]=1" \
  -d "subscription_data[metadata][journey_uuids]=bfab4bc0-b0a5-414b-befc-4aaddc429b0e" \
  -d "subscription_data[metadata][user_id]=user_12345" \
  -d "subscription_data[metadata][device_id]=hwid_abc123" \
  -d "subscription_data[metadata][product_name]=Monthly Premium"

डेटा देखें

सफल इंटीग्रेशन के बाद, Dashboards सेक्शन में एक नया Finance Overview डैशबोर्ड दिखाई देता है। वहां आप कैंपेन (जर्नी) के अनुसार सकल राजस्व और नई सब्सक्रिप्शन के आँकड़े देख सकते हैं।

अधिक विस्तृत जानकारी के लिए, अपने Stripe डैशबोर्ड पर जाएँ।

भुगतानों के आधार पर सेगमेंट बनाएँ

यूज़र सेगमेंट बनाने के लिए Stripe इवेंट्स का उपयोग करें:

1. Audience → Segments खोलें।
2. Create Segment → Build Segment पर क्लिक करें।
3. Add filter by में, Event पर क्लिक करें।
4. ड्रॉपडाउन से एक Stripe इवेंट चुनें (उपलब्ध इवेंट्स के लिए नीचे दी गई तालिका देखें)।

नोट

Stripe इवेंट्स इंटीग्रेशन कनेक्ट होने और भुगतान डेटा प्राप्त होने के बाद सूची में दिखाई देते हैं।

5. शर्त सेट करें: इवेंट कितनी बार हुआ और समय सीमा (जैसे पिछले 30 दिनों के दौरान, तारीखों के बीच)।
6. वैकल्पिक रूप से इवेंट एट्रिब्यूट्स द्वारा सेगमेंट को संकीर्ण करें। नीचे दी गई तालिका प्रत्येक इवेंट के लिए उपलब्ध एट्रिब्यूट्स को सूचीबद्ध करती है।

इवेंट	विवरण	एट्रिब्यूट्स
StripePaymentSucceeded	सफल भुगतान	__amount, __currency, invoice_id, journey_uuids, product_id, product_name, stripe_customer_id, subscription_id
StripeInvoicePaid	सब्सक्रिप्शन इनवॉइस का भुगतान किया गया	__amount, __currency, journey_uuids, product_id, product_name, stripe_customer_id, transaction_id, transaction_type
StripeSubscriptionCreated	सब्सक्रिप्शन बनाया गया	__amount, __currency, interval, journey_uuids, product_id, product_name, status, stripe_customer_id, subscription_id

7. अधिक इवेंट्स जोड़ने के लिए, एक और इवेंट फ़िल्टर जोड़ें और शर्तों के बीच एक ऑपरेटर (AND या OR) चुनें।

सेगमेंट बनाने के बारे में और जानें।

टिप

आप StripePaymentSucceeded (__amount, __currency, product_id) या StripeInvoicePaid (__amount, __currency, transaction_id, product_id) को कनवर्ज़न इवेंट्स के लिए एक स्रोत के रूप में भी मैप कर सकते हैं, ताकि Stripe राजस्व को RFM सेगमेंटेशन, जर्नी एट्रिब्यूशन, और ManyMoney AI में आपके अन्य राजस्व स्रोतों के साथ लाया जा सके।

ManyMoney AI असिस्टेंट

सफल Stripe इंटीग्रेशन के बाद, ManyMoney AI असिस्टेंट को स्वचालित रूप से भुगतान और सब्सक्रिप्शन के आँकड़ों तक पहुँच प्राप्त हो जाती है।

ManyMoney डैशबोर्ड इंटरफ़ेस में उपलब्ध है। आपके द्वारा Stripe कनेक्ट करने के बाद, भुगतान डेटा विश्लेषण के लिए स्वचालित रूप से उपलब्ध हो जाता है। किसी अतिरिक्त कॉन्फ़िगरेशन की आवश्यकता नहीं है।

ManyMoney क्या कर सकता है

• राजस्व का विश्लेषण करें: आय, कनवर्ज़न और कैंपेन की प्रभावशीलता के बारे में सवालों के जवाब देता है।
• अवधियों की तुलना करें: विभिन्न समय अंतरालों में भुगतान और सब्सक्रिप्शन की गतिशीलता दिखाता है।
• ट्रेंड्स की पहचान करें: बढ़ते और घटते प्रोडक्ट्स और ऑडियंस सेगमेंट का पता लगाता है।
• सिफारिशें प्रदान करें: भुगतान डेटा के आधार पर ऑप्टिमाइज़ेशन का सुझाव देता है।

प्रॉम्प्ट के उदाहरण

• पिछले महीने कैंपेन ने कितना राजस्व उत्पन्न किया?
• जनवरी और फरवरी के बीच सब्सक्रिप्शन कनवर्ज़न दरों की तुलना करें
• रिफंड के आँकड़े दिखाएँ