WordPress MicroPayments (CMMP) - Use Case - How Do People Deposit And Withdraw Money On the MicroPayments Ewallet WordPress Software?
Use Case - How Do People Deposit And Withdraw Money On the MicroPayments Ewallet WordPress Software?
Note: This use case requires this to be installed and activated:
- WordPress MicroPayments - This document uses version 2.3.8.
The plugin also requires installing and activating one of the following payment plugins:
Introduction
WordPress MicroPayments allows you to create digital wallets for your users, reward them with points, and let them pay for them using real money. The users are also able to exchange points to real money.
Use Case Front-End
Form for purchasing points:
Form for withdrawing money to PayPal account:
Form for withdrawing money to Stripe account:
Wallets: What is a Wallet?
The Wallets are the "accounts" to which the points have to be connected to. They work very similar to bank accounts, or real life wallets.
Use Case Assumptions
In this example use case guide, we'll cover how to set up payment methods for depositing and withdrawing money on user wallets.
We consider that you have already bought the plugin, but not installed it.
It follows:
- Installing the plugin
- Quick recap
- Methods to deposit money
- Methods to withdraw money
- Editing or translating front-end labels
- End result
Installing the Plugin
The process is the same for all CM plugins.
- Download the add-on from your customer dashboard.
- Log in to WordPress and navigate to the WordPress Admin → Plugins settings.
- Click on Add New.
- Activate it and add the license.
Learn more: Getting Started - Installation And First Steps
Quick Recap
In this use case guide we will focus only on methods of depositting and withdrawing money on user wallets. If you want to learn more about how to work with the plugin, such as:
- General settings
- Adding and assigning wallets
- Managing wallets
- Grant points for purchase
- Use points for discounts
- Shortcodes
- Reports
- Exporting wallets to CSV
- Adding or subtracting points periodically
Then check this use case guide:
Methods to Deposit Money
To let users purchase points, the WordPress MicroPayments plugin works with one of the payment plugins of your choice: Easy Digital Downloads or WooCommerce. Both are free and provide free and paid add-ons. They also support numerous payment gateways, such as PayPal, Stripe, Skrill, 2Checkout, etc.
We recommend researching about each to find out what's better for your use case. If you already use one of them, it's better to keep using it.
But before configuring the payment plugins, let's start with defining the points values.
Setting Up Points Values
Setting this up is required if you want to enable your users to buy the point packages. To configure it, navigate to Admin Dashboard → CM Micropayment Platform → Settings → Points tab.
Here you can create and manage points values. Click Add New to create new point value:
Here you can define the following:
- Points - Define the amount of points the user will receive after the payment.
- Cost - Define the cost of points value (the cost is set according to the currency you set up in the payment plugin - either EDD or WooCommerce).
- Order - Define the position that the point package will be displayed on the checkout page.
Please note that the points value must be unique - so you always have one standard price for a given amount of points.
Now let's move on setting up a payment plugin.
Setting Up EDD
If you choose to use the EDD integration option, navigate to Admin Dashboard → CM Micropayment Platform → Settings → General tab.
The crucial option you need to enable is:
- Use Easy Digital Downloads for Checkout - All of the Payments will be forwarded to the Easy Digital Downloads checkout page. After saving the changes you’ll be notified about the fact that all MicroPayment Payments Settings have been disabled.
The integration is transparent. You don’t have to manually add the products to the EDD product catalog. It will be done automatically for each entry from the Point Price table. The changes will be replicated as well. The products will have the category assigned so they stand out.
Next, you need to setup the payment gateways in Easy Digital Downloads. Navigate to Admin Dashboard → Downloads → Settings → Payments → General tab.
Here you need to configure the payment gateways - Stripe, PayPal or any other payment gateway which can be added with add-ons. Please refer to official EDD documentation to get help with setting up the gateways.
Setting Up WooCommerce
If you have chosen WooCommerce as a payment plugin an alternative to EDD, navigate to Admin Dashboard → CM Micropayment Platform → Settings → General tab.
The crucial option you need to enable is:
- Use WooCommerce for Checkout - All of the Payments will be forwarded to the WooCommerce checkout page.
One more optional setting you can configure now is:
- Final order status of purchasing micropayment points - When points are bought, the order status will be set to the value of the option. Default is Completed. This option is useful for automating the purchasing process without requiring administrator approval for each points purchase.
Next, you need to setup the payment methods in WooCommerce. Navigate to Admin Dashboard → WooCommerce → Settings → Payments tab.
Here you need to configure the payment methods - Stripe, PayPal or any other payment method which can be added with add-ons. Please refer to official WooCommerce documentation to get help with setting up the payment methods.
Note
For both payment methods, EDD and WooCommerce, it is also required to enable one more option to enable users purchase points. You need to head to the PayPal tab in the MicroPayments settings and enable the option Use the built-in PayPal gateway, then save the changes.
Purchasing Points
The users can purchase points on the Checkout page that contains a form for that. This form can be displayed using a shortcode [cm_micropayment_checkout]
. Once WordPress MicroPayments is installed and activated, a relevant page is created automatically. You can find a link to the Checkout page or redefine it under the same tab General in the plugin settings.
On the Checkout page, the user can purchase points using EDD or WooCommerce, depending on which payment system you have configured to use on your site.
Methods to Withdraw Money
The WordPress MicroPayments plugin allows users to exchange points for real money via PayPal or Stripe. Both methods require additional configuration.
Setting Up PayPal
First of all you need to have an account on PayPal. If you still don't have it, you need to register it.
Next, you need to head to PayPal Developer Dashboard and login.
Once you're logged-in, head to the Apps & Credentials page:
A Default Application is created by default, so you can use it to copy Client ID and Secret - you will need them later in the WordPress MicroPayments plugin. Alternatively, you can create new app by clicking the button Create App.
Note 1
PayPal lets you switch between Sandbox and Live modes. The Sandbox mode is needed for testing purposes, and once your site is ready for real transactions, you need to use the Live mode. When you switch between these 2 modes the Client ID and Secret are different.
Note 2
Click on the app name, scroll down to the Features section and make sure the option Payouts is enabled:
Now you need to go the settings of the WordPress MicroPayments plugin. Navigate to Admin Dashboard → CM Micropayment Platform → Settings → PayPal tab.
The options here are:
- PayPal Payments Gateway
- Test mode - Useful during development stage, it allows you to test your checkout. The PayPal credentials settings should be filled in the fields below.
- PayPal email - Enter here the email of your PayPal account.
- Page Style - Define here the page style. Learn more.
- PayPal Payout
- PayPal Payout - Enabled - Turn on this option to make PayPal payouts.
- Points to Currency ratio - Enter here how many points are worth 1 of the real currency. For example, entering '10' means that the user gets $1 for each 10 points.
- Payment threshold - Optionally, define the minimum balance a user must reach before they can request a withdrawal or process a payment.
- PayPal API - Use Test Mode - Enable or this option if your PayPal account is switched to the Sandbox mode, and disable it if your PayPal account is switched to the Live mode.
- Client ID and Secret - Enter here the credentials of your PayPal account in the Live mode.
- Test Client ID and Test Secret - Enter here the credentials of your PayPal account in the Sandbox mode.
Now you can save the changes.
Withdrawing Money via PayPal
The admin should prepare a page that contains a shortcode [cm_micropayment_points_to_paypal]
. The front-end form has the following settings:
- Wallet ID - The user can set his wallet ID. It's filled automatically by default. In case if the user has multiple wallets, he can change the wallet ID here.
- Points to exchange - The user should set how many points to exchange. The user can also see here his wallet balance.
- PayPal Payout value - It shows the real money equivalent of the set number of points. This value depends on the option Points to Currency ratio defined in the plugin settings for PayPal integration.
- Receiver e-mail - The user should set here the email of his PayPal account.
- Exchange - The user should click this button to confirm the operation.
TIP: Setting Up Notifications
It's possible to notify users about activity with PayPal. Learn more: WordPress MicroPayments (CMMP) - How To - Notify Users About Wallet Activity
Setting Up Stripe
First of all you need to have an account on Stripe. If you still don't have it, you need to register it.
Next, you need to head to Stripe Developer Dashboard, login and complete your business profile:
Next, head to Developers → API keys.
The API keys are created by default, so you can copy Publishable key and Secret key - you will need them later in the WordPress MicroPayments plugin.
Note
Stripe lets you enable or disable the Test mode. When you switch between test and live modes, the Publishable key and Secret key are different.
One more thing you will need for setting up integration is Account ID. You can find it in the profile settings:
At the bottom of the page, you can find and copy the account ID:
Now you need to go the settings of the WordPress MicroPayments plugin. Navigate to Admin Dashboard → CM Micropayment Platform → Settings → Stripe tab.
The options are:
- Test mode - Useful during development stage, it allows you to test your checkout. The Stripe credentials settings should be filled in the fields below.
- Points to Currency ratio - Enter here how many points are worth 1 of the real currency. For example, entering '10' means that the user gets $1 for each 10 points.
- Stripe email - Enter here the email of your Stripe account.
- Publishable key, Secret key and Client ID - Enter here the credentials of your PayPal account in the Live mode.
- Publishable test key, Secret test key and Client test ID - Enter here the credentials of your PayPal account in the Test mode.
Now you can save the changes.
Withdrawing Money via Stripe
The admin should prepare a page that contains a shortcode [cm_micropayment_points_to_stripe]
. The front-end form has the following settings:
- Wallet ID - The user can set his wallet ID. It's filled automatically by default. In case if the user has multiple wallets, he can change the wallet ID here.
- Stripe account ID - The user should set here the ID of his Stripe account.
- Points to exchange - The user should set how many points to exchange. The user can also see here his wallet balance.
- PayPal Payout value - It shows the real money equivalent of the set number of points. This value depends on the option Points to Currency ratio defined in the plugin settings for Stripe integration.
- Submit payment - The user should click this button to confirm the operation.
The shortcode also has 1 parameter:
- connectbutton - If set to '1', it helps users connect with Stripe. It will include a message and the link. Example of usage:
[cm_micropayment_points_to_stripe connectbutton="1"]
Front-end result:
Editing or Translating Front-end Labels
The plugin allows to edit or translate all front-end labels related to the WordPress MicroPayments plugin, including labels related to PayPal and Stripe integrations.. To configure them, navigate to Admin Dashboard → CM Micropayment Platform → Settings → Labels tab.
Examples of labels:
End Result
Following instructions found in the plugin and guides, you should be able to set up payment methods for depositing and withdrawing money on user wallets.
Use Case Front-End
Form for purchasing points:
Form for withdrawing money to PayPal account:
Form for withdrawing money to Stripe account:
More information about the WordPress MicroPayments plugin Other WordPress products can be found at CreativeMinds WordPress Store |
|
Let us know how we can Improve this Product Documentation Page To open a Support Ticket visit our support center |