Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.cartble.com/llms.txt

Use this file to discover all available pages before exploring further.

Cartble supports two payment methods out of the box: Stripe for online card payments (credit cards, debit cards, Apple Pay, and Google Pay), and Manual for offline scenarios like bank transfer or cash on delivery. You can enable both simultaneously and let the customer choose at checkout. Cartble never adds its own transaction fees on top of your payment provider’s standard rates.

​
Payment methods at a glance

Stripe

Accept online payments worldwide. Customers pay with credit or debit cards, Apple Pay, or Google Pay directly on your checkout page. Funds settle into your Stripe account on your normal payout schedule.

Manual Payment

Display custom payment instructions to customers at checkout (e.g., bank account details or cash-on-delivery instructions). You confirm the payment manually once funds are received.

​
Connecting Stripe

1

Open Payment Settings

In your admin dashboard, go to Settings → Payments (or navigate to Plugins → Stripe Payments). You’ll see the Stripe Payments configuration panel.
2

Enable the Stripe plugin

Toggle Stripe Payments to the enabled position at the top of the panel.
3

Enter your API keys

Paste your Publishable Key (starts with pk_live_ or pk_test_) and your Secret Key (starts with sk_live_ or sk_test_) from your Stripe Dashboard → Developers → API keys.
4

Create a webhook endpoint in Stripe

In your Stripe Dashboard, go to Developers → Webhooks → Add endpoint. Set the endpoint URL to your Cartble webhook URL (shown in the Stripe settings panel). Select the events listed in the Webhook events section below, then save the endpoint. Stripe will display a Signing Secret (starts with whsec_) — keep this available for your server-side configuration, as it allows Cartble to verify that incoming webhook calls genuinely originate from Stripe.
5

Test with a Stripe test card

Keep Test Mode toggled on and use a Stripe test card (e.g., 4242 4242 4242 4242) to place a test order. Verify the order appears in your dashboard with a paid financial status before switching to live mode.
Never share or expose your Stripe Secret Key publicly — not in client-side code, public repositories, or support tickets. The secret key grants full access to your Stripe account. If you suspect it has been compromised, roll it immediately from your Stripe Dashboard.

​
Test mode

The Stripe settings panel includes a Test Mode toggle. While test mode is active, transactions are processed against Stripe’s test environment and no real money moves. Disable test mode only after you have verified your integration end-to-end with a test card.

​
Webhook events

Cartble listens for the following Stripe webhook events to keep your orders and subscriptions in sync:
Stripe eventWhat Cartble does
checkout.session.completedRegisters a completed checkout session and creates the associated subscription record in Cartble.
invoice.paidRecords a successful subscription or invoice payment against the customer’s account.
invoice.payment_failedMarks the related subscription payment as failed so you can follow up with the customer.
customer.subscription.createdCreates a new active subscription record in Cartble.
customer.subscription.updatedSyncs subscription status, current period end, and plan changes.
customer.subscription.deletedMarks the subscription as cancelled in Cartble.
Make sure all six event types above are selected when you configure your Stripe webhook endpoint. Missing events can cause payment records or subscriptions to fall out of sync with your Cartble dashboard.

​
Manual payments

Manual payments are ideal when customers pay offline — for example, by direct bank transfer, cash on delivery, or in-person at pickup.
1

Enable manual payments

Go to Settings → Payments and enable the Manual Payment option.
2

Add your payment instructions

Enter the instructions customers will see at checkout — for example, your bank name, account number, and reference format. Be specific so customers know exactly how to complete the transfer.
3

Confirm payments manually

When a customer chooses manual payment and places an order, the order is created with a pending financial status. Once you confirm receipt of funds, open the order in your dashboard and update the financial status to paid.

​
Viewing payment records

Navigate to Admin → Payments to see a full transaction history across all payment methods. Each record shows:
  • Transaction number — matches the order number for easy cross-referencing.
  • Amount — total charged including tax and shipping.
  • Financial status — paid, pending, refunded, partially_paid, or voided.
  • Date — timestamp of the transaction.
  • Payment method — Stripe or Manual.
Use the status filter at the top of the Payments view to surface all pending manual payment orders at once, making it easy to reconcile your bank statement against outstanding orders each day.

​
Currencies

Your store’s currency is set in Settings → Regional. All prices, discounts, and transaction records are stored and displayed in the currency you configure there. Stripe supports multi-currency payouts — ensure your Stripe account is enabled for any currencies you plan to accept.