Help Center

Menu

Westpac PayWay payment gateway

The Westpac PayWay payment gateway asset allows you to create an ecommerce payment integration between Matrix and the Westpac PayWay system. This integration allows users to make payments by credit card in a secure way.

PayWay Gateway diagram

To use this payment gateway, you will need an account at the Westpac PayWay website with the PayWay Net module enabled on your account. You can also create a testing account using the PayWay Test Facility to test your payment gateway implementation in Matrix.

Additional dependant assets

When you create a PayWay payment gateway, the display format and bodycopy assets are automatically created beneath it. You can use this bodycopy to define the contents and layout of the payment and cardholder verification forms.

Details screen

Account details

This section allows you to enter your account and integration details, allowing you to connect Matrix with the payment gateway.

Merchant ID

The merchant ID of the PayWay account. If you are using the PayWay test facility to test the integration, you can enter test into this field.

Publishable key

The publishable key of the PayWay account.

Secret key

The secret key of the PayWay account. To find the publishable key and secret key values within the PayWay admin portal, follow these steps:

  1. Click on REST API in the left column menu.

  2. Click on REST API keys.

    You should see two rows on this page, one with the access type of PUBLISHABLE and one that has SECRET.

    westpac keys

  3. Click on each of these API keys to reveal the full key value.

  4. Copy and paste the keys into the payment gateway screen in Matrix.

Test connection

This section allows you to test the connection between your Matrix instance and the PayWay API endpoint.

Once you have filled out and saved the account details, you can click on the Test connection button to test the integration connection. If the connection is successful, you should see a message similar to this:

test connection example

Pass-through variables

This section allows you to source additional values to pass-through to the payment gateway from the ecommerce asset to which you are connecting the gateway. These keys must be configured on the Ecommerce rules screen of the Ecommerce form page.

The only field that is available here is:

Customer number variable name

The PayWay customer number against which the payment should be made.

Interface options

This section allows you to change the wording of the buttons for the payment gateway.

Submit Button Text

The text to display as the Submit (pay) button.

Cancel button text

The text to display as the Cancel button.

Display formatting screen

The Display formatting screen allows you to edit the display format bodycopy. The display format bodycopy is used to define the layout of the PayWay payment gateway page.

A list of keyword replacements is provided in the toolbar on the Edit contents screen of the display format bodycopy. The following keyword replacements are unique to the PayWay payment gateway:

%payway_form%

This will print the required code, which will generate the PayWay credit card entry form. This code will generate an iframe that holds the form fields and accepts the user input.

%payway_js%

Prints the required inline javascript that powers the PayWay payment iframe form.

%customer_number%

Prints an input field that allows the user to manually input their PayWay customer number.