Stripe konnektor

Stripe konnektor

Csatlakoztasd a Stripe fiókodat a Brevóhoz a Tajo segítségével a teljes fizetési adatszinkronizáláshoz, előfizetési életciklus-kezeléshez és bevétel-vezérelt marketingautomatizáláshoz.

Áttekintés

Funkciók

• Ügyfél-szinkronizáció – Stripe ügyfelek szinkronizálása Brevo kapcsolatokba metaadatokkal együtt
• Fizetés-követés – Sikeres fizetések, visszatérítések és sikertelen terhelések követése
• Előfizetés-kezelés – Előfizetési életciklus-események szinkronizálása megtartási kampányokhoz
• Számla-adatok – Számla részletek szinkronizálása vásárlás utáni és megújítási automatizáláshoz
• Bevétel-attribúció – Élettartami érték és MRR leképezése Brevo attribútumokhoz
• Webhook-események – Valós idejű esemény értesítések minden fizetési tevékenységhez
• Több valuta támogatás – Fizetések kezelése több valutában
• Checkout munkamenet-követés – Stripe Checkout követése elhagyott fizetés visszaállítására

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Stripe fiókkal API-hozzáféréssel
2. Stripe API kulcsokkal (nyilvános és titkos kulcs)
3. Egy Brevo fiókkal API-hozzáféréssel
4. Egy Tajo fiókkal

Hitelesítés

API kulcs hitelesítés

A Stripe bearer token hitelesítést használ a titkos API kulcsoddal.

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

Korlátozott API kulcsok

Hozz létre korlátozott kulcsokat meghatározott jogosultságokkal a fokozott biztonságért:

1. Menj a Stripe Dashboard > Fejlesztők > API kulcsok menübe
2. Kattints a „Korlátozott kulcs létrehozása” gombra
3. Adj meg csak a Tajo által igényelt jogosultságokat

Szükséges jogosultságok

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

Konfiguráció

Alapbeállítás

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

Mezőleképezés

Képezd le a Stripe ügyféladatokat Brevo kapcsolat-attribútumokhoz:

Egyéni attribútum-leképezés

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 végpontok

Alap végpontok

Előfizetési végpontok

Esemény-végpontok

Események

Fizetési események

Előfizetési események

Ügyfél-események

Kódpéldák

A konnektor inicializálása

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
});

Ügyfél-szinkronizálás futtatása

// 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 webhookok kezelése

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 });
});

Ráta-korlátok

A Stripe a következő ráta-korlátokat alkalmazza:

Hibaelhárítás

Gyakori problémák

Hibakeresési mód

Engedélyezd a részletes naplózást:

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

Kapcsolat tesztelése

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

Legjobb gyakorlatok

1. Használj korlátozott API kulcsokat – Hozz létre kulcsokat minimálisan szükséges jogosultságokkal
2. Mindig ellenőrizd a webhook aláírásokat – Megelőzd a hamis webhook eseményeket
3. Kezelj idempotenciát – Használj Stripe esemény azonosítókat a duplikált feldolgozás megelőzéséhez
4. Szinkronizálj ügyfél-metaadatokat – Tárold a marketinghez releváns adatokat a Stripe metaadatmezőkben
5. Figyeld a webhook kézbesítést – Ellenőrizd a Stripe Dashboardot a sikertelen kézbesítésekért
6. Először használj tesztmódot – Validáld az integráció a Stripe tesztmóddal és teszta-órákkal

Biztonság

• API kulcs hitelesítés – Titkos kulcs alapú hozzáférés korlátozott kulcs támogatással
• Webhook aláírás-ellenőrzés – HMAC SHA-256 aláírás-ellenőrzés
• TLS titkosítás – Minden API kommunikáció HTTPS-en keresztül titkosítva
• PCI megfelelőség – A Stripe kezeli a PCI DSS megfelelőséget a fizetési adatokhoz
• IP engedélyezési lista – Opcionális IP korlátozások az API-hozzáféréshez

Kapcsolódó források

• Stripe API dokumentáció
• Stripe Webhookok útmutató
• Shopify konnektor
• Ügyfél-szinkronizáció Skill
• Brevo Contacts API