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.
Enable/Disable
Setting label: Enable/Disable
Checkbox label: Enable Custom Payment
What it does
Turns the payment gateway on or off at checkout.
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
Check Enable Custom Payment when your Pay by Invoice gateway is configured and tested.
Method Title
What it does
The payment method name shown to customers on the checkout page.
When to use it
Use a clear, customer-friendly name that describes how they will pay.
Example values
Pay by InvoiceBank TransferPurchase OrderRequest Payment Link
Gateway Icon
What it does
Optional image URL displayed next to the payment method title at checkout.
When to use it
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://yoursite.com/wp-content/uploads/invoice-icon.png
Use a full URL to an image file hosted on your site or CDN.
Customer Message
What it does
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
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
Place your order now and pay later by invoice. We will send the invoice and payment instructions after reviewing your order.
Customer Note
What it does
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
Provide follow-up instructions after the order is placed — contact details, expected timelines, or what happens next.
Example value
Thank you for your order. Our accounts team will email your invoice within 2 business days. Payment is due within 30 days.
Invoice Instructions
Available on gateways created from the Pay by Invoice template.
What it does
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
Explain how invoicing works for your store: who sends the invoice, what the customer should do, and any reference to include.
Example value
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
Available on gateways created from the Pay by Invoice template.
What it does
Shows your payment terms in the Payment details section (for example, Net 30).
When to use it
When you offer trade credit or standard invoice payment deadlines.
Example value
Net 30 days from invoice date
Invoice Contact Email
Available on gateways created from the Pay by Invoice template.
What it does
Displays a contact email address in the Payment details section. Customers can click it to send email.
When to use it
Give customers a direct contact for invoice or accounts questions.
Example value
[email protected]
Order Status After The Checkout
What it does
Sets the WooCommerce order status immediately after the customer places an order using this gateway.
When to use it
| 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
For Pay by Invoice, choose On hold so orders stay open until you send and receive payment.
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 for full details.
Conditional Display Rules
Control when this gateway appears at checkout based on country, cart total, user role, and other conditions.
See Conditional Display Rules for full details.
Enable Debug Mode
Setting label: Enable Debug Mode
What it does
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
- 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
Turn off debug mode when you are ready for all customers to use the gateway.
Example workflow
- Enable the gateway and turn on Enable Debug Mode.
- Log in as an administrator and complete a test order.
- Confirm fields, order status, and emails look correct.
- Turn off Enable Debug Mode and save.
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 for API-related settings.