Skip to content

Stripe Shopify Agent integration API Reference

Select theme

Stripe
Shopify
Agent integration
API Reference

Get Started
Paths
- Subscriptions
- One Time Payments
Cart and orders
Customize Handoff
- Hosted Handoff
- Custom Domains
Shared integration
- Fulfillment and entitlements
- Local webhooks
Reference

Select theme

On this page

Overview

On this page

Overview

Find your integration path

Stripe flows differ in who creates payment objects and how the payer enters payment details. Answer these questions to find the matching Proxy guide.

Recommended for new Stripe integrations

If your project has not integrated Stripe, start with Stripe-hosted Checkout. Stripe hosts the payment form, so your product does not build payment-entry UI.

Which payment types does your Stripe integration support?

One-time paymentsSubscriptionsBoth

Who creates the PaymentIntent?

Stripe CheckoutYour server creates a Checkout Session, then Stripe creates the PaymentIntent.Your serverYour server creates the PaymentIntent directly.

Who creates the Subscription?

Stripe CheckoutYour server creates a Checkout Session, then Stripe creates the Subscription.Your serverYour server creates the Subscription directly.

How does your product present one-time Stripe Checkout?

Stripe-hosted pageEmbedded CheckoutCustom Checkout with Elements

How does your product present subscription Stripe Checkout?

Stripe-hosted pageEmbedded CheckoutCustom Checkout with Elements

Matching integration paths

Open the guide for each payment type you selected. Links open in a new tab.

One-time payment with hosted CheckoutStripe hosts the payment form and creates the PaymentIntent. Path ID: OT-CO-H.

One-time payment with embedded CheckoutYour page embeds Stripe Checkout. Stripe creates the PaymentIntent. Path ID: OT-CO-E.

One-time payment with ElementsYour Elements UI uses a Checkout Session that creates the PaymentIntent. Path ID: OT-CO-C.

One-time payment with your PaymentIntentYour server creates the PaymentIntent directly. Path ID: OT-PI.

Subscription with hosted CheckoutStripe hosts the payment form and creates the Subscription. Path ID: SUB-CO-H.

Subscription with embedded CheckoutYour page embeds Stripe Checkout. Stripe creates the Subscription. Path ID: SUB-CO-E.

Subscription with ElementsYour Elements UI uses a Checkout Session that creates the Subscription. Path ID: SUB-CO-C.

Subscription after collecting a payment methodYour server uses a SetupIntent to collect a payment method, then creates the Subscription. Path ID: SUB-SI.

Subscription with an authorized saved payment methodYour server creates the Subscription from an authorized saved PaymentMethod. Path ID: SUB-SAVED.

Previous
Render a handoff button Next
Stripe-hosted Checkout