SamCart Integration Guide

Overview

WisePub integrates seamlessly with SamCart to manage your product subscriptions and user access. When users purchase a product or their subscription status changes in SamCart, the integration automatically updates their access in WisePub.

Prerequisites

• A SamCart account with products already set up (test or production mode)
• The Scale plan in SamCart is strongly recommended for API access
• A WisePub account

Why Choose the Scale Plan?

While the integration works with other SamCart plans using webhooks, the Scale plan offers several advantages:

• Access to the SamCart API for simplified product matching
• Upcoming feature with WisePub: Built-in subscription management interface in WisePub
• Compliance with modern regulations requiring self-service subscription cancellation
• Enhanced user experience and reduced support overhead

Integration Steps

1. Obtain Your SamCart API Key

1. Navigate to SamCart support
2. Open a support chat
3. Request an API key for the integration
4. Save the provided API key securely
5. Usually they are pretty quick at sending you the api key but it can take 1 day to complete the request

2. Configure WisePub Settings

1. Log into WisePub
2. Go to Settings
3. Create a new setting:
   • Name it “samcart” (all lower case)
   • Set environment to “production”
   • Select “SamCart” as the setting type
4. Edit the settings:
   • Input your SamCart API key
   • Generate or input a webhook secret. So the secret will be empty at first, you can creatre your own secret or copy it from the helper section below the input field (see below screenshot)
   • Save the changes

3. Match Your Products

1. Once saved, the subscription will show and you can match it to products
2. For each subscription:
   • Select the corresponding SamCart product(s)
   • Hold Ctrl/Cmd to select multiple products if needed
3. Click “Update Settings” to save the matches

4. Set Up SamCart Webhooks

1. Go to SamCart Settings
2. Navigate to Integrations
3. Search for “webhook”
4. Click “Install”
5. Copy the webhook URL from your WisePub SamCart settings page. (Found under the secret input field in the edit setting page)
6. Paste the URL in SamCart and click “Connect”

5. Configure Webhook Rules

1. Click “Add New Rule”
2. Select “Global Rule” (recommended)
3. Add the following actions:
   • Order Completed
   • Product Purchase
   • Upsell Purchase
   • Subscription Cancel
   • Subscription Delinquent
   • Subscription Restarted
   • Subscription Started
   • Subscription Completed
   • Subscription Charged

What Happens Next?

Once configured, the integration will:

• Automatically add users to subscriptions upon purchase
• Add users to email lists (if configured)
• Send welcome emails (based on your settings)
• Update user access when subscription status changes

Troubleshooting

If you encounter any issues:

• Verify all webhook rules are properly configured
• Ensure your API key is correctly entered in WisePub
• Check that products are properly matched
• Contact support if problems persist

Important Notes

• Keep your API key and webhook secret secure
• Test the integration with a sample purchase
• Monitor webhook notifications initially to ensure proper setup. This can be seen in the webhooks app in SamCart under the log section.