How to Set Up the NAB Payment Gateway (Unified Checkout)

Step

Action

Details

✅

1

Contact NAB

To sign up for the NAB Unified Checkout (UNC) Payment Gateway, you must initially complete the 'NAB Merchant Establishment Form' and submit it to the National Australia Bank (NAB) (full instructions are on this form).

Click on the following link to access the NAB Gateway Merchant Establishment Form.pdf

Account Payment Merchant ID: ____________________________

Events & Payments Merchant ID: ___________________________

Extra Curricular Merchant ID: ______________________________

Commercial Debtors Merchant ID: _________________________

🔲

2

Check your School’s Network Configurations

Ask your System Administrator to review your school’s network configurations listed below. These setups are mandatory for integration with the NAB Unified Checkout Payment Gateway:

• Proxy and Firewall must allow the outbound and inbound HTTPS connections required by your banking provider.

• Ensure proxy does not cache the 'Payment Notification' page.

• The TASS.web web server must have installed a valid SSL certificate chain issued by a trusted Certificate Authority (CA). This includes a correctly installed Web Server and Intermediate CA certificates, tested via an SSL provider online application.

For more information on these requirements, please call the NAB Gateway Support Centre on 1300 369 852.

🔲

3

Log in to the NAB Gateway

Log into the NAB Gateway using your NAB issued ‘Merchant ID' (also known as 'Organization ID'), 'Username', and 'Password’.

If you do not have these details, contact the NAB Gateway Support Centre on 1300 369 852.

🔲

4

Set up surcharges in the NAB Gateway and TASS.web

This step is optional. You only need to complete it if you plan to add surcharges to transactions processed through your payment gateway (e.g., card processing fees or transaction fees).

Go to the NAB Gateway, navigate to Payment Configuration > Differential Fee and configure your surcharging rules. Add rules for any surcharges that will be automatically applied when parents/customers make payments through the Payment Gateway, then ‘Save’. Complete this for each Merchant ID/TASS product that you are setting up.

See the ‘Enable surcharges in NAB Gateway' article on the NAB website for more information.

Then, go to TASS.web Finance > Parent Accounts > Setup Information > Parent Accounts Setup. On the ‘GL Integration’ tab, verify that the ‘Surcharge Account’ field specifies the account in the General Ledger designated for surcharges from online payments processed through Parent Lounge Account Payment, Extra Curricular and Events & Payments.

This ‘Surcharge Account’ is used exclusively for online payments made within the Account Payment, Extra Curricular and Events & Payments programs.

You can apply surcharges for Commercial Debtors through your banking portal, but remember that the amount received will not be recorded in a separate GL Account, so this must be tracked separately.

The Differential Fees entered in the NAB Portal may take 24 hours to update. Consider this before completing Step 6 and setting up the Payment Gateway in TASS.web.

 🔲

5

Generate a Key and Shared Secret for each Merchant ID.

Go to the NAB Gateway, and navigate to Payment Configuration > Key Management.

Generate a new ‘Key’ and ‘Shared Secret’ for each Merchant ID by creating a new key and clicking the ‘Generate Key’ option.

Account Payment

Shared Secret: ___________________________________________

Key: _______________________________________________________

Events & Payments

Shared Secret: ____________________________________________

Key: _______________________________________________________

Extra Curricular

Shared Secret: ___________________________________________

Key: ______________________________________________________

Commercial Debtors

Shared Secret: ___________________________________________

Key: ______________________________________________________

🔲

6

Set up the Payment Gateway in TASS.web.

Go to TASS.web System Admin > Utilities > API Maintenance. On the ‘External APIs’ tab, click 'View' in the Payment Gateways Action column.

If a Payment Gateway is already configured for the TASS Product, click ‘Edit’ next to the relevant 'TASS Product' to display the 'Payment Gateway Parameters' screen.

OR

To add a new Payment Gateway for a TASS Product, click 'New Payment Gateway' to display a blank 'Payment Gateway Parameters' screen.

Fields that require further explanation
* TASS Product	Select the 'TASS Product' you want to set up the Payment Gateway for. Payment Gateways can be set up for: Account Payments in Parent Lounge. Events & Payments in Parent Lounge. Extra Curricular pay at sign-up in Parent Lounge. Commercial Debtors (CD) Online Payment Portal.
* Payment Gateway Provider	Select 'NAB Gateway'.
* Solution Type	Select ‘Unified Checkout’. ‘iFrame/Lightbox’ is the old NAB Payment Gateway Solution.
* Merchant ID	Enter the 'Merchant ID' provided by NAB. ❗ Each TASS Product requires a unique Merchant ID. Enter the correct Merchant ID for the TASS Product you have selected above.
Username	Leave blank.
Password	Leave blank.
Biller Code	Leave blank.
* Shared Secret	Enter the ‘Shared Secret’ from Step 4 above.
* Key	Enter the ‘Key’ from Step 4 above.

🔲

7

Test your Payment Gateway

Go to TASS.web System Admin > Utilities > API Maintenance. On the ‘External APIs’ tab, click 'View' in the Payment Gateways Action column.

To test your Payment Gateway connection, click the ‘Test' link in the relevant ‘TASS Product' Action column. The 'Payment Gateway Providers' pop-up will display the following information:

Connect To Gateway	This verifies that the communication to the NAB server is working. A ‘Passed’ status indicates that the gateway is operating as expected.
Request Session	This verifies that the communication back from the NAB server is working. A ‘Passed’ status indicates that the gateway is operating as expected.

🔲

8

Set up your preferred Payment Options in the NAB Gateway

This step is optional. You only need to complete it if you want to accept payment options other than the default options of Visa, Mastercard, and American Express.

To configure the NAB Gateway to accept other payment options, such as Apple Pay, Samsung Pay, Google Pay, and Visa Click to Pay, log into the NAB Gateway and go to Payment Configuration > Digital Payment Solutions. Then, activate and configure your digital payments solutions.

See the ‘NAB Gateway digital wallets' article on the NAB website for more information.

You may need to complete a registration process for each new payment option. For support, contact the NAB Gateway Support Centre at 1300 369 852.

🔲

9

Complete the remaining steps from the relevant Payment Gateway Checklist

The remaining setup steps are dependent upon which payment gateway portal you have configured:

• For Parent Lounge Payment Gateway configurations (Account Payment, Events & Payments, Extra Curricular), go to Step 6 of the ‘Online Payments in Parent Lounge Checklist’.

• For the Commercial Debtors Online Payments Portal Payment Gateway, go to Step 7 of the ‘Commercial Debtors Online Payments Portal Checklist’.

🔲