Pick the one that matches how you work.

Stripe only

Connect Stripe in the CRM. Your Stripe customers show up on their own.

Your database only

Send each customer with contacts.upsert. Then send what they do and pay, so the CRM knows them as well as you do: events, subscriptions, payments, notes and conversations. See everything in the SDK or the API reference.

Both

Stripe often sends a customer before you do. Once you know their Stripe id, link them:
Upsert creates the customer if they’re new. Look up finds one you’ve already sent. Saved id is fastest: store contact.id in your own database the first time, and skip the extra call. They become one customer, and nothing is lost.

Good to know

  • Your details win. Stripe never renames a customer you’ve sent.
  • Your own customers are never merged. Linking a Stripe id that another of your customers already has fails with conflict.
  • A shared email never merges anyone. Two people can use the same address.