--- title: Custom Payment Gateway Settings description: "[https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#custom-payment-gateway-settings](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#custom-payment-gateway-settings) Each custom payment gateway has its own settings page at **WooCommerce → Settings → Payments → Manage**. Settings are grouped into general options, template-specific payment details (when using a template), the custom checkout field builder, conditional display rules, and advanced…" url: "https://wpruby.com/knowledgebase/custom-payment-gateway-settings/" updated: "2026-07-07" category: WooCommerce Custom Payment Gateway Pro --- # Custom Payment Gateway Settings [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#custom-payment-gateway-settings](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#custom-payment-gateway-settings) Each custom payment gateway has its own settings page at **WooCommerce → Settings → Payments → Manage**. Settings are grouped into general options, template-specific payment details (when using a template), the custom checkout field builder, conditional display rules, and advanced API options. Table of Contents [Toggle](#) - [Enable/Disable](#EnableDisable) - [What it does](#What_it_does) - [When to use it](#When_to_use_it) - [Example](#Example) - [Method Title](#Method_Title) - [What it does](#What_it_does-2) - [When to use it](#When_to_use_it-2) - [Example values](#Example_values) - [Gateway Icon](#Gateway_Icon) - [What it does](#What_it_does-3) - [When to use it](#When_to_use_it-3) - [Example value](#Example_value) - [Customer Message](#Customer_Message) - [What it does](#What_it_does-4) - [When to use it](#When_to_use_it-4) - [Example value](#Example_value-2) - [Customer Note](#Customer_Note) - [What it does](#What_it_does-5) - [When to use it](#When_to_use_it-5) - [Example value](#Example_value-3) - [Invoice Instructions](#Invoice_Instructions) - [What it does](#What_it_does-6) - [When to use it](#When_to_use_it-6) - [Example value](#Example_value-4) - [Payment Terms](#Payment_Terms) - [What it does](#What_it_does-7) - [When to use it](#When_to_use_it-7) - [Example value](#Example_value-5) - [Invoice Contact Email](#Invoice_Contact_Email) - [What it does](#What_it_does-8) - [When to use it](#When_to_use_it-8) - [Example value](#Example_value-6) - [Order Status After The Checkout](#Order_Status_After_The_Checkout) - [What it does](#What_it_does-9) - [When to use it](#When_to_use_it-9) - [Example](#Example-2) - [Custom Form](#Custom_Form) - [Conditional Display Rules](#Conditional_Display_Rules) - [Enable Debug Mode](#Enable_Debug_Mode) - [What it does](#What_it_does-10) - [When to use it](#When_to_use_it-10) - [Important](#Important) - [Example workflow](#Example_workflow) - [Advanced options](#Advanced_options) ## Enable/Disable [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#enabledisable](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#enabledisable) **Setting label:** Enable/Disable **Checkbox label:** Enable Custom Payment ### What it does [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does) Turns the payment gateway on or off at checkout. ### When to use it [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it) - Turn **on** when the gateway is ready for customers (or for admin testing with debug mode). - Turn **off** to hide the gateway without deleting its configuration. ### Example [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example) Check **Enable Custom Payment** when your Pay by Invoice gateway is configured and tested. --- ## Method Title [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#method-title](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#method-title) ### What it does [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-1](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-1) The payment method name shown to customers on the checkout page. ### When to use it [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-1](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-1) Use a clear, customer-friendly name that describes how they will pay. ### Example values [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-values](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-values) - `Pay by Invoice` - `Bank Transfer` - `Purchase Order` - `Request Payment Link` --- ## Gateway Icon [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#gateway-icon](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#gateway-icon) ### What it does [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-2](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-2) Optional image URL displayed next to the payment method title at checkout. ### When to use it [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-2](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-2) Add a small icon (for example, an invoice or bank icon) to make the method easier to recognize. Leave blank or remove the default placeholder URL if you do not want an icon. ### Example value [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value) ```php https://yoursite.com/wp-content/uploads/invoice-icon.png ``` Use a full URL to an image file hosted on your site or CDN. --- ## Customer Message [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#customer-message](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#customer-message) ### What it does [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-3](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-3) A message shown on the checkout page when the customer selects this payment method. It appears above any payment details and custom checkout fields. ### When to use it [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-3](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-3) Explain what the customer should expect — for example, that payment happens later, that you will send instructions, or what information they need to provide. ### Example value [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value-1](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value-1) ```php Place your order now and pay later by invoice. We will send the invoice and payment instructions after reviewing your order. ``` --- ## Customer Note [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#customer-note](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#customer-note) ### What it does [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-4](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-4) A note shown to the customer **after** checkout on the thank-you page and in the order details area. It is also added as a customer-visible order note when filled in. ### When to use it [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-4](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-4) Provide follow-up instructions after the order is placed — contact details, expected timelines, or what happens next. ### Example value [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value-2](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value-2) ```php Thank you for your order. Our accounts team will email your invoice within 2 business days. Payment is due within 30 days. ``` --- ## Invoice Instructions [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#invoice-instructions](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#invoice-instructions) *Available on gateways created from the **Pay by Invoice** template.* ### What it does [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-5](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-5) Instructions displayed to the customer as part of the **Payment details** section at checkout, on the thank-you page, and in emails (when configured). This is merchant-facing content you configure — not a customer input field. ### When to use it [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-5](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-5) Explain how invoicing works for your store: who sends the invoice, what the customer should do, and any reference to include. ### Example value [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value-3](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value-3) ```php After your order is reviewed, we will email a PDF invoice to your billing contact. Please include your purchase order number on all correspondence. ``` --- ## Payment Terms [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#payment-terms](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#payment-terms) *Available on gateways created from the **Pay by Invoice** template.* ### What it does [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-6](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-6) Shows your payment terms in the **Payment details** section (for example, Net 30). ### When to use it [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-6](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-6) When you offer trade credit or standard invoice payment deadlines. ### Example value [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value-4](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value-4) ```php Net 30 days from invoice date ``` --- ## Invoice Contact Email [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#invoice-contact-email](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#invoice-contact-email) *Available on gateways created from the **Pay by Invoice** template.* ### What it does [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-7](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-7) Displays a contact email address in the **Payment details** section. Customers can click it to send email. ### When to use it [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-7](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-7) Give customers a direct contact for invoice or accounts questions. ### Example value [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value-5](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-value-5) ```php accounts@yourstore.com ``` --- ## Order Status After The Checkout [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#order-status-after-the-checkout](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#order-status-after-the-checkout) ### What it does [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-8](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-8) Sets the WooCommerce order status immediately after the customer places an order using this gateway. ### When to use it [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-8](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-8) | Status | Typical use | | --- | --- | | **On hold** | Manual review, invoice, or bank transfer — payment not yet confirmed | | **Pending payment** | Waiting for customer payment | | **Processing** | Payment assumed or pickup/local payment in progress | | **Completed** | Payment treated as complete at checkout (use carefully for manual methods) | ### Example [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-1](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-1) For Pay by Invoice, choose **On hold** so orders stay open until you send and receive payment. --- ## Custom Form [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#custom-form](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#custom-form) The **Custom Form** section contains the **Custom checkout field builder**. Use it to add fields customers fill in at checkout (company name, PO number, uploaded receipts, and more). See [Custom Checkout Field Builder](https://wpruby.com/knowledgebase/custom-checkout-field-builder/) for full details. --- ## Conditional Display Rules [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#conditional-display-rules](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#conditional-display-rules) Control when this gateway appears at checkout based on country, cart total, user role, and other conditions. See [Conditional Display Rules](https://wpruby.com/knowledgebase/conditional-display-rules/) for full details. --- ## Enable Debug Mode [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#enable-debug-mode](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#enable-debug-mode) **Setting label:** Enable Debug Mode ### What it does [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-9](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#what-it-does-9) When enabled, the gateway is **only available to users with the Administrator role**. Other customers will not see it at checkout, even if **Enable Custom Payment** is checked. ### When to use it [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-9](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#when-to-use-it-9) - Test checkout fields, messages, and order status before going live. - Verify conditional display rules while logged in as an admin. - Troubleshoot API requests without affecting real customers. ### Important [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#important](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#important) Turn off debug mode when you are ready for all customers to use the gateway. ### Example workflow [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-workflow](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#example-workflow) 1. Enable the gateway and turn on **Enable Debug Mode**. 2. Log in as an administrator and complete a test order. 3. Confirm fields, order status, and emails look correct. 4. Turn off **Enable Debug Mode** and save. --- ## Advanced options [https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#advanced-options](https://github.com/wsenjer/woocommerce-custom-payment-gateway/blob/docs-cursor/docs/general-settings.md#advanced-options) Below the conditional display rules, the **Advanced options** section includes API request settings, payload preview, test requests, API logs, and debug mode. See [Sending Payment Data to an External API](https://wpruby.com/knowledgebase/sending-payment-data-to-an-external-api/) for API-related settings.