Gateway Settings
Configure payment gateways for your store or network — Stripe, Braintree, QPay, Manual, and Cash on Delivery.
Gateway Settings
Gateways are the payment processors your store uses to accept payments at checkout. Configure gateways in Storefront → Settings → Gateways.
Gateways can be configured at the store level (applies to one store) or the network level (applies to all stores in the network).
Supported Gateway Schemas
The gateway picker offers four types: Stripe, Braintree, QPay, and Manual.
Cash on Delivery is not in the picker — enable it via the Enable cash on delivery toggle in the store/network's general settings (options.cod_enabled).
For full per-gateway configuration tables and the payment flow, see Payment Gateways.
Adding a Gateway
Navigate to Storefront → Settings → Gateways.
Click New Gateway.
Select the gateway type: Stripe, Braintree, QPay, or Manual.
Enter the credentials (the form auto-renders the right fields per schema).
Optionally fill in Callback URL and Return URL as required by the gateway.
Toggle Sandbox on while testing.
Click Save.
Common Fields
Every gateway has these shared fields:
| Field | Description |
|---|---|
| Name | Display label shown to customers |
| Code | Immutable identifier set from the schema |
| Callback URL | URL the gateway calls after payment (you fill this in based on the provider's docs) |
| Return URL | URL the customer is redirected to after payment |
| Sandbox | Toggle test mode |
Removing a Gateway
Open the gateway from the list and click Delete. Existing orders tied to this gateway are unaffected.