> ## Documentation Index
> Fetch the complete documentation index at: https://help.eaglecart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Stripe Card Payments to Eaglecart

> Connect your own Stripe account to Eaglecart to accept cards and wallets through Stripe's hosted checkout. Set the checkout name, manage Stripe and match payments.

[Help Center](https://help.eaglecart.com/introduction.md)

[Payments](https://help.eaglecart.com/payments.md)

Connect Stripe card payments

# Connect Stripe card payments

Stripe is Eaglecart's card payment provider. You connect your own Stripe account, and customers who choose card payments pay on Stripe's secure hosted page. Money goes to your Stripe account, not to Eaglecart.

Eaglecart uses Stripe Connect. You don't copy or paste any Stripe API keys into Eaglecart; you connect your Stripe account and Eaglecart handles the rest.

## 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](https://help.eaglecart.com/payments/transaction-fees.md) and [Payment processing, settlement and payouts](https://help.eaglecart.com/payments/settlement-and-payouts.md).

## Connect Stripe

1. Go to **Settings → Payments**.
2. In **Regions**, select the region you want to accept cards in.
3. Under **Payment providers**, click **Stripe Card Payments**.
4. 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.
5. Follow Stripe's steps to finish connecting.
6. Back in Eaglecart, the Stripe page shows the green banner "Stripe is active and ready to accept payments in this region."

On the **Settings → Payments** page, **Stripe Card Payments** now shows **Active**.

## Settings on the Stripe page

| Item | What it does |
| - | - |
| Breadcrumb (for example **AE**) | Shows which region you're editing. |
| **Manage in Stripe** | Opens your Stripe dashboard, where you manage payouts, disputes, wallet settings and the rest of your Stripe account. |
| Green banner | Confirms Stripe is active and can accept payments in this region. |
| **Name** | "Custom name for this payment method. Customer will see this name when selecting a payment method at checkout." It doesn't have to mention Stripe, for example **Card Payments** or **Credit and Debit Card**. |
| **Action** | A menu with **Localize**, **Deactivate** and **Delete**. See [Manage and deactivate payment methods](https://help.eaglecart.com/payments/manage-payment-methods.md). |
| **Save** | Saves the name. |

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.

> [!TIP]
>
> Choose a name customers recognise, such as **Credit and Debit Card**. The name is what they see at checkout, and the card brand marks appear next to it.

## What customers see

1. At checkout, the card method shows its name with up to three card brand marks, for example Visa and Mastercard.
2. When selected, a short line explains that they'll be taken to pay.
3. The button reads **Pay now**.
4. The customer is sent to Stripe's hosted checkout page and pays there.
5. When they come back, Eaglecart checks with Stripe that the payment was actually completed before creating the order. The redirect alone is never trusted.

If the customer cancels on Stripe's page, they return to checkout with "You aborted the payment. Please retry or choose another payment method." and can try again or choose another method.

For Apple Pay and Google Pay, see [Apple Pay and Google Pay](https://help.eaglecart.com/payments/apple-pay-and-google-pay.md).

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

To check a payment, copy the Payment ID from the order in Eaglecart, click **Manage in Stripe** and look for that description in your Stripe payments. See [Find a payment using its Payment ID](https://help.eaglecart.com/payments/payment-id.md).

> [!NOTE]
>
> **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](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts).

## 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](https://help.eaglecart.com/payments/payment-id.md).

**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](https://help.eaglecart.com/payments/apple-pay-and-google-pay.md): how wallets work through Stripe.
* [Payment methods at checkout](https://help.eaglecart.com/payments/checkout-payment-methods.md): the full checkout behavior.
* [Manage and deactivate payment methods](https://help.eaglecart.com/payments/manage-payment-methods.md): Localize, Deactivate, Delete and Change sequence.
* [Use multiple payment methods](https://help.eaglecart.com/payments/multiple-payment-methods.md): offer Stripe alongside Tabby, Tamara and manual methods.
* [Find a payment using its Payment ID](https://help.eaglecart.com/payments/payment-id.md): match Eaglecart and Stripe records.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.