WPRuby Logo WPRuby
Log in Get started
  • Plugins
  • Docs
  • Blog
    • eCommerce
    • Plugins
    • How to
    • Coding
  • Affiliate Area
  • Contact Us
  • About Us
  • Plugins
  • Docs
  • Blog
    • eCommerce
    • Plugins
    • How to
    • Coding
  • Affiliate Area
  • Contact Us
  • About Us

WPRuby Account

4
  • How to upgrade your license
  • How to renew your license
  • How to change your plugin’s license domain
  • How to cancel your subscription.

WooCommerce Australia Post Shipping Method Pro

17
  • Installation
  • How to activate your plugin license
  • How to Upgrade from Free to Pro
  • Australia Post Zone Settings
  • Australia Post Global Settings
  • Australia Post Tracking
  • Pre-Paid Satchels
  • How to Mark a Product to be Shipped individually?
  • TroubleShooting and Common issues
  • Available WordPress Actions and Filters
  • [Labels Pro] How to connect the plugin with your MyPost Business account
  • [Labels Pro] How to connect Labels Pro with your eParcel account
  • [Labels Pro] How to create shipping labels?
  • [Labels Pro] How to print labels and create shipping orders.
  • [Labels Pro] Label Printing & Contracted Prices Credentials
  • [Labels Pro] How to Mark a Product as Containing Hazardous Materials?
  • Step by Step Guide on how to migrate to Shipping Zones

WooCommerce Custom Payment Gateway Pro

11
  • Getting Started
  • Custom Payment Gateway Settings
  • Custom Checkout Field Builder
  • Conditional Display Rules
  • Sending Payment Data to an External API
  • How to Create a Pay by Invoice Payment Method
  • How to Create a Manual Payment Link or Review-Based Payment Method
  • Troubleshooting
  • Frequently Asked Questions
  • Security and Sensitive Payment Data
  • How to Upgrade from Free to Pro

WooCommerce Royal Mail Shipping Calculator Pro

4
  • Installation
  • Settings
  • TroubleShooting and Common issues
  • How to activate your plugin license

Controlled Admin Access Pro

3
  • Available Actions for a Restricted Admin
  • Installation
  • Settings

WooCommerce Simple Table Rates Pro

8
  • Installation
  • Settings
  • Rules and Actions
  • How to Setup Weight Based Shipping
  • How To Setup Shipping By Shipping Class
  • How to Setup Shipping by Cart Total
  • How to Setup Shipping by Product
  • How to Setup Shipping by Product Category

WooCommerce Pack IQ

5
  • Installation
  • How to activate your plugin license
  • How to add a new box
  • How to change the boxes weight and dimensions units
  • How to view the packing results

WooCommerce Restricted Shipping and Payment Pro

4
  • Installation
  • Setting Up Shipping Methods Conditions
  • Available Shipping & Payment Rules
  • Setting Up Payment Gateways Conditions

Affiliate Butler PRO

9
  • Installation and Upgrade
  • Quick Start Guide
  • Settings
  • Keywords Management
  • Installation
  • Frequently Asked Questions
  • Files Structure
  • Links Types
  • Statistics

WooCommerce Adyen Payment Gateway

2
  • Setup the Adyen payment gateway
  • How to configure Adyen Webhook notifications? 

WooCommerce Free Shipping Per Product

2
  • Installation
  • How to setup free shipping for a certain product

WooCommerce UPS Shipping Method Pro

4
  • Installation
  • UPS Zone Settings
  • UPS Global Settings
  • How to get the UPS Access Key?

Delivery Promise for WooCommerce

9
  • Getting Started
  • Understanding Processing Time vs Transit Time
  • Setting the Cutoff Countdown
  • Configuring Default Delivery Estimates
  • Creating Delivery Rules
  • Setting Working Days and Holidays
  • Using Rule Presets
  • Product-Level Lead Times
  • Why the “Order Within” Countdown Is Not Showing
View Categories
  • Home
  • Knowledge Base
  • WooCommerce Custom Payment Gateway Pro
  • Frequently Asked Questions

Frequently Asked Questions

Waseem
Updated on July 7, 2026

4 min read

Table of Contents

