Stripe

Stripe lets you accept payments directly on your website using a wide range of payment methods allowing for a faster checkout directly on your website.

Enable users to pay using debit or credit cards, Bancontact, Giropay, iDEAL, Sofort, and many more. Accept one-time or recurring payments, offer your users Free Trials for subscriptions, or charge an initial Sign-up fee.

Everything is done in a secure matter, and your website benefits automatically from SAQ A PCI Compliance.

Initial Setup

To start using this gateway, go to Paid Member Subscriptions → Settings →Payments and enable the `Stripe` payment gateway.

After saving the settings, a new button will appear that will let you do the payment gateway setup: Connect with Stripe.

Press the button to start the onboarding process. You will be redirected to the Stripe website in order to complete the initial setup.

After completing the onboarding process, you will be redirected back to your website and, if the connection is successful, you should be able to process payments.

The plugin will tell you the status of the connection:

Webhooks setup

Setting up webhooks is not mandatory in order for payments to work, but for safety, we are recommending you to configure them as well. They also help by automating refund processing between Stripe and your website.

To configure them, press the `Copy` button near the Webhook URL field from settings and then simply click here. This will redirect you to your Stripe Dashboard account → Developers → Workbench → Webhooks page, where you should have the following 6 events already preselected:

• charge.refunded
• payment_intent.payment_failed
• payment_intent.processing
• payment_intent.succeeded
• setup_intent.setup_failed
• setup_intent.succeeded

The page should look like this. After making sure the above events are selected, you can click on “Continue”.

On the next page, you will need to add the Webhook URL that you’ve copied from the plugin settings.

After you click on “Create destination” your webhook URL should be registered:

Webhooks Status

The webhooks status section will change to `Connected` once a webhook from Stripe is received. The plugin will also log and tell you the last date on which a webhook was received from Stripe.

Migration from other Stripe gateways to Stripe Connect

If you are already using one of our other Stripe payment gateways you can migrate to Stripe Connect and benefit from the extra features.

Simply enable the Stripe payment gateway and then start the onboarding process. Once you reach the Stripe website and you are asked to log in, you need to log in and select the same Stripe account that you previously used for this website.

If you link a new account, older subscriptions that are already set up on your website will not work anymore.

Front-end

After you have enabled the gateway and successfully connected your website, when you go to a front-end form, you should see Stripe as an available payment method.

When selecting this method you will be presented with the payment form:

In order to make a payment the user simply has to fill out the form with his payment details and press the register button.

The form is presented as a form to enter credit card details, but through Stripe Connect you are able to accept more than just credit cards. With it, your website can accept payments in more localized payment methods that might be familiar to users in a certain region.

Some examples include Affirm, Bancontact, Giropay, iDEAL, Sofort, and many more. You can checkout this article from Stripe which goes more in-depth about all the available payment methods: https://stripe.com/en-ro/guides/payment-methods-guide

Payment methods are localized, so users from different parts of the world will have different payment methods showing. You can better test how the payment form will look in different countries by going to the Stripe website: https://stripe.com/docs/payments/payment-element

Select which payment methods are available

Additional payment methods need to be enabled from Stripe settings. In order to do this, go to the Stripe Dashboard -> Settings -> Payment Methods page and enable the gateways that you’d like to use.

Make sure you have selected Paid Member Subscriptions in the Configuration Management-> Select a Platform.

Gateways might have additional settings, so for example in order to enable recurring payments for Bancontact or iDeal there is another setting you need to enable.

Apple Pay and Google Pay

You can activate Apple Pay and Google Pay from the Payment Methods page.

After enabling them in your Stripe account, just use a mobile phone to see Apple Pay or Google Pay options on your form.

Update Credit Card Details

Your customers can update the payment details for a recurring subscription at any time using the account page. They can see which credit card they are using for a specific subscription and are able to update it in case it expires or they just want to change it.
When the next recurring payment for the customer is triggered, the new card will automatically be charged.

The credit card update is done very easily by the customer, he is only asked to provide the details for his new card. In case the Invoices or Tax add-ons are active, the customer can also update his existing Billing Details.

How to process a refund

In order to issue a refund on your site, you need to issue the refund from the Stripe website:

• Log in to your Stripe account: https://dashboard.stripe.com
• Go to the payments overview page (https://dashboard.stripe.com/payments) and search for the transaction you need to refund using the Email or the Transaction ID. Click on the payment.

• Click on the Refund button at the top right of the screen. By default, you’ll issue a full refund. For a partial refund, enter a different amount to be refunded. Select a reason for the refund. And click Refund.

Please check the following page for more information regarding Stripe refunds: https://stripe.com/docs/refunds

• A successful “Refunded” message in the Payment logs indicates that the refund was processed with success. The status of the subscription plan in PMS → Members will be Expired.

Test mode

The Stripe Connection you make is tied to the mode the plugin is running in. So if the plugin is set to Test mode, the connection you make will be in Test mode, if the plugin is in Live mode, the connection you make will be with a Live account.

You can connect the same account both in Test and Live mode, but you can also connect different accounts.

If you are connected in Test mode, you can test the integration using test credit cards that Stripe provides:

Number – CVV 111	Brand
4242424242424242 5555555555554444 378282246310005	Visa Mastercard American Express

For the CVV you need to enter any 3 digits and the expiration date needs to be set in the future. You can learn more about doing Test payments with Stripe on their website.