The Stripe Customers object has two critical fields for identification:
- Billing Email Address: the current Billing Email Address for the customer (only one!), which we should assume can change when the customer needs to update it.
- Customer Name: a text string that is usually human-entered and is often inconsistent. It’s common, for example, to have a mix of real company names, people’s names (the billing contact), and useless names like “none”.
In HubSpot, Contacts are unique by email address, which makes for easy mapping to the Stripe Customer Billing Email Address.
- However, HubSpot Companies are more complex and are often structured uniquely in different implementations. If you have the common setting “Automatically associate Contacts with Companies” turned on, then you’re likely using unique Domains to match Contacts to existing Companies. Contacts inserted with new unique domains would result in newly created HubSpot Companies.
Important data structure considerations:
- (1) One Stripe Customer can have many Stripe Subscriptions.
- (2) Stripe would treat multiple Customers with the same business email domain as unrelated, but they’d typically map to the same single HubSpot Company.