Enable Interaction with Stripe

Stripe Payment Gateway

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”.

ARMember General Settings ( Payment Gateways )

ARMember General Settings ( Payment Gateways )

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.
  • Stripe SCA Method Payment Gateway
  • Select SCA Complaint (popup) for SCA method

ARMember General Settings ( Payment Gateways )

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

ARMember-Stripe SCA

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.

ARMember Stripe Account Settings ( Payment Gateways )

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.

ARMember Stripe-plan Settings ( Payment Gateways )

Go to your ARMember Configure Plan + Signup Page – and Select “Stripe” Payment Gateway. That’s it.

ARMember stripe-setup Settings ( Payment Gateways )

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)

ARMember stripe-paymemt_history Settings ( Payment Gateways )

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.
  • ARMember General Settings ( Payment Gateways )

  • 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
  • ARMember General Settings ( Payment Gateways )

  • 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.