---
title: Payments
description: "Choose how buyers pay at checkout: the test gateway on staging, your own XPay account, and manual methods such as cash on delivery."
---

In **Settings**, press **Payments**. The page says **How buyers pay at checkout, in the store currency.** It has three parts: **Payment provider** (who takes card payments), **Connect XPay** (your own XPay account) and **Manual payment methods** (payments made outside RetailPrime).

## Before you choose

A new store has no provider: **Not set up: checkout says the store cannot take payments yet.**

![The whole Payments page: Payment provider not set up with Use the test gateway, the Connect XPay form, and Manual payment methods with No manual methods.](/screenshots/settings/50-payments-empty.jpg)

## Use the test gateway (staging)

On staging, press **Use the test gateway**. The provider becomes **Test gateway (no real payments)**. At checkout, buyers then choose a **test card** instead of typing a real one, as [Shipping and delivery](/settings-and-apps/shipping-and-delivery#a-buyer-picks-up-an-order) shows.

![The Payment provider card with Test gateway (no real payments) and Stop taking payments](/screenshots/settings/52-test-gateway.jpg)

**Stop taking payments** takes the provider away again, and checkout goes back to saying the store cannot take payments.

## Connect XPay

**Connect XPay** says **Your own XPay account. The keys are checked with XPay before they are saved, and the secrets are never shown again.**

| Box | What to type |
| --- | --- |
| **Mode** | **Stage (testing)** or **Live** |
| **Account ID** (required) | Your XPay account ID, from XPay |
| **Public key** (required) | Your XPay public key |
| **Secret key** (required) | Your XPay secret key (shown as dots) |
| **HMAC secret** (required) | Your XPay HMAC secret (shown as dots) |
| **Payment methods** | Tick **Card**, **JazzCash** or both |

Then press **Save XPay account**. Once saved, the provider shows **XPay**, with your account, mode, the end of your public key and the methods, and the card is called **Replace the XPay account**.

![The Connect XPay card with ACC-12345 in Account ID and pk_test_sunnysocks in Public key, and Card ticked](/screenshots/settings/51-xpay-form.jpg)

:::caution[Real keys only]
The keys in the picture are examples. XPay checks the keys when you press **Save XPay account**, so only real keys from your own XPay account can be saved. On staging, use the test gateway unless you have an XPay stage account. A saved XPay account is not pictured in this guide, because the environment the pictures are taken in can't reach XPay.
:::

## Manual payment methods

**Payments made outside RetailPrime, such as cash on delivery. The order waits for payment until you record it.** (Part 3, [Payments and refunds](/orders-and-customers/payments-and-refunds), shows how to record one.)

### Add a manual method

1. Press **Add manual method**.
2. Fill in the window:

| Box | What to type | Example |
| --- | --- | --- |
| **Kind** | **Cash on Delivery (COD)**, **Bank Deposit**, **Money Order** or **Custom payment method**. Each named kind can be added once | **Cash on Delivery (COD)** |
| **Custom payment method name** (only for a custom method, required) | Its name | `Easypaisa transfer` |
| **Additional details** | **Shown next to the method at checkout.** | `Pay the rider in cash when your socks arrive.` |
| **Payment instructions** | **Shown on the order status page and in the order confirmation.** | `Keep the exact amount ready.` |
| **Enabled at checkout** | Ticked: buyers can choose it | ticked |

   ![The Add manual method window with Cash on Delivery (COD), the details and instructions, and Enabled at checkout ticked](/screenshots/settings/53-add-cod.jpg)

   For **Custom payment method**, the window adds **Custom payment method name**:

   ![The Add manual method window with Custom payment method and Easypaisa transfer](/screenshots/settings/54-add-custom-method.jpg)

3. Press **Save**. The method is listed with **Enabled** (or **Disabled**), and **Edit** and **Delete** buttons.

![Manual payment methods: Bank Deposit, Cash on Delivery (COD) and Easypaisa transfer, all Enabled](/screenshots/settings/55-manual-methods.jpg)

### Edit a manual method

Press **Edit** on its row. The window (here **Edit Bank Deposit**) has the same boxes except **Kind**. Untick **Enabled at checkout** to hide it from buyers without deleting it, then press **Save**.

![The Edit Bank Deposit window with the instructions and Enabled at checkout not ticked](/screenshots/settings/56-edit-method.jpg)

### Delete a manual method

Press **Delete** on its row. A window asks **Delete Easypaisa transfer?** and says **Buyers can no longer choose it at checkout. Orders that used it keep its name.** Press **Delete**.

![The Delete Easypaisa transfer? window with Cancel and Delete; Bank Deposit is now Disabled](/screenshots/settings/57-delete-method.jpg)

![Manual payment methods after: Bank Deposit Disabled and Cash on Delivery (COD) Enabled](/screenshots/settings/58-methods-after.jpg)

At checkout, buyers see the enabled methods next to **Pay online**, as in the picture on [Checkout](/settings-and-apps/checkout).

## What's next

[Checkout](/settings-and-apps/checkout): choose what buyers fill in when they pay.