Toggle
  • Can I create more than one custom payment gateway?
  • Can I collect extra fields at checkout?
  • Can I make fields required?
  • Can I show the gateway only for specific countries?
  • Can I send order data to an external API?
  • Can I redirect customers to an external payment page?
  • Can I use this for invoice payments?
  • Can I use this for purchase orders?
  • Can I collect credit card details with this plugin?
  • Can I test the gateway before customers see it?
  • Where can I see API request logs?
  • Where is submitted payment information stored?
  • Are uploaded files stored in WooCommerce?
  • Can customers see payment instructions at checkout?
  • Does the plugin work with WooCommerce block checkout?
  • What order statuses should I use for manual payments?
  • Can I show payment field data in order emails?

Can I create more than one custom payment gateway?

Yes. Go to WooCommerce → Settings → Custom Payment Gateways and create additional gateways from templates or Start from scratch. Each gateway has its own settings, checkout fields, and conditional rules.

The plugin also includes a base gateway (Custom Payment Pro) listed under WooCommerce → Settings → Payments.


Can I collect extra fields at checkout?

Yes. Use the Custom Form field builder on each gateway settings page. You can add text, email, file upload, signature, and other field types.

See Custom Checkout Field Builder.


Can I make fields required?

Yes. In the field builder, set Required to Yes for any supported field type. Checkout will not complete until the customer fills in required fields.


Can I show the gateway only for specific countries?

Yes. Use Conditional Display Rules with the Customer country condition type.

See Conditional Display Rules.


Can I send order data to an external API?

Yes. Enable API requests under Advanced options, configure the URL, headers, and parameters, then place orders or use Send Test Request.

See Sending Payment Data to an External API.


Can I redirect customers to an external payment page?

Yes. Enable API requests, set your API URL, and check Redirect the Customer to the API URL.

  • GET — customers are redirected with data in the URL.
  • POST — customers are sent through a receipt page that submits a form to your URL.

JSON POST mode is not used when redirect is enabled.


Can I use this for invoice payments?

Yes. Use the Pay by Invoice template or configure a custom gateway with invoice instructions, payment terms, and checkout fields for company and PO details.

See How to Create a Pay by Invoice Payment Method.


Can I use this for purchase orders?

Yes. Add checkout fields such as Purchase order number, Company name, and Billing contact email. Set the order status to On hold until you approve the PO.


Can I collect credit card details with this plugin?

No. Do not use custom fields to collect full card numbers, CVV/CVC codes, or card security data.

The legacy Credit Card field is deprecated — it cannot be added to new gateways and will be removed in a future update. Use a PCI-compliant payment gateway for card payments.

See Security and Sensitive Payment Data.


Can I test the gateway before customers see it?

Yes. Turn on Enable Debug Mode. The gateway will only appear for users with the Administrator role.

Turn off debug mode when you are ready to go live.


Where can I see API request logs?

On each gateway settings page, scroll to Advanced options → API Request Tools → API Logs.

You can filter by status, order ID, and date. Open a log entry for full request and response details.


Where is submitted payment information stored?

By default, field values are stored in order meta and shown in the Payment Information section on orders. You can control this with:

  • Store Payment Information in the Database (global setting on Custom Payment Gateways tab)
  • Per-field options for file uploads (Store with order)

Are uploaded files stored in WooCommerce?

Uploaded files are saved as WordPress media library attachments in your uploads folder. Links appear on the order when Show in admin order details is enabled.


Can customers see payment instructions at checkout?

Yes, for gateways created from templates (Bank Transfer, Pay by Invoice, Manual Payment Link, and others). Template-specific settings (bank details, invoice instructions, payment links) appear in the Payment details section at checkout.

Configure these in gateway settings — not as customer input fields.


Does the plugin work with WooCommerce block checkout?

The plugin includes block checkout support. Test your gateway on your active checkout type (classic or blocks) before going live.


What order statuses should I use for manual payments?

Common choices:

  • On hold — review or invoice pending
  • Pending payment — waiting for customer payment
  • Processing — payment confirmed or local pickup in progress

Choose the status that matches your workflow.


Can I show payment field data in order emails?

Yes. Enable Add payment info to emails under WooCommerce → Settings → Custom Payment Gateways global settings.

File upload fields also have a Show in emails option per field.

TroubleshootingSecurity and Sensitive Payment Data
WPRuby Logo WPRuby

In 2015, WPRuby was established as an independent agency where we focus on producing and supporting many WordPress plugins. Each product we develop is simple to use and easy to customize and backed by awesome support and regular updates.

Resources

  • Knowledge Base
  • Affiliate Area
  • About Us
  • WPTools
  • Nomad Jar

Legal

  • Privacy Policy
  • Terms of Use

Follow us

  • Github
  • X.com
  • LinkedIn
  • Facebook

© 2026 - WPRuby