This guide walks you through connecting your Joomag account with Stripe to sell individual publications while using Stripe as your payment gateway.
Overview:
Step 1: Enable Test mode
Step 2: Create a Single publication 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
Step 1: Enable Test mode for your Stripe Developer portal
Enable Test mode to simulate transactions and verify your integration before going live.
Step 2: Create a single publication product
a. Go to the Products section of your Stripe Dashboard and click Add product.
b. Enter a name and description.
c. In Price information, set the Unit Amount and select One time for single publication purchases.
d. In Additional options, add the following metadata key-value pairs:
- Key: handler / Value: Joomag
- Key: publication / Value: publication UID
*See this article to get the publication UID.
e. Save the product.
Step 3: Add the Webhook Endpoint URL
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.
Step 4: Generate Stripe API key
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.
Step 5: Get the checkout URL
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.
Step 6: Explore distribution ways
Contact Joomag to clarify how purchased content will be distributed. Set the appropriate Privacy option on the publication in your Joomag account.
Step 7: Push the product to Live
Once testing is complete, open the product and click Copy to live to officially launch it.