RevOps HQ

HubSpot Commerce and Payments Integrations

The first decision in a commerce integration is whether an order belongs in the CRM as a deal, and for most businesses running transactional volume the answer is no.

A deal is an object built to carry a sales process: a stage, an owner, a forecast and a close date. An order that arrived through a checkout has none of those and never will. Creating one deal per order produces a pipeline that is a transaction log, and every pipeline report built on it is meaningless.

9 systems in this category, 1 of them documented in a published case study.

Orders, deals, and the difference between them

The useful pattern is to let orders remain orders, associated to the customer record, and to reserve deals for the situations where a human is working an opportunity: a wholesale enquiry, a renewal being negotiated, a quote requested off-catalogue.

What the CRM needs from the commerce system is a rolled-up view against the customer, not a mirror of it. Lifetime value, last order date, order frequency and category mix are four properties that change how a conversation runs. The individual line items do not.

Subscription billing adds a second consideration, because a subscription has a state that changes without anyone touching it. A card that fails at renewal is a commercial event and it happens inside the billing system, silently, unless something is listening for it.

Integration options ordered by operational burden and data custodySix integration options in order: native connector, general-purpose iPaaS, managed integration layer, custom middleware, a build in your own cloud account, and a self-hosted deployment. Moving left to right, the share of operational work carried by a vendor falls and the share carried by the firm rises, while data at rest moves from the vendor's cloud to the firm's own datacentre. Control and custody increase in the same direction as cost and obligation, which is why neither end is a default.WHO CARRIES THE OPERATIONAL BURDENNativeconnectorOPERATED BYVendorDATA AT RESTVendor cloudGeneraliPaaSOPERATED BYVendorDATA AT RESTiPaaS cloudManagedlayerOPERATED BYOperatorDATA AT RESTOperator cloudCustommiddlewareOPERATED BYYouDATA AT RESTYour hostOwncloud buildOPERATED BYYouDATA AT RESTYour cloud accountSelf-hostedOPERATED BYYouDATA AT RESTYour datacentreUpper block: work somebody else does.Lower block: work you do, and keep doing.CUSTODY AND CONTROL INCREASE →

Where a commerce integration sits between a full mirror and a referenced link

Three custody zones and the two boundaries between themThree zones hold data: HubSpot as the system of engagement, the integration layer in the middle, and the system of financial record. HubSpot holds contact, company, deal and activity records along with OAuth grants. The integration layer holds credentials for both sides, payloads in transit, and retry queues and error logs — which is why it is the zone that matters most to a security review despite holding no records of its own. The finance system holds invoices, payments and the audit trail. Two trust boundaries are crossed, and each one is an organisation that belongs in a subprocessor list.CUSTODY ZONES — WHO HOLDS WHATHubSpotSYSTEM OF ENGAGEMENTContact and company recordsDeal and activity historyOAuth grantsThe integration layerVARIES WITH THE ARCHITECTURECredentials for both sidesPayloads in transitRetry queues and error logsSystem of financial recordSYSTEM OF RECORDInvoices and paymentsTax and audit trailIts own access modelBOUNDARY 1BOUNDARY 2The middle zone is the one the architecture choice moves. Everything else is fixed.It holds no records and every credential, which is why a review that counts only databases misses it.Each boundary crossed is an organisation that belongs on a subprocessor list.

Which records stay in the commerce system and what crosses into the CRM

Systems in this category

Shopify

Orders and lifetime value joined to the contact, refunds included.

Stripe

Subscription and payment state on the record, priced server-side.

WooCommerce

Store data mapped to objects rather than dropped into properties.

BigCommerce

Catalogue and order history reconciled to one customer.

Adobe Commerce

Order events resolved against an existing contact before creating one.

Chargebee

Subscription lifecycle events written to the deal and the company.

Recurly

Churn and dunning state visible before the renewal conversation.

Square

Point-of-sale activity attached to the customer record.

PayPal

Payment confirmation joined to the deal it settles.

Documented engagements

Each of these is a published study of one build, with the object model, the decisions taken and what the approach does not establish.

Common Questions

Frequently Asked Questions

Only where a person works the order. For transactional volume, creating one deal per order fills the pipeline with records nobody manages and makes every stage report unusable. Associate orders to the customer and reserve deals for opportunities a human owns.

Rolled-up values rather than the order history: lifetime value, first and last order dates, order count and the categories bought. Those change how someone is spoken to. A full line-item mirror rarely does and is expensive to keep accurate.

As an event the CRM listens for rather than one it discovers. A failed renewal payment is a churn signal with a short window, and it only becomes actionable if the billing system pushes it out rather than waiting to be polled.

Further reading

Long-form already published on the argument this category turns on.

Related categories

A system in this category that is not listed

The directory shows range rather than limits. A scoped build is quoted from the object model on each side and the fields that have to cross between them.

HubSpot services

Onboarding, implementation, integration, migration, administration and training, each scoped and priced before the work begins

WEEKLY PROGRAM

RevOps Office Hours

A recurring weekly RevOps operating program. Live support plus hands-on HubSpot implementation work.

$1,500/mo
Monthly Operating Program
  • 1 live Office Hours session per week
  • 4 hours of hands-on implementation work per month
  • Hours allocated against priorities agreed at the start of each period
  • Recurring monthly cadence