Go to the Payment Gateways Tab at General Settings to activate and configure payment gateways.
All payments done by below payment gateways will be in selected default currency. ARMember supports 25 default currencies. You can change default currency at general options.
You need to configure Payment Gateway setting to accept payments. ARMember supports most popular payment gateways like Paypal
, Stripe
, Authorize.Net
, 2Checkout
and Bank Transfer
payment method.
ARMember integrates PCI compliant billing vendors to make sure your customer data is always safe and secure.
You need to activate one of the payment gateway in order to accept payments for paid membership plans.
Important Note: If in any case Payment Amount is zero (Ex: 100% Coupon Discount, Free Trail case etc..) then user will not be redirected to related payment gateway sites and directly get added as member to site as soon as signup process get completed. (It will not work in case of Automatic Subscription)
Please note that while uninstalling ARMember, if any user has auto recurring subscription then that will be canceled from payment gateways.
Paypal
To activate paypal gateway, It requires your Merchant Email & PayPal API information.
Follow below steps to get API Keys:
- Log in to your PayPal Premier or Business account.
- Click the Profile sub-tab located in the top navigation area.
- Click the My selling preferences sub option in left sidebar.
- Click the API Access link under the Account Information header.
- Click the Get Started link under the Request API Credentials heading.
- Click the Update option for API access item
- Complete the API Credential Request form by clicking the agreement checkbox and clicking Submit.
- You will now get the API username, password and signature.
You can find more details about how to get API information from following links: Sandbox API Detail & Live API Detail.
Paypal supports maximum 90 days of trial duration for Auto Debit Subscription method.
Stripe
To activate stripe gateway, you must require Secret Key & Publishable Key. Your API keys are located in your stripe account dashboard.
Follow below steps to get API Keys:
- Log in to your Stripe account.
- Go to Developers->API Keys.
- You will find your API Keys in Test Mode or Live Mode.
Here, you can select Non-SCA and SCA method to accept the payment through Stripe.
- Select
Built-in Form Fields
for Non-SCA method, which will display the credit card fields in the setup form.
- Select
SCA Complaint (popup)
for SCA method
For Built-in Form Fields, you can change the label of credit card fields, which will be displayed in the form while submitting the form
For SCA Complaint (popup) Method, you can change the title, pay now button label and also can upload a logo to display in the Stripe Popup.
You can use {arm_selected_plan_title}
shortcode in the Popup Title to display Selected Plan Name instead of any Static Title
Logo should have 70px height and 70px width. Logo with other size will not be uploaded
In SCA Complaint Method, credit card details will be collected by Stripe
In SCA Complaint Method, all the transactions are 3D secure and if the card requires any further authentication, it'll display a popup box to confirm the payment and reduce the Payment Fraud Desputes.
In case of any error at setup form you may display actual error returned from Stripe payment gateway by enabling Display actual error returned from payment gateway
switch as you can see in screenshot.
For 'Auto Debit Payment' of subscription type of Membership, You must create Stripe Product
and add Pricing Plan(s)
for product in your stripe account and set pricing plan ID in ARMember setup.
Follow the steps given below to create pricing plan in stripe:
- Login to your Stripe account and go to Billing->Products
- Click on "+ New" button from top right corner to add new product. If you have already created product then edit your product, you will find your product details, pricing plans, logs, events etc.
- At Pricing Plans section you will find your created plans. Please click on + Add pricing plan button if you have not created yet.
- At your pricing plan detail page you will find your Plan ID which you need to set in ARMember configuration page as you can see in below picture.
You must need to setup webhooks URL for recurring billing. Please follow below steps to configure webhooks.
- Login to your Stripe account and go to Developers->Webhooks.
- Click on "+ Add endpoint" button to add webhook URL.
- You will get a popup where you need to add
http://yoursite.com/?arm-listener=arm_stripe_api
into "URL to be called" input.
- Select Webhook version and select Send all event types Filter event.
- Now click on "Add endpoint". That's it.
You must need to set Trial Period duration in DAYS
.
IMPORTANT NOTE: Paid Trial
is not
supported with recurring plan in stripe. But you can manage such cases in ARMember by following the steps given bellow:
For ex. If you want to add $5 for trial period of 7 Day in a recurring plan for which billing amount is $20 every month. So, you have to create a subscription plan with 7 Day trial period from your Stripe account.
When someone buys this plan, he/she will be charged $5 as one time charge and also $20 as a subscription charge for the first time only.
After that he will be charged $20 only every month.
Check below images:
Go to your stripe account and create product and add pricing plan for product.
Go to your ARMember Plan Page and create plan accordingly.
Go to your ARMember Configure Plan + Signup Page - and set value for strip ID.
And after successful payment with stripe, you will find 2 payment transactions : 1. Trial Amount 2. Subscription Amount. (This process is automatically managed by ARMember)
Subscription Retries for Failed 3D Secure Authorizations
As per new SCA regulatory, If a subscription payment fails due to authentication issues when using 3D Secure, the payment would not automatically retry based on your retry settings. Unauthorized payments are still considered active, as they are waiting to be authenticated and have not technically failed as payments.
You will need to enable the Send a Stripe Email to Authenticate toggle in your settings and configure the retry settings.
To enable the settings for authenticate email, follow below steps
- Log into your stripe account at https://dashboard.stripe.com/
- Click on the settings
- Click on Subscriptions and email from Billing section. which you can find under the Stripe apps settings.

