Stripe کنیکٹر

Stripe کنیکٹر

مکمل ادائیگی ڈیٹا سنکرونائزیشن، سبسکرپشن لائف سائیکل مینجمنٹ، اور آمدنی سے چلنے والی مارکیٹنگ آٹومیشن کے لیے Tajo کے ذریعے اپنے Stripe اکاؤنٹ کو Brevo سے منسلک کریں۔

جائزہ

خصوصیات

• گاہک سنک - میٹا ڈیٹا سمیت Stripe گاہکوں کو Brevo رابطوں کے ساتھ سنک کریں
• ادائیگی ٹریکنگ - کامیاب ادائیگیوں، رقم کی واپسی، اور ناکام چارجز کو ٹریک کریں
• سبسکرپشن مینجمنٹ - برقراری مہمات کے لیے سبسکرپشن لائف سائیکل ایونٹس سنک کریں
• انوائس ڈیٹا - خریداری کے بعد اور تجدید آٹومیشن کے لیے انوائس کی تفصیلات سنک کریں
• آمدنی کی انتساب - Brevo خصوصیات پر لائف ٹائم ویلیو اور MRR میپ کریں
• Webhook ایونٹس - تمام ادائیگی سرگرمیوں کے لیے ریئل ٹائم ایونٹ نوٹیفکیشنز
• کثیر کرنسی سپورٹ - متعدد کرنسیوں میں ادائیگیوں کو سنبھالیں
• چیک آؤٹ سیشن ٹریکنگ - ترک شدہ ادائیگی کی بحالی کے لیے Stripe Checkout ٹریک کریں

شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. API رسائی کے ساتھ Stripe اکاؤنٹ
2. Stripe API کیز (قابل اشاعت اور خفیہ کیز)
3. API رسائی کے ساتھ Brevo اکاؤنٹ
4. Tajo اکاؤنٹ

تصدیق

API کی تصدیق

Stripe آپ کی خفیہ API کی کے ساتھ bearer token تصدیق استعمال کرتا ہے۔

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 Webhooks کو سنبھالیں

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. ہمیشہ webhook دستخطوں کی تصدیق کریں - جعلی webhook ایونٹس کو روکیں
3. Idempotency کو سنبھالیں - ڈپلیکیٹ پروسیسنگ کو روکنے کے لیے Stripe ایونٹ IDs استعمال کریں
4. گاہک میٹا ڈیٹا سنک کریں - Stripe میٹا ڈیٹا فیلڈز میں مارکیٹنگ سے متعلقہ ڈیٹا ذخیرہ کریں
5. Webhook ڈیلیوری کی نگرانی کریں - ناکام ڈیلیوریوں کے لیے Stripe Dashboard چیک کریں
6. پہلے ٹیسٹ موڈ استعمال کریں - Stripe ٹیسٹ موڈ اور ٹیسٹ کلاکس کے ساتھ اپنی انٹیگریشن کی توثیق کریں

سیکیورٹی

• API کی تصدیق - محدود کی سپورٹ کے ساتھ خفیہ کی پر مبنی رسائی
• Webhook دستخط کی تصدیق - HMAC SHA-256 دستخط کی توثیق
• TLS انکرپشن - تمام API مواصلات HTTPS کے ذریعے انکرپٹڈ
• PCI کمپلائنس - Stripe ادائیگی کے ڈیٹا کے لیے PCI DSS کمپلائنس سنبھالتا ہے
• IP وائٹ لسٹنگ - API رسائی کے لیے اختیاری IP پابندیاں

متعلقہ وسائل

• Stripe API دستاویزات
• Stripe Webhooks گائیڈ
• Shopify کنیکٹر
• گاہک سنک اسکل
• Brevo Contacts API