Payments & Shipping
Payment providers
CarphaCom ships with two providers out of the box:
- Manual — for cash-on-delivery, bank transfer, or wholesale.
- System Default — a test provider for sandbox checkouts.
To accept real card payments, install @carphacom/stripe-payment from the marketplace.
Connect Stripe
- Go to Marketplace → Browse, find Stripe Payment, click Install.
- After install, click Configure.
- Paste your Stripe publishable key (starts with
pk_live_) and secret key (sk_live_). - Paste the webhook signing secret from your Stripe dashboard → Webhooks.
- Toggle the methods you want enabled (cards, SEPA, iDEAL, Klarna).
- Click Save. The backend reloads and Stripe is now active for all regions.
Test mode vs live mode
Use Stripe test keys while you set up. Process a test order with card 4242 4242 4242 4242
and any future date. When ready to go live, swap to live keys and remove the Manual provider
if you don't want it visible to real customers.
Shipping providers
Three patterns are common:
- Flat rate per region — Configure under Settings → Shipping options. Set a fixed price per region.
- Free shipping over X — Add a shipping option with a price rule "free if cart total greater than 150".
- Carrier API integration — Install a fulfillment plugin like Fan Courier (Romania) or DPD. The carrier returns live rates per package weight.
Add a shipping option
- Go to Settings → Regions → [region] → Shipping options.
- Click Add option.
- Name it (Standard, Express).
- Set the fulfillment provider (manual or carrier-plugin).
- Set rate (flat) or calculated (carrier-driven).
- Optionally restrict to certain product types.
Tax
Each region can have multiple tax rates. By default, prices include tax. You can:
- Toggle "show tax-included prices" in storefront.
- Apply per-product tax overrides for reduced-rate goods.
- Apply per-customer tax exemptions (B2B).