HubSpot + PayPal: why native integration does not exist and how to solve it

If you are looking for a way to accept PayPal payments through HubSpot, you are in for an unpleasant surprise. Commerce Hub, HubSpot’s payment tool, does not support PayPal at all — neither as a payment gateway nor as a source of transaction data. Companies whose customers pay via PayPal are left with a choice: switch payment systems or build a custom integration.

Why PayPal does not work with HubSpot Commerce Hub

Commerce Hub supports only two payment instruments: HubSpot Payments (available in the US, UK, and Canada) and Stripe as an external processor. PayPal, Braintree, Adyen, Square — none of these alternative gateways are supported. This is not a bug or a temporary limitation — it is an architectural decision by HubSpot.

What this means in practice:

• HubSpot payment links do not accept PayPal
• HubSpot invoices cannot be paid via PayPal
• Third-party PayPal apps from the HubSpot marketplace do not push transaction data into deals and contacts
• Companies outside the US, UK, and Canada cannot use HubSpot Payments at all

For international businesses where PayPal remains the preferred payment method for a portion of customers, this is a critical limitation.

What third-party connectors can do — and where they fall short

The HubSpot marketplace contains several third-party apps claiming PayPal integration. The reality is:

• ✅ Basic delivery of completed transaction data to the contact timeline
• ✅ Creating or updating a contact when a PayPal payment is received
• ❌ Transaction data does not reach the Deal object — no payment → deal link
• ❌ No PayPal Subscriptions sync — status, renewal date, MRR are not transmitted
• ❌ No HubSpot Workflow triggers based on PayPal events
• ❌ No handling of failed payments and expired subscriptions
• ❌ No two-way sync — only PayPal → HubSpot, not the reverse

What a custom integration from Exceltic.dev solves

• Payment → deal link — every completed PayPal transaction is automatically associated with the corresponding Deal in HubSpot by email or custom identifier
• PayPal Subscriptions sync — subscription status, plan, renewal date, and cancellation date are pushed to custom HubSpot contact and company properties
• Failed payments in CRM — when a payment is declined or a subscription expires, HubSpot creates a task for the responsible CSM with problem details
• PayPal triggers in HubSpot Workflows — events PAYMENT.SALE.COMPLETED, BILLING.SUBSCRIPTION.CANCELLED, INVOICING.INVOICE.PAID trigger automations: lifecycle stage changes, task creation, notifications
• Historical import — when the integration launches, PayPal transaction history is imported into HubSpot mapped to existing contacts
• Multi-currency — PayPal supports 25+ currencies; transaction currency data is pushed to custom Deal properties
• Two-way contact sync — a new PayPal buyer automatically creates a contact in HubSpot; email or name updates sync in both directions

How the integration works — technical process

Connection architecture

The integration is built on the PayPal Webhooks → Exceltic middleware → HubSpot CRM API v3 stack. PayPal sends real-time events through Webhook endpoints: PAYMENT.SALE.COMPLETED, INVOICING.INVOICE.PAID, BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.CANCELLED, PAYMENT.SALE.DENIED.

Authentication with PayPal is implemented via OAuth 2.0 with Client ID and Secret through the PayPal REST API. Verification of incoming webhook events is performed via PayPal Webhook Signature Verification — this prevents processing of forged requests. HubSpot authentication uses a Private App Token.

Step-by-step scenario: customer pays an invoice via PayPal

1. Customer pays a PayPal Invoice — PayPal sends the event INVOICING.INVOICE.PAID
2. Middleware verifies the webhook signature via the PayPal Verification API
3. Extracted from payload: payer_email, amount, currency_code, invoice_id
4. System looks up the contact in HubSpot: GET /crm/v3/objects/contacts?email={payer_email}
5. If the contact is found — the Payment Status property is updated to Paid, amount and payment date are recorded
6. Middleware looks up the associated Deal by the custom property PayPal Invoice ID
7. Deal is moved to the next pipeline stage via PATCH /crm/v3/objects/deals/{id}
8. A timeline event with payment details is created on the contact via the HubSpot Timeline API
9. A HubSpot Workflow is triggered: send a payment confirmation email

Scenario: PayPal subscription cancelled

1. PayPal sends the event BILLING.SUBSCRIPTION.CANCELLED
2. Middleware receives subscriber_email, plan_id, reason
3. HubSpot updates the Subscription Status property → Cancelled
4. Lifecycle Stage changes to Former Customer
5. A task is created for the CSM: “Customer cancelled subscription — find out why”
6. A win-back Sequence is launched via the HubSpot Enrollments API

What happens on error

PayPal retries webhook delivery up to 5 times with increasing intervals. Middleware uses idempotency keys based on PayPal’s event_id — each event is processed exactly once even on duplicate deliveries. If the HubSpot API is unavailable, the event is placed in a retry queue with attempts at 2, 10, and 30 minutes.

Real-world case

Wholesale distributor of medical equipment, 6 account managers, ~45 deals per month, clients in EU and US.

The company operated two payment systems simultaneously: large clients paid by bank transfer, mid-size and small clients via PayPal. HubSpot was the primary CRM, but PayPal transactions never reached it. Managers manually checked the PayPal Dashboard and updated deal statuses in HubSpot — about 2 hours per day for the team.

A separate issue was overdue PayPal invoices: without automated notifications, managers learned about payment delays several days late. Accounts receivable kept growing.

After the custom integration launched, all PayPal events are pushed to HubSpot in real time. When an invoice is overdue, a manager task is created automatically and a follow-up sequence is triggered. Over the first two months, the average accounts receivable collection period dropped from 18 to 11 days.

Result: 40+ hours returned to the team each month, accounts receivable reduced by 39%, 0 missed overdue invoices.

Which businesses benefit most

The integration is most relevant for international companies operating in markets where PayPal remains a popular payment method — EU, LATAM, Asia. HubSpot Commerce Hub is unavailable outside the US/UK/Canada, making a custom integration the only way to connect PayPal payments to CRM data.

Especially valuable for B2B companies with a long deal cycle, where invoice payment status directly affects the manager’s next steps. Visibility of PayPal transactions in HubSpot eliminates manual reconciliation and accelerates accounts receivable management.

Frequently asked questions

Why does HubSpot not support PayPal natively?
HubSpot made an architectural decision to restrict Commerce Hub to two processors: HubSpot Payments and Stripe. This allows them to control the user experience and charge a platform fee. PayPal, Braintree, and other gateways are not on that list and are not officially planned for addition.

Can Zapier be used to integrate PayPal and HubSpot?
Zapier can push basic transaction data to HubSpot contacts, but it cannot link payments to deals, sync subscriptions, or trigger Workflows based on PayPal events. For simple notifications Zapier is adequate — for real business logic it is not.

Does the integration support PayPal Subscriptions?
Yes. Middleware processes all PayPal Billing API v1 events: subscription activation, plan change, pause, cancellation, and failed payment. All events are pushed to custom HubSpot contact and company properties.

What happens to historical PayPal transactions when the integration launches?
At launch, Exceltic.dev performs an initial import of historical data via the PayPal Transactions Search API for the selected period. Transactions are mapped to existing HubSpot contacts by email without creating duplicates.

Is the integration suitable for companies outside the US?
Yes, and it is most relevant for them. HubSpot Payments is unavailable outside the US, UK, and Canada. The custom integration works with any PayPal account regardless of the country of registration.

If your customers pay via PayPal and transaction data is not reaching HubSpot — describe your requirements to the Exceltic.dev team. We will review your scenario and propose an architecture tailored to your funnel.