Payment Methods
Configure how customers can pay for their orders.
Payment methods define how customers can pay at checkout. You can offer credit card payments via Stripe, cash on delivery, bank transfers, or mobile money, and restrict each method to specific zones.
Accessing Payment Methods
- Click on Settings in the sidebar
- Select Payment methods from the settings menu

The payment methods list shows all configured methods with their driver, status, and last update date.
Adding a Payment Method
To add a new payment method:
- Click the Add payment method button
- Fill in the payment method details
- Click Save

Payment Method Fields
| Field | Required | Description |
|---|---|---|
| Provider | Yes | The name shown to customers at checkout (e.g., "Credit Card", "PayPal"). Shopper creates the method's identifier from it |
| Driver | Yes | The payment provider that processes this method. Defaults to Manual for offline payments; choose a provider such as Stripe for online processing |
| Provider Documentation URL | No | External URL for the payment provider |
| Additional details | No | Shown to customers when they choose a payment method |
| Provider instructions | No | Shown to customers after they place an order with this method (e.g., bank transfer details) |
Understanding Drivers
The driver connects a payment method to a payment provider:
| Driver | How it works | Example |
|---|---|---|
| Manual | No online processing. You handle payment outside of Shopper | Cash on delivery, bank transfer, check |
| Stripe | Payments processed via Stripe (requires API keys) | Credit cards, Apple Pay, Google Pay |

Only Manual is built in. Stripe appears in the Driver list once your developer has installed the Stripe package, and it requires API credentials configured by your developer. If a driver shows "Not configured" in the dropdown, the API keys have not been set up yet. See the Payments developer documentation for setup instructions.
Assigning to Zones
Payment methods are assigned to zones when creating or editing a zone. A payment method only appears at checkout if it belongs to the customer's zone.
To make a payment method available in a zone:
- Go to Settings > Zones
- Select the zone and click the pencil icon at the top right of its details
- In the Providers section, select the payment method in the Payment Methods field
- Click Save
Managing Payment Methods
Editing a Payment Method
Click the pencil icon next to a method, update the fields, and click Save changes.
Enabling or Disabling
Toggle the Status switch in the list to quickly enable or disable a payment method. Disabled methods are not shown at checkout.
Deleting a Payment Method
Click the trash icon and confirm. Orders that used this method are kept, but they no longer show a payment method.
Common Setups
| Payment Method | Driver | Best For |
|---|---|---|
| Credit Card | Stripe | Online stores accepting card payments |
| Cash on Delivery | Manual | Local deliveries where customers pay on receipt |
| Bank Transfer | Manual | B2B orders or high-value purchases |
| Mobile Money | Manual | Markets where mobile payments are common (Africa, Asia) |
Best Practices
Offer Multiple Options
Customers are more likely to complete checkout when they see a payment method they trust.
Zone-Specific Methods
Some methods work only in certain regions. Assign them to the right zones.
Clear Instructions
For manual methods like bank transfers, provide clear payment instructions so customers know what to do after ordering.
Test Payments
Use your payment provider's test/sandbox mode to verify the checkout flow before going live.
For developer details on payment drivers, custom providers, and transaction management, see the Payments documentation.
Last updated on
Edit on GitHub

