Stripe कनेक्टर

Stripe कनेक्टर

संपूर्ण भुगतान डेटा सिंक्रोनाइज़ेशन, सब्सक्रिप्शन जीवनचक्र प्रबंधन, और राजस्व-आधारित मार्केटिंग ऑटोमेशन के लिए अपने Stripe खाते को Tajo के माध्यम से Brevo से कनेक्ट करें।

अवलोकन

विशेषताएं

• ग्राहक सिंक - मेटाडेटा सहित Stripe ग्राहकों को Brevo कॉन्टैक्ट्स के साथ सिंक करें
• भुगतान ट्रैकिंग - सफल भुगतान, रिफ़ंड, और विफल चार्ज ट्रैक करें
• सब्सक्रिप्शन प्रबंधन - रिटेंशन अभियानों के लिए सब्सक्रिप्शन जीवनचक्र इवेंट्स सिंक करें
• इनवॉइस डेटा - पोस्ट-परचेज़ और नवीनीकरण ऑटोमेशन के लिए इनवॉइस विवरण सिंक करें
• राजस्व एट्रिब्यूशन - जीवनकाल मूल्य और MRR को Brevo एट्रिब्यूट्स में मैप करें
• वेबहुक इवेंट्स - सभी भुगतान गतिविधियों के लिए रीयल-टाइम इवेंट सूचनाएं
• मल्टी-करेंसी समर्थन - कई मुद्राओं में भुगतान संभालें
• चेकआउट सत्र ट्रैकिंग - त्याग किए गए भुगतान रिकवरी के लिए Stripe Checkout ट्रैक करें

पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

1. API एक्सेस वाला एक Stripe खाता
2. Stripe API कीज़ (पब्लिशेबल और सीक्रेट कीज़)
3. API एक्सेस वाला एक Brevo खाता
4. एक Tajo खाता

प्रमाणीकरण

API की प्रमाणीकरण

Stripe आपकी सीक्रेट API की के साथ बियरर टोकन प्रमाणीकरण का उपयोग करता है।

curl https://api.stripe.com/v1/customers \
  -u sk_live_YOUR_SECRET_KEY:

प्रतिबंधित API कीज़

बेहतर सुरक्षा के लिए विशिष्ट अनुमतियों के साथ प्रतिबंधित कीज़ बनाएं:

1. Stripe Dashboard > Developers > API Keys पर जाएं
2. “Create restricted key” पर क्लिक करें
3. केवल वे अनुमतियां प्रदान करें जो Tajo को चाहिए

आवश्यक अनुमतियां

customers: read
charges: read
payment_intents: read
subscriptions: read
invoices: read
events: read
products: read
prices: read

कॉन्फ़िगरेशन

बुनियादी सेटअप

connectors:
  stripe:
    enabled: true
    secret_key: "${STRIPE_SECRET_KEY}"
    webhook_secret: "${STRIPE_WEBHOOK_SECRET}"

    # Data sync options
    sync:
      customers: true
      payments: true
      subscriptions: true
      invoices: true
      products: true

    # Brevo list assignment
    lists:
      all_customers: 20
      subscribers: 21
      churned: 22

फ़ील्ड मैपिंग

Stripe ग्राहक डेटा को Brevo कॉन्टैक्ट एट्रिब्यूट्स में मैप करें:

कस्टम एट्रिब्यूट मैपिंग

field_mapping:
  # Standard fields
  email: email
  name: FULLNAME
  phone: SMS

  # Payment metrics
  total_spent: TOTAL_SPENT
  payment_count: PAYMENT_COUNT
  last_payment_date: LAST_PAYMENT_DATE
  average_order_value: AOV

  # Subscription fields
  subscription_status: SUB_STATUS
  plan_name: PLAN_NAME
  mrr: MONTHLY_REVENUE
  subscription_start: SUB_START_DATE

  # Custom metadata
  metadata.customer_tier: VIP_TIER
  metadata.referral_source: REFERRAL_SOURCE

API एंडपॉइंट्स

