Sell Collection subscriptions on Joomag using Stripe! This integration will allow you to seamlessly manage recurring payments, engage your audience, and build a loyal reader base.
With this guide we’ll assist you in connecting your Joomag account with Stripe, enabling you to sell publication subscriptions on Joomag while utilizing Stripe as your chosen payment gateway.Here's the outline for the process of creating Subscription products on Stripe that align with your Joomag collection.
Step 1: Enable Test mode for your Stripe Developer portal
Step 2: Create a Collection Subscription product
Step 3: Add the Webhook Endpoint URL provided by Joomag
Step 4: Generate Stripe API key
Step 5: Get the checkout URL according to the product
Step 6: Explore the distribution ways
Step 7: Push the product to Live environment
Step 1: Enable Test mode for your Stripe Developer portal
It’s preferable to enable Test mode in your Developer portal on Stripe to create products and set prices. Test mode can be used to simulate transactions to make sure that your integration works correctly. This feature helps to identify any bugs or errors in your Stripe implementation before you go live with actual payments.
Step 2: Create a Collection Subscription product
a. Navigate to the Products section of your Dashboard and click the “Add product” button to create a new product.
b. You will now be prompted to provide details about your product. These typically include:
Name: Enter a name for the product, e.g. “Subscription to Magazine”
Description: Add a brief description of the product to help users understand what it is.
c. Scroll down to the “Price information” section. In the “Pricing details” section specify the following fields:
Unit Amount: Enter the price of your product
Recurring: Select the “Recurring” option for Subscription purchases and choose the billing period.
d. Locate and click the “Additional options” dropdown to configure the required metadata. The following two key-value pairs should be added.
Key: handler
Value: JoomagKey: collection
Value: Collection MID
*Check this article to locate and get the collection MID.
e. Save the product.
Step 3: Add the Webhook Endpoint URL provided by Joomag
a. Open "Developers" > "Webhooks" section and click the "Add endpoint" button to create a new Webhook endpoint.
b. Enter the endpoint URL provided by Joomag. This is where Stripe will send Webhook notifications. It typically looks like: https://your-joomag-url.com/stripe-webhook.
c. Add the following events to be notified about via Webhook and Save the endpoint.
Invoice.payment_succeeded
Checkout.session.completed
d. After the endpoint is created, click on it to locate the Webhook signing secret key.
1. Inside the newly created endpoint click “Reveal” and copy the secret key
2. Log into your Joomag account, open Settings>Integrations>Stripe API section.
3. Paste the copied key into the Webhook signing secret key field.
Step 4: Generate Stripe API key
a. Go to the API keys section and locate the Restricted keys part. Click “Created restricted key”.
b. Give a name to the newly created API and add the following permissions:
Products
Checkout Sessions
c. Scroll down the page and click Save.
d. Locate the newly created API in the Restricted keys section and click Reveal key to show and copy the necessary information.
e. Add the key to the Integrations>Stripe API section of your Joomag account.
Step 5: Get the checkout URL according to the product
Create a Payment link to share with your audience or post on your distribution channels. For this, click the Single publication product you already have available in the Products page and locate the Pricing section of the description.
a. Click the “Create payment link” button
b. Make sure that everything looks correctly on preview and click “Create link”
Step 6: Explore the distribution ways
Joomag team will help you clarify your distribution ways and understand how the products will be shared with your audience after the purchase is made. With the respective Privacy option set up for the collection publications inside your Joomag account we’ll make sure that the customers get secure access to the purchased content.
Step 7: Push the product to Live environment
Once you test the integration and make sure that everything is functioning correctly, you can copy the product to Live to officially launch them to the public.
For this you can click on the product on the products page to open the description page and click “Copy to live”.
We’re all set! Now anytime someone makes a purchase through the generated Stripe URL, they will receive access to the respective Publication subscription available on Joomag.