Requirements

• An active NAB Transact online merchant account (see above)
• A trusted SSL certificate
• AUD as your payment currency

Installing NAB Transact

1. Purchase and download the plugin zip file from WooCommerce.com.
2. Contact NAB Transact for your Client ID and transaction password.
3. Login to your WordPress Admin. Click on Plugins | Add New from the left hand menu.
4. Click on the “Upload” option, then click “Browse” to select the zip file from your computer. Once selected, press “OK” and press the “Install Now” button.
5. Activate the plugin.

Setup and Configuration

1. To configure the plugin, click on WooCommerce > Settings from the left hand menu, then the top tab “Payments”. You should see “NAB Transact” as an option in the list.
2. You should see “NAB Transact” displayed across the top of the page as a link also. Click on this to configure the plugin, and you will see a list of options:
   • Tick to “Enable this payment method”.
   • The “Title” option allows you to determine what your customers will see this payment option displayed as. You might choose for this to be something like “NAB Transact” or “Credit card”.
   • Select which “Integration Method” you wish to use. You can see a brief overview of the two methods.
   • [Direct Post only] The “API Version” option allows you to revert to V1 of the NAB Transact API if you have the need to do so. Otherwise, leave it on V2 to take advantage of the faster fingerprint generation and support for Risk Management and UnionPay.
   • The “Enable Test mode” option allows you to test transactions with this payment gateway to ensure your details are correct. See below for testing details.
   • Your “NAB Client ID” will be of the format “ABC0010″, where ABC is your unique three-letter account code.
   • Your “NAB Password” will be provided by NAB Transact.
   • Enter a “Reference ID prefix” if you wish to customize the reference listed in your NAB Transact transaction listing. You can further customize this by using the woocommerce_nab_dp_reference_id filter.
   • Disable “Capture charge immediately” if you wish to only process pre-authorizations during checkout. If this is set, after successful checkout the order will have a status of On Hold. When you change this order to Processing or Completed the payment will be captured automatically.
   • Enable “Risk Management” if NAB have enabled this feature on your account.
   • [Direct Post only] Enable “3D Secure” if NAB have enabled this feature on your account and you wish to use the Verified By VISA and/or Mastercard SecureCode.
   • [3D Secure only] If you’ve enrolled in 3D Secure with NAB you’ll need to enter your EB Number provided by NAB on this page.
   • [Direct Post only] Enable “UnionPay Online Payments” if NAB have enabled this feature on your account and you wish to accept Chinese UnionPay cards on your website. See the note below about the UnionPay checkout process.
   • If you have arranged with NAB Transact to accept American Express, Diners Club or JCB cards, tick these boxes to advise customers they can use these card types on the payment screen.
3. Save changes and you’re all done!

UnionPay checkout

If you’ve enabled the UnionPay Online Payments option above and are using the Direct Post mechanism, customers will be presented with the option of paying using their UnionPay card instead of a Visa/MasterCard/American Express.

UnionPay card details cannot be collected on your website, so the card details fields disappear when your customer selects this option. When the customer continues to the next page, they’ll be redirected to a checkout page hosted by NAB to collect the details before forwarding back to your website upon completion.WooCommerce NAB Transact Direct Post

Testing details

To test payments using test details, use the following credit card details:

Card number: 4444333322221111
Expiry: Any date after today
CVV: 123

Important: Test transactions will only be successful if the total amount ends in .00 or .08 — other amounts will fail with an error of: “Unfortunately your order cannot be processed as the originating bank/merchant has declined your transaction. Please attempt your purchase again.”WooCommerce NAB Transact Direct Post

Troubleshooting

I get an error: Invalid Fingerprint

This is usually caused by incorrect merchant ID and/or password in the plugin settings. These details should will be different from the credentials you use to log into the NAB Transact portal. NAB can provide the correct transaction merchant ID and password.WooCommerce NAB Transact Direct Post

If you’re getting this error in Test Mode, but the same credentials work in Live Mode, your account might not support Test Mode. Contact NAB for testing credentials for your account.

I get a blank/white screen instead of the Thank You page.

This is usually because the return URL that NAB redirects to is very long (it has a lot of data in the query string). You either have a security plugin that is limiting the length of URL strings, or your web host is doing the same. Either disable that option in your plugin or speak to your host about lifting that security control.WooCommerce NAB Transact Direct Post

Does this NAB Transact gateway support refunds?

Yes, as of version 2.0.0 this gateway supports partial and full refunds.

Does this NAB Transact gateway support subscriptions?

Yes, it does.

Does this NAB Transact gateway support preauthorizations?

Yes, it does. After successful checkout the order will have a status of On Hold. When you change this order to Processing or Completed the payment will be captured automatically. Always confirm the payment was successful in the order notes.WooCommerce NAB Transact Direct Post