Everything you need to
take card payments.

BlueGate for WooCommerce connects your store to your own Powertranz merchant account. You keep the money relationship with your bank; BlueGate carries each payment between your store and the processor.

1. 1Download the plugin ZIP from your account and install it in WordPress.
2. 2Paste your licence key to activate the site.
3. 3Enter the Powertranz ID and password your bank issued you.
4. 4Choose how customers pay and which cards you accept.
5. 5Run the go-live checks, place one test order, then switch to live mode.

1. 1Download bluegate-for-woocommerce-1.8.0.zip from the Downloads page in your account. Do not unzip it.
2. 2In WordPress go to Plugins, then Add New Plugin, then Upload Plugin.
3. 3Choose the ZIP file and select Install Now.
4. 4Select Activate Plugin. A BlueGate menu appears in the left sidebar.

1. 1Open BlueGate, then License.
2. 2Paste the licence key from your purchase email, or copy it from the Licenses page in your account.
3. 3Select Activate license. The screen confirms the site is licensed.

The licence is checked once a day. Moving to a new domain? Select Deactivate this site first, then activate on the new one — you can also release a site from the Licenses page in your account at any time.

Open BlueGate, then Setup, and go to step 2. Enter the Powertranz ID and password your bank issued. The password is typed into a masked field and never displayed again after saving — if you come back later and leave it blank, the saved one is kept.

Using the hosted page? Create the page in your Powertranz merchant portal, then enter the page set and page name here. Page sets must start with the PTZ/ prefix, for example PTZ/MyPageSet, and your template must collect the cardholder name plus an email address or phone number — 3D Secure requires them.

Step 4 of the setup screen runs a checklist and refuses to switch card payments on until the required items pass. Each line tells you what is wrong and how to fix it.

• WooCommerce is active on this site
• Licence is active for this site
• Powertranz ID and password are saved
• Hosted payment page details are complete (if you chose hosted)
• HTTPS is active for live payments
• Block checkout support detected
• Currency number matches your store currency
• At least one card brand is accepted

1. 1Set Mode to Testing with credentials authorised for the Powertranz test environment.
2. 2Place a real order through your own checkout using a test card supplied by Powertranz.
3. 3Confirm the order reaches a paid status and shows a transaction reference in the BlueGate box.
4. 4Run a refund from the order screen to confirm refunds work.
5. 5Switch Mode to Live payments, then complete one small real transaction on your own card and refund it.

Everything below can be done from WordPress, without signing in anywhere else. The plugin also includes the same guidance on the BlueGate, Managing orders screen inside your WordPress admin.

Refund a payment in full:

1. 1Open WooCommerce, then Orders, and open the order.
2. 2Scroll to the list of items and select Refund.
3. 3Select Refund the full amount, or type the full order total in the Refund amount box.
4. 4Type a reason if you want one recorded on the order.
5. 5Select Refund via BlueGate and confirm.
6. 6Check the order notes. An approved refund records the amount, the reason and the Powertranz reference.

Refund part of a payment:

1. 1Open the order and select Refund below the items.
2. 2Enter the quantity or amount for each line being refunded, or type an amount in the Refund amount box.
3. 3Select Refund via BlueGate and confirm.
4. 4Repeat later if needed. The total refunded can never go above the order total.

Prefer to work in the Powertranz merchant portal? Refunds, voids and settlement reports can also be handled there with the same merchant account, at https://admin.ptranz.com/portal/Account/Login.

1. 1Sign in to the portal with the details your acquiring bank issued.
2. 2Find the transaction using the reference shown in the BlueGate box on the WooCommerce order.
3. 3Refund or void it there.
4. 4Return to the WooCommerce order, select Refund, enter the same amount and choose Refund manually so your records match without sending a second refund.

Other things you can do from the order screen: resend a receipt with Email invoice / order details to customer, change or cancel a subscription under WooCommerce, Subscriptions, and refund an individual renewal from its own order.

Switch on saved cards and install WooCommerce Subscriptions to sell subscription products. The first payment securely stores the customer's card with Powertranz, and each renewal is charged automatically as a merchant-initiated recurring payment.

If a renewal is declined, the renewal order is marked failed with the gateway's reason so WooCommerce can retry it and email the customer. Customers can change the saved card from their account area.

• 3D Secure asks the cardholder's bank to verify the payment before it is approved.
• Address verification sends the billing address so the bank can compare it with the cardholder's records.
• The card security code is required on every on-site payment and is never stored.
• Kount risk management can score transactions before approval, with a test mode while you tune your rules. Kount must also be enabled on your Powertranz account.
• Card numbers are never saved to your WordPress database and never written to logs.

Licensed sites receive update notices inside WordPress, exactly like any other plugin — select Update and you are done. You can also download the latest ZIP from the Downloads page in your account at any time; those links are private and expire after 48 hours, so simply request a fresh one when you need it.

BlueGate is an independent merchant payments platform and is not affiliated with, endorsed by, or sponsored by Powertranz Ltd.

Powertranz® is a trademark of its respective owner and is referenced only to identify the external payment gateway this plugin connects to using your own merchant credentials.