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

# How to add a manual payment method

> Name a payment method customers settle outside TWICE, such as a hotel room bill, an invoice or your own till, and offer it at checkout.

> [card] [Open in TWICE Admin](https://admin.twicecommerce.com/settings/storefront/payments)
>
> settings/storefront/payments

Add a manual payment method when customers pay you somewhere TWICE Commerce does not see: on a hotel room bill, against an invoice, or at your own till. A customer who picks it at checkout places the order without paying online. [How payments work](https://www.twicecommerce.com/docs/concepts/orders/payments.md) explains manual methods.

## Prerequisites

> [!WARNING]
>
> **Required permissions:** **Manage payment setup**, to add the method (`account_settings:payment:create`) and to switch it on (`account_settings:payment:manage`). Admin and Owner hold it. See [Users & Roles](https://www.twicecommerce.com/docs/settings/users-roles.md).

> [!NOTE]
>
> **Have ready before you start:**
>
> * **The name customers see** at checkout, for example Room bill or Pay by invoice.
> * **What the customer does instead of paying online**, in a sentence or two, such as giving their room number at reception.

## The walkthrough

**1. Open Manual payment methods**

Open **Settings → Payments** and scroll to **Manual payment methods** at the bottom of the page. It lists **Pay on pickup** and every method you added, each with a switch to the left of its name.

![The Manual payment methods section at the bottom of Settings, Payments, with its heading and Pay on pickup highlighted](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-manual-payment-method-01.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=49334368a8a3bc29e916f93403da2d4b)

**2. Add a method**

Click **Add payment method** under the list. A dialog of the same name opens with two fields, **Name** and **Additional details**.

![The Add payment method dialog open over Settings, Payments, with its two empty fields, and the Add payment method button behind it](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-manual-payment-method-02.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=62b1671cf02f80f067b421a52870b963)

**3. Name and describe the method**

Enter **Name**, which customers see on the method at checkout, for example Room bill. Under **Additional details**, write what the customer does instead, for example: Charged to your room. Give your room number at reception. Checkout shows it under the name.

![The Add payment method dialog with Room bill in Name and the room instructions in Additional details](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-manual-payment-method-03.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=ad8d6a4ba9d2ab5c5fdfbe589dd01fe3)

**4. Save the method**

Click **Save** at the bottom of the dialog. The dialog closes, and the method joins the list under **Manual payment methods** with its details under the name and its switch off.

![Room bill added under Manual payment methods with its details under the name and its switch off](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-manual-payment-method-04.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=fa8f00ea4284e1f36e2dd107d797898d)

**5. Switch it on**

Click the switch to the left of the method's name. Checkout offers the method once its switch is on, and staff can choose it under **Payment method** when they record a manual payment on an order.

![Room bill under Manual payment methods with its switch on and highlighted](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-add-a-manual-payment-method-05.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=647ef80d0d6ad54d8dfa1617123bad8a)

## How do I know it worked?

* **The method's switch is on** under **Manual payment methods**.
* **The storefront checkout offers it.** Its Payment step shows a tile with the method's name and details, and a **Confirm** button.
* **An order placed with it reads Unpaid** on its **Payments** card, until you record the payment against it with this method.

## Troubleshooting / common pitfalls

> [accordion] The method is missing from checkout
>
> The checkout offers only the methods its Payment step allows. Tick the method there, or tick the box that allows every available method. See [Checkout steps](https://www.twicecommerce.com/docs/settings/checkouts/steps.md#payment).

> [accordion] Staff cannot find the method when they record a payment
>
> Its switch is off, so it is missing from the **Payment method** list on the order. Switch it on under **Manual payment methods**. See [Record a manual payment](https://www.twicecommerce.com/docs/guides/orders/record-a-manual-payment.md).

## Related articles

> [card] [How payments work](https://www.twicecommerce.com/docs/concepts/orders/payments.md)
>
> Manual methods, receipts, and what a payment records.

> [card] [Record a manual payment](https://www.twicecommerce.com/docs/guides/orders/record-a-manual-payment.md)
>
> Recording what the customer paid outside TWICE against the order.

> [card] [Checkout steps](https://www.twicecommerce.com/docs/settings/checkouts/steps.md)
>
> Which payment methods each checkout offers.

> [card] [Settings - Payments](https://www.twicecommerce.com/docs/settings/payments.md)
>
> Card payments and manual methods in one place.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.