Stripe Konektor

Stripe Konektor

Povežite svoj Stripe račun s Brevom putem Taja za potpunu sinkronizaciju podataka o plaćanjima, upravljanje životnim ciklusom pretplata i marketinšku automatizaciju vođenu prihodom.

Pregled

Značajke

• Sinkronizacija kupaca - Sinkronizacija Stripe kupaca s Brevo kontaktima uključujući metapodatke
• Praćenje plaćanja - Praćenje uspješnih plaćanja, povrata i neuspjelih naknada
• Upravljanje pretplatama - Sinkronizacija događaja životnog ciklusa pretplata za kampanje zadržavanja
• Podaci o fakturama - Sinkronizacija detalja faktura za automatizaciju nakon kupnje i obnove
• Atribucija prihoda - Mapiranje životne vrijednosti i MRR-a na Brevo atribute
• Webhook događaji - Obavijesti o događajima u stvarnom vremenu za sve aktivnosti plaćanja
• Podrška za više valuta - Rukovanje plaćanjima u više valuta
• Praćenje sesija blagajne - Praćenje Stripe Checkout-a za oporavak napuštenog plaćanja

Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Stripe račun s API pristupom
2. Stripe API ključeve (javni i tajni ključevi)
3. Brevo račun s API pristupom
4. Tajo račun

Autentifikacija

Autentifikacija API ključem

Stripe koristi autentifikaciju bearer tokenom s vašim tajnim API ključem.

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

Ograničeni API ključevi

Kreirajte ograničene ključeve s određenim dozvolama za poboljšanu sigurnost:

1. Idite na Stripe Dashboard > Programeri > API ključevi
2. Kliknite “Kreiraj ograničeni ključ”
3. Dodijelite samo dozvole koje Tajo zahtijeva

Potrebne dozvole

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

Konfiguracija

Osnovna konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      customers: true
      payments: true
      subscriptions: true
      invoices: true
      products: true

    # Dodjela Brevo popisa
    lists:
      all_customers: 20
      subscribers: 21
      churned: 22

Mapiranje polja

Mapirajte podatke Stripe kupaca na Brevo atribute kontakata:

Mapiranje prilagođenih atributa

field_mapping:
  # Standardna polja
  email: email
  name: FULLNAME
  phone: SMS

  # Metrike plaćanja
  total_spent: TOTAL_SPENT
  payment_count: PAYMENT_COUNT
  last_payment_date: LAST_PAYMENT_DATE
  average_order_value: AOV

  # Polja pretplate
  subscription_status: SUB_STATUS
  plan_name: PLAN_NAME
  mrr: MONTHLY_REVENUE
  subscription_start: SUB_START_DATE

  # Prilagođeni metapodaci
  metadata.customer_tier: VIP_TIER
  metadata.referral_source: REFERRAL_SOURCE

API krajnje točke

Osnovne krajnje točke

Krajnje točke pretplata

Krajnje točke događaja

Događaji

Događaji plaćanja

Događaji pretplata

Događaji kupaca

Primjeri koda

Inicijalizacija konektora

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

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

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

Pokretanje sinkronizacije kupaca

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

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

Rukovanje Stripe webhookovima

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

  // Proslijedite Taju za Brevo sinkronizaciju
  await tajo.connectors.handleWebhook('stripe', {
    type: event.type,
    data: event.data.object
  });

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

Ograničenja brzine

Stripe primjenjuje sljedeća ograničenja brzine:

Rješavanje problema

Uobičajeni problemi

Način otklanjanja grešaka

Omogućite detaljno zapisivanje:

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

Testiranje veze

tajo connectors test stripe
# ✓ API veza uspješna
# ✓ Kupci čitljivi
# ✓ Pretplate čitljive
# ✓ Plaćanja čitljiva
# ✓ Webhook krajnja točka verificirana

Preporučene prakse

1. Koristite ograničene API ključeve - Kreirajte ključeve s minimalnim potrebnim dozvolama
2. Uvijek verificirajte potpise webhookova - Spriječite lažne webhook događaje
3. Rukujte idempotentnosti - Koristite Stripe ID-ove događaja za sprječavanje dupliciranog procesiranja
4. Sinkronizirajte metapodatke kupaca - Pohranite marketinški relevantne podatke u Stripe metapodatke
5. Pratite isporuku webhookova - Provjerite Stripe Dashboard za neuspjele isporuke
6. Koristite testni način rada prvo - Validir svoju integraciju sa Stripe testnim modom i testnim satovima

Sigurnost

• Autentifikacija API ključem - Pristup tajnim ključem s podrškom ograničenih ključeva
• Verifikacija potpisa webhookova - HMAC SHA-256 validacija potpisa
• TLS šifriranje - Sva API komunikacija šifrirana putem HTTPS-a
• PCI usklađenost - Stripe rukuje PCI DSS usklađenošću za podatke o plaćanju
• IP lista dopuštenih - Opcionalna IP ograničenja za API pristup

Povezani resursi

• Stripe API dokumentacija
• Stripe vodič za webhookove
• Shopify Konektor
• Vještina sinkronizacije korisnika
• Brevo API kontakata