Σύνδεσμος Stripe

Σύνδεσμος Stripe

Συνδέστε τον λογαριασμό Stripe με το Brevo μέσω Tajo για πλήρη συγχρονισμό δεδομένων πληρωμής, διαχείριση κύκλου ζωής συνδρομής και αυτοματοποίηση marketing βάσει εσόδων.

Επισκόπηση

Χαρακτηριστικά

• Συγχρονισμός πελατών - Συγχρονισμός πελατών Stripe με επαφές Brevo συμπεριλαμβανομένων μεταδεδομένων
• Παρακολούθηση πληρωμών - Παρακολούθηση επιτυχημένων πληρωμών, επιστροφών και αποτυχημένων χρεώσεων
• Διαχείριση συνδρομής - Συγχρονισμός εκδηλώσεων κύκλου ζωής συνδρομής για καμπάνιες διατήρησης
• Δεδομένα τιμολογίου - Συγχρονισμός λεπτομερειών τιμολογίου για αυτοματοποίηση μετά-αγοράς και ανανέωσης
• Απόδοση εσόδων - Αντιστοίχηση αξίας διάρκειας ζωής και MRR σε χαρακτηριστικά Brevo
• Εκδηλώσεις webhook - Ειδοποιήσεις εκδηλώσεων σε πραγματικό χρόνο για όλες τις δραστηριότητες πληρωμής
• Υποστήριξη πολλαπλών νομισμάτων - Χειρισμός πληρωμών σε πολλαπλά νομίσματα
• Παρακολούθηση συνεδρίας checkout - Παρακολούθηση Stripe Checkout για ανάκτηση εγκαταλελειμμένης πληρωμής

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Stripe με πρόσβαση API
2. Κλειδιά API Stripe (δημοσιεύσιμα και μυστικά κλειδιά)
3. Λογαριασμό Brevo με πρόσβαση API
4. Λογαριασμό Tajo

Πιστοποίηση

Πιστοποίηση με API Key

Το Stripe χρησιμοποιεί πιστοποίηση bearer token με το μυστικό κλειδί API σας.

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

Περιορισμένα API Keys

Δημιουργήστε περιορισμένα κλειδιά με συγκεκριμένα δικαιώματα για ενισχυμένη ασφάλεια:

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

Endpoints API

Βασικά Endpoints

Endpoints Συνδρομής

Endpoints Εκδηλώσεων

Εκδηλώσεις

Εκδηλώσεις Πληρωμής

Εκδηλώσεις Συνδρομής

Εκδηλώσεις Πελάτη

Παραδείγματα Κώδικα

Αρχικοποίηση Συνδέσμου

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
// }

Χειρισμός Webhooks 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 keys - Δημιουργήστε κλειδιά με ελάχιστα απαιτούμενα δικαιώματα
2. Να επαληθεύετε πάντα υπογραφές webhook - Αποτρέψτε πλαστογραφημένες εκδηλώσεις webhook
3. Χειριστείτε idempotency - Χρησιμοποιήστε IDs εκδηλώσεων Stripe για αποτροπή διπλής επεξεργασίας
4. Συγχρονίστε μεταδεδομένα πελάτη - Αποθηκεύστε δεδομένα σχετικά με marketing στα πεδία μεταδεδομένων Stripe
5. Παρακολουθήστε παράδοση webhook - Ελέγξτε το Stripe Dashboard για αποτυχημένες παραδόσεις
6. Χρησιμοποιήστε πρώτα τη λειτουργία δοκιμής - Επικυρώστε την ενσωμάτωσή σας με λειτουργία δοκιμής Stripe και test clocks

Ασφάλεια

• Πιστοποίηση API Key - Πρόσβαση βάσει μυστικού κλειδιού με υποστήριξη περιορισμένου κλειδιού
• Επικύρωση υπογραφής webhook - Επικύρωση υπογραφής HMAC SHA-256
• Κρυπτογράφηση TLS - Όλη η επικοινωνία API κρυπτογραφείται μέσω HTTPS
• Συμμόρφωση PCI - Το Stripe χειρίζεται συμμόρφωση PCI DSS για δεδομένα πληρωμής
• Allowlisting IP - Προαιρετικοί περιορισμοί IP για πρόσβαση API

Σχετικοί Πόροι

• Τεκμηρίωση API Stripe
• Οδηγός Webhooks Stripe
• Σύνδεσμος Shopify
• Δεξιότητα Συγχρονισμού Πελατών
• API Επαφών Brevo