> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laravelshopper.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/v2/user-guide/store-setup/zones).

## Accessing Payment Methods

1. Click on **Settings** in the sidebar
2. Select **Payment Methods** from the settings menu

<Frame>
  <img src="https://mintcdn.com/shopperlabs-ee054f5e/RoQo55-CU3i212Mj/images/v2/payment-methods-list.png?fit=max&auto=format&n=RoQo55-CU3i212Mj&q=85&s=b3e80ac1ef23197848979ab0e14d09a0" alt="Payment methods list" width="3448" height="1976" data-path="images/v2/payment-methods-list.png" />
</Frame>

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 **Create** button
2. Fill in the payment method details
3. Click **Save**

<Frame>
  <img src="https://mintcdn.com/shopperlabs-ee054f5e/RoQo55-CU3i212Mj/images/v2/payment-methods-create.png?fit=max&auto=format&n=RoQo55-CU3i212Mj&q=85&s=5b6ff60ebffa529e8454bbcc8f58117f" alt="Add payment method form" width="1856" height="1746" data-path="images/v2/payment-methods-create.png" />
</Frame>

### Payment Method Fields

| Field            | Required | Description                                                                                                             |
| ---------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Title**        | Yes      | The name shown to customers at checkout (e.g., "Credit Card", "PayPal")                                                 |
| **Slug**         | Yes      | Auto-generated from the title                                                                                           |
| **Driver**       | No       | The payment provider that processes this method. Choose **Manual** for offline payments or **Stripe** for card payments |
| **Link URL**     | No       | External URL for the payment provider                                                                                   |
| **Description**  | No       | Explanation shown to customers when selecting this method                                                               |
| **Instructions** | No       | Post-purchase instructions (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    |

<Frame>
  <img src="https://mintcdn.com/shopperlabs-ee054f5e/RoQo55-CU3i212Mj/images/v2/payment-methods-driver.png?fit=max&auto=format&n=RoQo55-CU3i212Mj&q=85&s=a2bf43601071dcc63122a2ef57bc1e89" alt="select payment method driver" width="1438" height="1106" data-path="images/v2/payment-methods-driver.png" />
</Frame>

<Note>
  Drivers like Stripe require 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](/v2/payments) for setup instructions.
</Note>

## Assigning to Zones

Payment methods are assigned to [zones](/v2/user-guide/store-setup/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. Edit the zone
3. Select the payment method in the **Payment methods** field
4. Click **Save**

## Managing Payment Methods

### Editing a Payment Method

Click the **Edit** icon next to a method, update the fields, and click **Save**.

### 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 **Delete** icon and confirm. Active orders that used this method are not affected.

## 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

<CardGroup cols={2}>
  <Card title="Offer Multiple Options" icon="credit-card">
    Customers are more likely to complete checkout when they see a payment method they trust.
  </Card>

  <Card title="Zone-Specific Methods" icon="map">
    Some methods work only in certain regions. Assign them to the right zones.
  </Card>

  <Card title="Clear Instructions" icon="file-lines">
    For manual methods like bank transfers, provide clear payment instructions so customers know what to do after ordering.
  </Card>

  <Card title="Test Payments" icon="vial">
    Use your payment provider's test/sandbox mode to verify the checkout flow before going live.
  </Card>
</CardGroup>

For developer details on payment drivers, custom providers, and transaction management, see the [Payments documentation](/v2/payments).