This guide walks you through connecting your Joomag account with Stripe to sell collection subscriptions while using Stripe as your payment gateway.

Overview:
Step 1: Enable Test mode
Step 2: Create a Collection Subscription product
Step 3: Add the Webhook Endpoint URL
Step 4: Generate Stripe API key
Step 5: Get the checkout URL
Step 6: Explore distribution ways
Step 7: Push the product to Live

Enable Test mode to simulate transactions and verify your integration before going live.

a. Go to the Products section of your Stripe Dashboard and click Add product.
b. Enter a name (e.g. "Subscription to Magazine") and description.
c. In Price information, set the Unit Amount and select Recurring with the billing period.
d. In Additional options, add the following metadata key-value pairs:
- Key: handler / Value: Joomag
- Key: collection / Value: Collection MID
*See this article to get the collection MID.
e. Save the product.

a. Go to Developers > Webhooks and click Add endpoint.
b. Enter the endpoint URL provided by Joomag.
c. Add these events: Invoice.payment_succeeded, Checkout.session.completed. Save the endpoint.
d. Click the endpoint, click Reveal to copy the signing secret key.
e. In your Joomag account, go to Settings > Integrations > Stripe API and paste the key into the Webhook signing secret key field.

a. Go to API keys and click Create restricted key.
b. Name the key and add permissions: Products, Checkout Sessions.
c. Click Save, then click Reveal key to copy it.
d. Paste the key in Settings > Integrations > Stripe API in your Joomag account.

a. Open the product in the Products page and locate the Pricing section.
b. Click Create payment link, verify the preview, then click Create link.

Contact Joomag to clarify how purchased subscriptions will be distributed. Set the appropriate Privacy option on the collection publications in your Joomag account.

Once testing is complete, open the product and click Copy to live to officially launch it.