WP Companion
Docs / PowerTranz Gateway / Troubleshooting

The payment window is blank or shows a PowerTranz error

Common issues when the PowerTranz payment window is blank or shows an error.

Plans: Free / Professional / Premium Requires v1.0 Reviewed 12 November 2026

The customer clicks Place order, the payment window opens, and the card form is missing or PowerTranz shows an error such as Hosted page not found.

The cause is usually the payment page in the PowerTranz portal. Check these in order.

1. Is the page published?

In the PowerTranz portal, go to Admin, then Hosted Payment Pages. Find your page, click Actions, then Publish. A page that was saved but never published does not load, which is a common cause.

2. Do the names match?

In the gateway settings, compare Page set and Page name with the portal. They must match exactly, including capital letters and spaces.

The Page set in WordPress starts with PTZ/, which is correct. The plugin adds it because PowerTranz requires it, even though the portal does not show it.

3. Is the page on the right environment?

Staging and production are separate, so a page created for your staging account does not exist on your production account. If the error started when you went live, create the page again in the production portal and publish it.

4. Did you paste both blocks?

Open the page editor in the portal. The HTML box and the Custom Styles box should both contain the code from Settings, then PowerTranz. If one is empty, paste it again, save and publish.

Still blank?

Open the order and read the newest order note. If PowerTranz rejected the request, the note gives the reason. Then turn on the debug log and try once more. See finding out why a payment failed.

Still stuck? Every plan includes hands-on support, including the free plan. We answer from Trinidad and Tobago, within one business day.

Contact support