Using Relay to sell across apps
The Orders API has built-in support for selling your products across apps. To get started, read how to define your products and SKUs.
Connect to apps
If you are interested in selling your products across popular shopping and social media platforms, Relay lets you do so easily. Relay lets apps you connect to order your products using the product and order objects as described above. By connecting to them, you enable users of those applications to buy your products without even visiting your website, greatly expanding your business’s reach. Apps can easily sell your products through every interface they offer, including mobile sites and apps. You can use the apps to promote your products, and then apps will take over: creating the orders and accepting payment on your behalf.
Visit an app’s site to see if they offer a Stripe Relay integration. If so, they’ll provide a page that likely contains a button like:
Just click on the button and follow through the interface to connect your account.
Note that you only need to register your products and SKUs in your Stripe account once, and you can connect to as many apps as you’d like. Just select the right platforms for your business, and Stripe takes care of sending them the right info to display your products in their app.
Stripe does allow apps to take an application fee on order payments. You may want to check an app’s policy on this before connecting.
Manage orders from Relay apps
When a customer buys products through an app you’ve enabled, the app will:
- Create an order. This happens when the customer first establishes intent to purchase the product, such as by clicking a “Buy Button”.
- Accept payment for the order. This happens at the end of the checkout flow.
With the order paid for, it’s time for you to fulfill it, whether that means providing a downloadable digital good or shipping a physical one.
Stripe will notify you of orders via webhooks. With webhooks, you’ll want to pay particular attention to
order.payment_succeeded events, as they indicate further action is required on your part. With your own Relay integration, a developer would likely build a display of order information in a portal on your site for easy viewing.
If you’re relying upon email, use the Dashboard to obtain any further necessary information. On a specific order page, you can find the customer and order details.
Once you’ve delivered the order, mark it as fulfilled in your Stripe account. You can do this on the order’s page in the Dashboard, or by making an update order API call.
Understand that enabling a Relay application means giving it the ability to create and pay for orders with your products and SKUs. You can still use the API or the Dashboard to manage these orders including marking them as fulfilled, issuing refunds, etc.