Before you start
- You need a Stripe account, or you can create one while connecting.
- Stripe is set up per region. Repeat the steps for each region where you want to accept cards.
- Stripe sets its own account requirements, fees and payout schedule. See Eaglecart transaction fees and Payment processing, settlement and payouts.
Connect Stripe
- Go to Settings → Payments.
- In Regions, select the region you want to accept cards in.
- Under Payment providers, click Stripe Card Payments.
- If Stripe isn’t connected yet, you’re taken to connect a Stripe account. Sign in to your existing Stripe account, or create a new one, for example with your email and password, Google, a passkey or SSO.
- Follow Stripe’s steps to finish connecting.
- Back in Eaglecart, the Stripe page shows the green banner “Stripe is active and ready to accept payments in this region.”
Settings on the Stripe page
Below the form, the page shows card and wallet brand marks such as Visa, Mastercard, American Express, Discover, JCB, UnionPay, Apple Pay, Google Pay, Samsung Pay, Amazon Pay, Alipay, Cartes Bancaires, Diners Club and WeChat Pay. These are payment options Stripe can support. Which ones a customer actually sees depends on your Stripe settings, the customer’s country and device, and Stripe’s own rules.
What customers see
- At checkout, the card method shows its name with up to three card brand marks, for example Visa and Mastercard.
- When selected, a short line explains that they’ll be taken to pay.
- The button reads Pay now.
- The customer is sent to Stripe’s hosted checkout page and pays there.
- When they come back, Eaglecart checks with Stripe that the payment was actually completed before creating the order. The redirect alone is never trusted.
Match a payment in Stripe
Every payment attempt in Eaglecart has a Payment ID. Eaglecart sends it to Stripe so you can match the two records:- In Stripe, the payment’s description reads like “Payment Id 248”, using your payment’s ID.
- The same ID is attached as the payment’s reference and metadata.
Technical note: Eaglecart creates a Stripe Checkout Session on your connected account with a single line item for the order’s grand total (not itemised), the customer’s email where available, and the Payment ID as the session’s client reference and as PaymentIntent metadata. The description is set on the PaymentIntent because Stripe’s payments list is built from PaymentIntents.
Very small payments
Stripe has a minimum amount it will charge, and it differs by currency. If a cart is below Stripe’s minimum, Eaglecart reports that the amount is too low rather than a technical error. Check Stripe’s current minimums in Stripe’s documentation.Fees
Eaglecart doesn’t add a transaction fee. Stripe charges its own processing fees under your Stripe agreement, and they can vary by country, card type and payment method. See them in your Stripe dashboard.Troubleshooting
Stripe is active in one region but not another. Stripe is set up per region. Select the other region in Settings → Payments and open Stripe Card Payments there. Card payments don’t appear at checkout. Check that Stripe Card Payments shows Active for the customer’s region. If you used Deactivate, the method stays set up but isn’t offered. A customer says they paid but there’s no order. Eaglecart only creates the order once Stripe confirms the payment. Find the payment in Stripe using the Payment ID and compare the amount and status. See Find a payment using its Payment ID. The payment failed with “amount too low”. The cart was below Stripe’s minimum for that currency. Where do I manage my Stripe account? Click Manage in Stripe on the Stripe page.Related guides
- Apple Pay and Google Pay: how wallets work through Stripe.
- Payment methods at checkout: the full checkout behavior.
- Manage and deactivate payment methods: Localize, Deactivate, Delete and Change sequence.
- Use multiple payment methods: offer Stripe alongside Tabby, Tamara and manual methods.
- Find a payment using its Payment ID: match Eaglecart and Stripe records.
