Please note that while uninstalling ARMember, if any user has auto recurring subscription then that will be canceled from payment gateways.
To activate stripe gateway, you must require Secret Key & Publishable Key. Your API keys are located in your stripe account settings.
Follow below steps to get API Keys:
- Log in to your Stripe account.
- Go to “Your Account-> Developers”.
- “Developers” will bring up sub menu and select the “API Keys”.
- You will find following two keys from this page: For “Publishable Key” and ”Secret Key”.
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 Disputes.
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 screen-shot.
You must need to set Trial Period duration in DAYS
.
You must need to setup webhooks URL for recurring billing. Please follow below steps to configure webhooks.
- Go to “Your Account-> Developers”.
- “Developers” will bring up sub menu and select the “Webhooks”.
- Click on “+ Add endpoint” button to add webhook URL.
- Now, add
https://yoursite.com/?arm-listener=arm_stripe_api
into URL input. - Select all “Events to send” option.
- Now click on “Add endpoint”. That’s it.
You need to add below given Webhook Events for subscription payment work properly with Stripe Payment Gateway:
invoice.payment_succeeded
customer.subscription.updated
customer.subscription.deleted
invoice.payment_failed
customer.subscription.created
subscription_schedule.canceled
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 below:
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.
Please note that if your plan created in stripe API has different trial period the first priority of trial period will be considered from ARMember plan.
Go to your ARMember Plan Page and create plan accordingly.
Go to your ARMember Configure Plan + Signup Page – and Select “Stripe” Payment Gateway. That’s it.
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)
Update Card
ARMember does provide a facility to update the card for the Stripe Payment Gateway, even if your site is using the Stripe in the “Built-in Form” or with “SCA-Complaint Popup” you can allow a member to update there card details.
You can allow the member to update their card details through the Current Membership shortcode. The ARMember does provide the Current Membership Shortcode and here their is an option to enable the update card button through which they can update the card details. Further, if you want to know more on the Current Membership Shortcode then click here and check the detailed documentation on the same.
Kindly check the update card image for the SCA-Complaint Popup:
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 subscription is initialized but failed due to 3D authentication, Stripe will send an email to your customer to confirm the payment with 3D authencation. Stripe will send the email based on your reminder settings.
Customize the SCA_Complaint Popup
ARMember does provide a facility to customize the popup as per your requirements, you can add the custom css as per your requirements at the ARMember -> General Settings -> Global CSS section, here you can add the CSS to customize the SCA Popup for Stripe Payment Gateway.
Below peovided is the CSS Class Information for the reference:
1. Container class: .arm_stripe_element_wrapper
2. Field Label class: .arm_stripe_field_label
3. Header Container: .arm_stripe_element_wrapper .site_info_row
4. Header Content text: .arm_stripe_element_wrapper .site_title
5. Stripe Input field class: .arm_stripe_field