Payment Platforms
Collect payments from your customers by integrating with a payment platform.
Stripe
Stripe is a powerful tool for processing payments, it provides an efficient method for generating revenue from your clients. Here's a step-by-step guide to help you integrate Stripe with Mixpost Enterprise and get started with processing payments:
1. Sign up for a Stripe Account
If you haven't already, head to Stripe's website and sign up for an account.
2. Access the Stripe Dashboard
Once you've registered, log in to your Stripe account and access the Dashboard. This will be your primary interface for managing payments.
3. Get Your API Keys
From the Dashboard:
- Go to the “Developers” section.
- Click on "API Keys".
- You'll see two keys: a Publishable Key and a Secret Key. You'll need both for integration.
Note: Always keep your Secret Key confidential.
4. Integrate API Keys into Mixpost Enterprise
Once you have your API keys:
- Open the Enterprise Console from the user menu.
- Navigate to Settings ->
- Click on Stripe
- Choose "Enabled" radio input
- Input your Publishable Key and Secret Key.
- Save
5. Set Up Webhooks
Webhooks allow Stripe to communicate with Mixpost Enterprise when certain events happen (e.g., a successful payment, subscription changes, etc.).
- In your Stripe Dashboard, navigate to the "Developers" section.
- Click on "Webhooks".
- Here, you'll see the "+ Add endpoint" button. Click on it.
- Input Endpoint URL "https://your-app-url.com/mixpost/payment-webhook".
- Select "Listen to" to "Events on your account".
- Select "Version" to "Latest API version (2023-08-16)".
- Select the events the following events:
- customer.subscription.created
- customer.subscription.updated
- customer.subscription.deleted
- customer.updated
- customer.deleted
- invoice.payment_succeeded
- payment_method.automatically_updated
- Click "Add endpoint" button
After adding the endpoint, you should copy the signing secret into the Mixpost Enterprise Console:
- In your Stripe Dashboard, navigate to the "Developers" section.
- Click on "Webhooks".
- Click on added Webhook.
- Here, you'll see the "Signing secret" section and "Reveal" button, click on it.
- Copy the "Signing secret"
- Open the Enterprise Console from the user menu.
- Navigate to Settings ->
- Click on Stripe
- Input your Signing secret in "Webhook Signing secret"
- Save
6. Add pricing plans
We are adding all the necessary pricing plans in both Stripe and Mixpost Enterprise.
- In your Stripe Dashboard, navigate to the "Products" section.
- Here, you'll see the “+ Add product” button. Click on it.
- Give a plan name, for example: "Starter"
- Scroll down to the "Price information" section
- Select the "Standard pricing" model.
- Input the plan price, for example: "$9.00"
- Select "Recurring"
- Select "Billing period". Mixpost only accepts Monthly or Yearly billing periods.
- If you are planning to sell your plan Monthly and Yearly, you can add another price, by clicking on the "+ Add another price" button.
- Save product
After the product has been created in your Stripe dashboard. You should copy the API ID of each product price to your created plans in the Mixpost Dashboard. See the instructions.
Here is how you can get the API ID for each product price:
7. Test the Integration
- Try to register a user and subscribe to a plan.
- Use Stripe's test card numbers to make sure the subscription is done correctly.
8. Go Live
Once you're confident in the integration:
- Switch from using Stripe's test mode to live mode.
- Ensure you've added any necessary pricing plans in both Stripe and your Mixpost Enterprise console.
- Start onboarding users and generating revenue!
Here is how you can switch to Live:
Paddle
Paddle is a popular platform for selling software and other digital goods. Here's a step-by-step guide to help you integrate Paddle with Mixpost Enterprise and get started with processing payments:
1. Sign up for a Paddle Account
- Production: If you haven’t already, visit Paddle's website and sign up for an account.
- Sandbox (only for testing): If you haven’t already, visit Paddle's sandbox website and sign up for an account.
We recommend integrating a Sandbox account first and testing the integration. If everything is fine, you can switch to a production Paddle account.
2. Access the Paddle Dashboard
Once you've registered, log in to your Paddle account and access the Dashboard. This will be your primary interface for managing payments.
3. Get Your API Keys
From the Dashboard:
- Go to the “Developer Tools” section.
- Click on "Authentication".
- You'll see Your Paddle Vendor ID. Copy it.
- Scroll down to the "Generate Auth Code" section and generate one.
- You will see your generated key and the "Reveal Auth Code" button. Click on it and copy the key.
- Go to the “Public Key” page (under the Developer Tools menu) and copy the entire Public Key
Note: Always keep your Secret Key confidential.
4. Integrate API Keys into Mixpost Enterprise
Once you have your API keys:
- Open the Enterprise Console from the user menu.
- Navigate to Settings ->
- Click on Paddle
- Choose "Enabled" radio input
- Input your Vendor ID, Vendor Auth Code, and Public Key.
- Select Sandbox (Yes) If you are in a Sandbox Paddle account.
- Save
5. Set Up Webhooks
Webhooks allow Paddle to communicate with Mixpost Enterprise when certain events happen (e.g., a successful payment, subscription changes, etc.).
- In your Paddle Dashboard, navigate to the "Developers" section.
- Click on "Events".
- Scroll down to the "URLs for receiving webhooks" section.
- Input Endpoint URL "https://your-app-url.com/mixpost/payment-webhook".
- Scroll down to the event's configuration and select Webhook for the following events:
- Subscription Created
- Subscription Updated
- Subscription Cancelled
- Subscription Payment Success
- Subscription Payment Failed
- Save Changes
6. Add pricing plans
We are adding all the necessary pricing plans in both Paddle and Mixpost Enterprise.
- In your Paddle Dashboard, navigate to the "Catalog".
- Click on "Subscription Plans"
- Here, you'll see the “+ New Plan” button. Click on it.
- Give a plan name, for example: "Starter"
- Taxable Category, select "Standard Digital Goods"
- Select "Billing interval". Mixpost only accepts Monthly or Yearly billing periods.
- Scroll down to the "Subscription Plan Pricing" section
- Select the "Standard pricing" model.
- Input the default plan price, for example: "$9.00"
- Save plan
If you want to support Monthly and Yearly billing periods for plans, you should add the same Plan twice, first select "Billing Interval" under "Monthly" and then select "Yearly".
After the plans have been created in your Paddle dashboard. You should copy the Plan ID of each subscription plan to your created plans in the Mixpost Dashboard. See the instructions.
7. Test the Integration
- Try to register a user and subscribe to a plan.
- Use Paddle's test card numbers to make sure the subscription is done correctly.
8. Go Live
If you have integrated with your Paddle's sandbox account, and you're confident in the integration:
- Repeat the integration process for your Production Paddle account.
- Ensure you've added any necessary pricing plans in both Paddle and your Mixpost Enterprise console.
- Start onboarding users and generating revenue!
Paystack
Paystack is a modern payment platform for Africa. Here's a step-by-step guide to help you integrate Paystack with Mixpost Enterprise and get started with processing payments:
1. Sign up for a Paystack Account
If you haven't already, head to Paystack's website and sign up for an account.
2. Access the Paystack Dashboard
Once you've registered, log in to your Paystack account and access the Dashboard. This will be your primary interface for managing payments.
3. Get Your API Keys
From the Dashboard:
- Go to the “Settings” section.
- Click on "API Keys & Webhooks".
- You'll see two keys: a Live Secret Key and a Live Public Key. You'll need both for integration.
- Set your server IP to the whitelist.
- Input Live Webhook URL "https://your-app-url.com/mixpost/payment-webhook".
- Click the "Save changes" button.
Note: Always keep your Secret Key confidential. Make sure your dashboard is in Live mode (top right switch).
4. Integrate API Keys into Mixpost Enterprise
Once you have your API keys:
- Open the Enterprise Console from the user menu.
- Navigate to Settings ->
- Click on Paystack
- Choose "Enabled" radio input
- Input your Live Secret Key to the Secret Key field and Live Public Key to the Public Key field.
- Save
5. Add pricing plans
We are adding all the necessary pricing plans in Paystack and Mixpost Enterprise.
- In your Paystack Dashboard, navigate to the "Plans".
- Here, you'll see the “+ New Plan” button. Click on it.
- Give a plan name, for example: "Starter"
- Input the default plan price, for example: "NGN 200"
- Select "Interval". Mixpost only accepts Monthly or Yearly billing periods.
- Save plan
If you want to support Monthly and Yearly billing periods for plans, you should add the same Plan twice, first select "Interval" under "Monthly" and then select "Annually".
After the plans have been created in your Paystack dashboard, you should copy the Plan Code of each plan to your created plans in the Mixpost Dashboard. See the instructions.
7. Test the Integration (optional)
- Switch to Test mode from your Paystack dashboard.
- Back to step 4 and input your Test Secret Key to the Secret Key field and Test Public Key to the Public Key field.
- Try to register a user and subscribe to a plan.
8. Go Live
If you skipped step 7. Mixpost is ready to receive payments.
If you did not skip step 7 and did tests in the Test mode, back to step 4 and make sure you input your Live Secret Key to the Secret Key field and Live Public Key to the Public Key field.