Skip to content

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

  1. Click on Settings in the sidebar
  2. Select Payment methods from the settings menu
Payment methods list

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:

  1. Click the Add payment method button
  2. Fill in the payment method details
  3. Click Save
Add payment method form

Payment Method Fields

FieldRequiredDescription
ProviderYesThe name shown to customers at checkout (e.g., "Credit Card", "PayPal"). Shopper creates the method's identifier from it
DriverYesThe payment provider that processes this method. Defaults to Manual for offline payments; choose a provider such as Stripe for online processing
Provider Documentation URLNoExternal URL for the payment provider
Additional detailsNoShown to customers when they choose a payment method
Provider instructionsNoShown 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:

DriverHow it worksExample
ManualNo online processing. You handle payment outside of ShopperCash on delivery, bank transfer, check
StripePayments processed via Stripe (requires API keys)Credit cards, Apple Pay, Google Pay
select payment method driver

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:

  1. Go to Settings > Zones
  2. Select the zone and click the pencil icon at the top right of its details
  3. In the Providers section, select the payment method in the Payment Methods field
  4. 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 MethodDriverBest For
Credit CardStripeOnline stores accepting card payments
Cash on DeliveryManualLocal deliveries where customers pay on receipt
Bank TransferManualB2B orders or high-value purchases
Mobile MoneyManualMarkets 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