Skip to main content

​
Overview

Stripe Checkout shows customers a Stripe payment form in a pop-up window inside the Members Portal or app, so they pay without leaving it. It supports recurring billing and is fully SCA compliant. Customers see the payment methods you turn on in your Stripe account, such as cards, Apple Pay, Google Pay, and bank debits like BACS or ACH. Nexudus can’t turn Stripe payment methods on or off for you: manage them in the Stripe Dashboard before you connect.

​
Features

​
Configuration Parameters

To configure Stripe Checkout, go to Settings → Billing and payments → Payments and currency → Payment methods, search for Stripe Checkout and select its tile.

​
Required Settings

​
Optional Settings

​
Setting up Stripe Checkout

  1. Create an account at stripe.com and fully activate it, including your business and bank details.
  2. In the Stripe Dashboard, turn on the payment methods you want to offer.
  3. Go to Developers > API keys and copy your live Publishable key (starts with pk_live_) and Secret key (starts with sk_live_).
  4. In Nexudus, open Stripe Checkout, turn on Enabled and paste your keys into Publishable key (starts with ‘pk_’) and Secret key (starts with ‘sk_’).
  5. Turn on Enable automatic recurrent payments (recommended) if you sell plans or want bank debits.
  6. Select Save changes, then make a test payment.
Use your standard Secret key (starts with sk_), not a restricted key (starts with rk_). Stripe may recommend creating a restricted key for third-party integrations, but Stripe Checkout won’t work in Nexudus with one.
If the Stripe Dashboard shows a Test mode banner, or your keys start with pk_test_ and sk_test_, the account can’t take real payments. Activate the account and use your live keys.
To test Stripe Checkout, the test customer needs an unpaid invoice. See Test a payment method.

​
Test card numbers

In Stripe’s test mode you can use these card numbers:
  • 4242 4242 4242 4242 — Successful payment
  • 4000 0000 0000 9995 — Declined for insufficient funds
  • 4000 0025 0000 3155 — Requires 3D Secure authentication
Test keys only work with Stripe’s test mode. Switch back to your live keys before customers start paying.

​
ACH payments

Stripe Checkout is the way to take US ACH bank debits through Stripe. The separate Stripe ACH gateway is deprecated.
  1. In the Stripe Dashboard, accept Stripe’s ACH terms of service and turn on ACH Direct Debit under your payment methods.
  2. In Nexudus, make sure Stripe Checkout is enabled and Enable automatic recurrent payments (recommended) is turned on. ACH can’t be used without it.
  3. Customers choose ACH in the Stripe payment form and link and verify their bank account. Nexudus then collects their invoices automatically when they fall due.
ACH payments take several working days to settle.

​
Moving from the Stripe ACH gateway

If you still collect payments through the old Stripe ACH gateway, move to Stripe Checkout:
  1. In the Stripe Dashboard, turn on ACH Direct Debit under your payment methods, and turn off any methods you don’t want customers to see.
  2. Enable Stripe Checkout in Nexudus with the same Stripe account, and turn on Enable automatic recurrent payments (recommended).
  3. Export your customer lists from Stripe and from Nexudus, and contact Nexudus support to migrate customers’ ACH mandates to Stripe Checkout.
  4. Remove the old ACH webhook from your Stripe account so payments aren’t reported twice.
  5. Ask customers to update their bank details in the Members Portal. Payments can’t be collected from customers who don’t.

​
Apple Pay

Apple Pay works in the Members Portal and in white-label apps. It isn’t available in the standard Passport by Nexudus app.

​
In the Members Portal

  1. Register an Apple Merchant ID in your Apple Developer account. Apple recommends a reverse-domain identifier, such as merchant.com.yourappname.
  2. Add it to Merchant Identifier (only for ApplePay) in the Stripe Checkout settings.
  3. Paste your Apple Pay domain verification file into Domain verification file contents.
  4. Select Save changes.

​
In your white-label app

  1. Register your Apple Merchant ID and add it to Stripe Checkout, as above.
  2. In the Stripe Dashboard, open the iOS certificate settings for Apple Pay, add a new application and download the Certificate Signing Request (CSR) file.
  3. Contact Nexudus support to request an app update. Include your app’s name, the CSR file and your Apple Merchant ID.
Customers can use Apple Pay in the app once the update is released. If you change your Merchant ID later, you need a new CSR and another app update.

​
Troubleshooting

  • The payment form opens but payments fail — Verify your API keys match (publishable and secret from the same Stripe account)
  • A payment method is missing from the Stripe payment form — Turn it on in your Stripe Dashboard. Bank debits also need Enable automatic recurrent payments (recommended) turned on in Nexudus.
  • Recurring payments not working — Ensure Enable automatic recurrent payments (recommended) is turned on
  • Apple Pay not appearing — Check that the Merchant Identifier is configured and the domain verification file is set up correctly