मुख्य एंडपॉइंट्स

सब्सक्रिप्शन एंडपॉइंट्स

इवेंट एंडपॉइंट्स

इवेंट्स

भुगतान इवेंट्स

सब्सक्रिप्शन इवेंट्स

ग्राहक इवेंट्स

कोड उदाहरण

कनेक्टर प्रारंभ करें

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Stripe
await tajo.connectors.connect('stripe', {
  secretKey: process.env.STRIPE_SECRET_KEY,
  webhookSecret: process.env.STRIPE_WEBHOOK_SECRET
});

ग्राहक सिंक चलाएं

// Full historical sync
await tajo.connectors.sync('stripe', {
  type: 'full',
  resources: ['customers', 'subscriptions', 'payments'],
  since: '2023-01-01'
});

// Check sync status
const status = await tajo.connectors.status('stripe');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   customersSynced: 12500,
//   subscriptionsSynced: 8200,
//   paymentsSynced: 45000
// }

Stripe वेबहुक्स संभालें

import Stripe from 'stripe';

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);

app.post('/webhooks/stripe', async (req, res) => {
  const sig = req.headers['stripe-signature'];

  let event;
  try {
    event = stripe.webhooks.constructEvent(
      req.body,
      sig,
      process.env.STRIPE_WEBHOOK_SECRET
    );
  } catch (err) {
    return res.status(400).send(`Webhook Error: ${err.message}`);
  }

  // Forward to Tajo for Brevo sync
  await tajo.connectors.handleWebhook('stripe', {
    type: event.type,
    data: event.data.object
  });

  res.status(200).json({ received: true });
});

दर सीमाएं

Stripe निम्नलिखित दर सीमाएं लागू करता है:

समस्या निवारण

सामान्य समस्याएं

डीबग मोड

विस्तृत लॉगिंग सक्षम करें:

connectors:
  stripe:
    debug: true
    log_level: verbose
    log_webhooks: true

कनेक्शन परीक्षण करें

tajo connectors test stripe
# ✓ API connection successful
# ✓ Customers readable
# ✓ Subscriptions readable
# ✓ Payments readable
# ✓ Webhook endpoint verified

सर्वोत्तम प्रथाएं

1. प्रतिबंधित API कीज़ का उपयोग करें - न्यूनतम आवश्यक अनुमतियों के साथ कीज़ बनाएं
2. हमेशा वेबहुक सिग्नेचर सत्यापित करें - धोखाधड़ी वाले वेबहुक इवेंट्स को रोकें
3. इडेम्पोटेंसी संभालें - डुप्लिकेट प्रोसेसिंग को रोकने के लिए Stripe इवेंट IDs का उपयोग करें
4. ग्राहक मेटाडेटा सिंक करें - Stripe मेटाडेटा फ़ील्ड्स में मार्केटिंग-प्रासंगिक डेटा स्टोर करें
5. वेबहुक डिलीवरी की निगरानी करें - विफल डिलीवरी के लिए Stripe Dashboard जांचें
6. पहले टेस्ट मोड का उपयोग करें - Stripe टेस्ट मोड और टेस्ट क्लॉक्स के साथ अपने इंटीग्रेशन को मान्य करें

सुरक्षा

• API की प्रमाणीकरण - प्रतिबंधित की समर्थन के साथ सीक्रेट की-आधारित एक्सेस
• वेबहुक सिग्नेचर सत्यापन - HMAC SHA-256 सिग्नेचर सत्यापन
• TLS एन्क्रिप्शन - HTTPS के माध्यम से सभी API संचार एन्क्रिप्टेड
• PCI अनुपालन - Stripe भुगतान डेटा के लिए PCI DSS अनुपालन संभालता है
• IP व्हाइटलिस्टिंग - API एक्सेस के लिए वैकल्पिक IP प्रतिबंध

संबंधित संसाधन

• Stripe API Documentation
• Stripe Webhooks Guide
• Shopify Connector
• Customer Sync Skill
• Brevo Contacts API