- Now enable switches for customer emails under Manage payments that require 3D Secure

- You can set up to 3 reminders for your customer to complete the payment after payment has been initialized but did not complete 3D authentication. Set as per your requirement
- Save settings
- Now if any customer subscription is initialized and failed due to 3D authentication, Stripe will send him an email regarding confirm the payment. Stripe will send that email based on your reminder settings.
- After that, your customer has to complete the payment from the email that has been sent by Stripe
Authorize.Net
To activate Authorize.Net gateway, you must requires API Login ID and Transaction Key.
Follow below steps to get API Login ID and Transaction Key:
- Log into your Merchant Interface at https://account.authorize.net.
- Click Account from the main toolbar.
- Click Settings in the main left side menu.
- Click API Login ID and Transaction Key in the Security Settings section.
- Under Create New Transaction Key, enter your Secret Answer.
- Note: When obtaining a new Transaction Key, you may choose to disable the old Transaction Key by clicking the box titled, Disable Old Transaction Key(s). You may want to do this if you suspect your previous Transaction Key is being used fraudulently.
- Click Submit.
For more detail about API Login ID and Transaction Key, please click here.
You must need to setup Silent Post URL URL for recurring billing. Please follow below steps to configure Silent Post URL.
- Click Account from the main toolbar.
- Click Settings in the main left side menu.
- Click Silent Post URL in the Transaction Format Settings section.
- You will find option to set URL. Please add
http://yoursite.com/?arm-listener=arm_authorizenet_api
into URL input.
- Click Submit.
In case of auto debit payment, first payment will be taken as one time payment irrespective of the plan whether it includes trial period or not. Date of second recurrence will be set as subscription start date in authorize.net website for respected plan.
Trial Period + Authorize.NET
In Authorize.NET, you must keep same unit for trial period and billing cycle. (For example if your billing cycle is for 1 month, then you are allowed to set trial period in months only.)
But with ARMember plugin, you can override this limitation. You are allowed to keep Trial Period in Days and Billing Cycle in months in ARMember. (In short, there is no more requirement to set same unit for trial period as billing cycle while using this plugin. )
Authorize.net does not support billing cycle less than 7 Days.
In case of any error at setup form you may display actual error returned from Authorize.Net payment gateway by enabling Display actual error returned from payment gateway
switch as you can see in screenshot.
2Checkout
To activate 2Checkout gateway, you must requires API Username, API Password, Seller Id, Private Key, Publishable Key and Secret Word.
-
API Username and API Password
Follow below steps to create username:
- Log in to your 2Checkout account.
- Click the Account tab.
- Click the User Management sub-tab.
- Click +Create Username
- Enter the required details for: email, username, and password. You should enter an un-monitored or "no-reply" email if you do not wish to receive additional email from 2Checkout regarding sales and other actions.
- Click the API Access radio button.
- Check the API Updating box if this username must have "write" access to your account. If you are unsure of whether or not you need this permission, refer to your cart's support documentation, or discuss this further with your software development team.
- Click Create Username
- After clicking Create Username you will be sent to another form where you can enter additional details for the username - you may skip over this step entirely as your username is already created.
- Now store your API Username & Password.
For more detail about API username & password, please click here.
-
Seller Id (account number)
Your 2Checkout account number (also known as: Seller Id (SID), vendor ID, merchant ID, account ID) can be found within your vendor area, and is located in the upper-right corner of the screen.
-
Publishable and Private keys
Follow below steps to get Publishable and Private keys:
- Log in to your 2Checkout account.
- Click the API tab.
- Here You will find your Publishable and Private keys.
- Note: If you do not see your Publishable and Private keys under the API tab, this indicates your account is not approved to use the Payment API.
For more detail about publishable and private keys, please click here.
-
Secret Word
To set up the Secret Word, follow the steps below:
- Log in to your 2Checkout account.
- Click the Account tab.
- Click the SITE MANAGEMENT sub-tab.
- Scroll down to find the Secret Word field
- You will be able to enter the Secret Word in the field that is under Direct Return and above the Approved URL field.
- Click the Save Changes button at the bottom of the page.
For more detail about Secret Word, please click here.
In order to set callback URL for payment process, Go to 2CheckOut control panel:
- Navigate to Account tab > Site Management
- Under the Direct Return heading, you will find following options:
- Given links back to my website (Select This Option)
- Direct Return (Our URL)
- Header Redirect (Your URL)
- In the Approved URL field set the URL where you want your customer to be sent after successful Payment.
2Checkout does not support "Day" in billing cycle and free trial.
2Checkout supports only first occurrence of billing cycle as trial duration. So if you want to give trial,then set same parameters in "Billing cycle" and "Trial Period Duration", otherwise plan expiration will not work properly with 2checkout.
In Case of Automatic subscription, If total payable amount will be 0 (Zero), then 2checkout gateway will not work.
You must need to enable Instant Notification Service (INS) URL url for recurring billing.
To set up your notification URL(s) click on the Webhooks tab in your account to be directed to the Settings page. On the Settings page you may then enter a Global URL to have all notifications sent to the same URL, or you may provide a specific URL for each notification type.
Below are instructions for setting the notification URL(s) for your account.
- Enter
http://yoursite.com/?arm-listener=arm_2checkout_api
URL in the Global URL field.
- Click the orange Apply button to the right of the Global URL field.
- To receive all notification types to that URL click the green Enable All Notifications link located above the Global URL field.
- Click the black Save Settings link located above the Global URL field or at the bottom of the page. NOTE: After clicking Save Changes the URL will no longer be visible in the Global URL field, but will be listed in the URL field for each notification type.
Bank Transfer
By enabling Bank Transfer Gateway, You will find an option in Configure Plan & Signup Page.
Here you can set fields to display on checkout page like Transaction ID
, Bank Name
, Account Holder Name
& Additional Info/Note
. Whichever field you select from here will be required in front end.
If there is zero(0) amount transaction with Bank Transfer and New user approval is auto then that transaction will approved automatically.
When someone signup for paid plan with bank transfer, transaction with pending status will be added in payment history and after that admin will have to Approve/Reject that transaction in order to activate member's plan.
If Admin Approves transaction, then member's plan will be activated. If Admin Rejects, member's transaction will be rejected & plan will be reset.
For Recurring billing plan if you pay with bank transfer, then its payment mode will be considered as "Semi Automatic Subscription".
Transaction ID Label
Add label for "Transaction ID" option
Bank Name Label
Add label for "Bank Name" option
Account Holder Name Label
Add label for "Account Holder Name" option
Additional Info/Note Label
Add label for "Additional Info/Note" option
Please note that while uninstalling ARMember, if any user has auto recurring subscription then that will be canceled from payment gateways.
Do not allow user to submit transaction data more than on time
WHen this feature is Enabled then Members will not be able to purchase membership plan which is already purchased using
Bank Transfer Payment Gateway and their payment transaction status for that particular plan status is "Pending".
Social Connect / Login
Social Connect / Login section will only available if you activate Social Connect / Login from Add-ons.
Go to the Social Connect / Login tab at General Settings page. Where you can configure social networks.
Social Login Shortcode
Here Shortcode is provided. That can be used to display all active social network login icons at front-end.
Social Login Shortcode:
Social Signup Configuration
Enable One Click Sign Up?
If this setting is enabled, then guest user can be registered in system with just one click on social connect button. After login user will be redirected to a page/URL which is set in Social Connect Redirection setting under
General Settings
->Redirection Rules
tab.Opt-ins
This option will come only if one click sign up is enabled. This option will list all configured opt-ins in
General Settings
->Opt-Ins Configuration
tab. After selecting opt-in, List selection box will be displayed. You can select list and opt-in in which you want to add user who will register in the system using one click sign up.Assign Default Plan
This option will come only if one click sign up is enabled. This option will list only free membership plans. You can select any of free plans which you want to assign to users who will register in the system using one click sign up.
Registration Form Page
This option will come only if one click sign up is disabled. This option will list all pages, Select registration page where you have placed shortcode of your registration form. So when user will click on social connect button, he will be asked for social account credentials. After login to social account all basic user information like email, birth date etc. will be fetched from his social account and if email is already registered in your website, then he will be logged in directly, other wise he will be redirected to page selected in this option. Registration form on this page will be auto filled with all details fetched from social account. In this way social sign up works.
Get Social Avatar while authenticate with social connect buttons
If this option is enabled then social profile image will be set as user's Avatar.
Make sure that
allow_url_fopen
setting is ON in your server configuration.Social Networks
ARMember supports following social networks.
You have to fill required information related to particular social network. For example if you wish to active Facebook then App ID and App Secret are required.
Facebook
In order to get keys needed for Facebook API integration follow bellow instructions.
Create Facebook App
Following steps will help you to get your Facebook Application Id and App Secret.
App ID
Your Application ID is unique id available at your App's Dashboard.
App Secret
Facebook will auto-generate an App Secret for your application. Your App Secret will be treated as password therefore you have to click on Show button to make your App Secret visible.
Get your unique
App ID
andApp Secret
and use them for ARMember plugin where needed.Also you need to set your website URL in "App Domains" of created App. Do not forget to set this,otherwise social connect will not work with ARMember.
Twitter
In order to get keys needed for Twitter API follow certain instructions given below.
Create Twitter Application
Following steps will help you to get Consumer key & Consumer secret for Twitter.
ARMember
->General Settings
->Social Connect
->Twitter
.Request Twitter To Elevated Permissions
You must need to get permissions from twitter otherwise One Click Sign Up with twitter not working proper.
Consumer Key ( API key ) and Consumer Secret ( API Secret )
To get these keys click OAuth Tool tab in your Twitter Application where you are able to have your consumer key and consumer secret.
Copy these keys from here and use them in our ARMember plugin where needed.
LinkedIn
In order to get Client ID and Client Secret for Linked IN, you have to follow steps given below.
Create an application
ARMember
->General Settings
->Social Connect
page at LinkedIn Configuration section.Client ID and Client Secret
Now you can get Client ID and Client Secret from next page after creating new application.
Copy that keys and use them in our ARMember plugin where needed.
VKontakte
In order to get API ID for VKontakte, you have to follow steps given below.
APPLICATION ID
andSECURE KEY
as described below..Application Id and Secure Key
Go to the Settings page.
On setting page set Authorized redirect URI field. That is display in ARMember General Setting in Social Connect tab to VK section.
Now you can get Application Id and Secure Key.
Copy these keys and use them in our ARMember plugin where needed.
Instagram
In order to get keys required for Instagram API integration please go through following instructions.
Create Instagram Client
Following steps will help you to get your Instagram Application Client ID and Client Secret.
Client ID
andClient Secret
click on Manage link.Client ID
Your Client ID is unique id available at your Manage Client page.
Client Secret
Instagram will auto-generate an Client Secret for your client. To get Client Secrent you have to click on Manage button then after Client Secret will be visible.
Get your unique
Client ID
andClient Secret
and use them for ARMember plugin where needed.Social Connect Icons and formatting
ARMember provides formatting options of a social icon in login form with its preview. You can set it from
Manage Forms > Other Forms (set of forms)
You will find settings, shown in below screenshotARMember provides 7 different icons option for each social network as well as you can upload custom icon. Also you can set order of social icons for selected networks. For these settings check settings of "Button Skin" in social connect options.
Social Login Shortcode in any post/page
You can add Shortcode of any social login network, through the "Membership Shortcode" option by editing page/post.