---- dataentry gateway ----
type            : gateway         # do not change this line

# Add the full name of the gateway after the colon below.
name            : Westpac PayWay

# Supported Countries. Please use 2-character ISO Country Codes available at
# http://www.iso.org/iso/english_country_names_and_code_elements
# Separate multiple country codes by commas.
countries       : AU, NZ

# Enter the FoxyCart versions where support was added or removed (if applicable).
# Version numbers should include applicable decimals, such as "0.7.0" and not "070"
support-added   : 0.7.2
support-removed : 

# Features and Details
auth-net-emulation : no # enter "yes" or "no" (without quotes)
supports-3dsecure  : no # enter "yes" or "no" (without quotes)
supports-multicurrency  : yes # enter "yes" or "no" (without quotes)

# Gateway URL
gateway_url     : https://www.payway.com.au/
----


====== Westpac PayWay ======

===== Setting Up Westpac Payway for FoxyCart =====
You will need to add FoxyCart's IP's to Westpac's API Security Access List as shown on the screenshot below, from the "Settings" section of the PayWay administration, accessible from the "cog" icon for your username in the top bar navigation.

On the Settings page, click the "PayWay Classic API" link within the "Modules" panel, and then click the "Security" section in the left sidebar navigation. Add the following IP's to this section:

    * **IP:** ''54.243.60.3''
    * **IP:** ''54.152.220.165''

{{ :gateways:westpac_security.png?nolink&600 |}}

You will also need to download the certificate for your PayWay account, found from the "Certificate" page, also within the "PayWay Classic API" section of the navigation. Select "PHP" from the "API Technology" dropdown and hit "Go", and then click the "Download PHP Certificate" link within the text that appears below.

{{ :gateways:westpac_certificate.png?nolink&600 |}}

Once you have your certificate downloaded, you're ready to connect your PayWay account to your FoxyCart store:

  - Login to your store's FoxyCart administration, and go to the "Payments" section
  - From the "Let customers pay with a Credit or Debit Card" option, select "Westpac Payway"
  - From the "Security" section of your PayWay administration (found within the "PayWay Classic API" section of the navigation), copy the "Customer Username" and "Customer Password" into the fields of the same name within the FoxyCart administration
  - For the "merchant id" field, enter the value your Westpac PayWay representative provided to you when taking your account live
  - Click on the "certificate" field, and then click on the upload button that appears. Select the certificate file you just downloaded
  - Save the payment settings

At this point - your PayWay account should be connected to your FoxyCart store! We'd recommend placing a test transaction to ensure everything is working correctly, and void/refund the charge within your PayWay account.

===== Testing =====
==== Obtaining a Test Account ====

You can sign up for a test account from [[https://www.payway.com.au/core/DeveloperTestFacilityView|this page]]. When creating the account, ensure that you select the option "My system meets PCI-DSS compliance for storing credit card numbers" for the "PCI-DSS" question.

Once logged in, you can then follow the steps above to connect your test account to your FoxyCart store. You'll want to ensure your store's payment settings are set to "Test Servers", and for the merchant ID value in your FoxyCart gateway settings, you will simply use ''TEST''.

==== Test Card Numbers ====
<wrap tip>When using the test merchant, only the card numbers in the table below are valid. All other card numbers will return a response of “42 No Universal Account”.</wrap>

Each card number will return a specific response as detailed in the table, so if you want to test a card which has low funds, you would use card number 4564710000000020 with an amount higher than $10. Note that if you enter an incorrect expiry date for one of the test cards, you will get a response of 54. If you enter an incorrect CVN, you will get a response of 01 or 05 depending on the card type.

^ Card Number ^ Expiry ^ CVN ^ Response ^ Description ^
| ''4564710000000004'' | ''02/19'' | ''847'' | ''08'' | ''Visa Approved'' |
| ''5163200000000008'' | ''08/20'' | ''070'' | ''08'' | ''MC Approved'' |
| ''4564710000000012'' | ''02/05'' | ''963'' | ''54'' | ''Visa Expired'' |
| ''4564710000000020'' | ''05/20'' | ''234'' | ''51'' | ''Visa Low Funds ($10 credit limit)'' |
| ''5163200000000016'' | ''12/19'' | ''728'' | ''04'' | ''MC Stolen'' |
| ''4564720000000037'' | ''09/19'' | ''030'' | ''05'' | ''Visa invalid CVV2'' |
| ''376000000000006'' | ''06/20'' | ''2349'' | ''08'' | ''Amex'' |
| ''343400000000016'' | ''01/19'' | ''9023'' | ''62'' | ''Amex Restricted'' |
| ''36430000000007'' | ''06/22'' | ''348'' | ''08'' | ''Diners'' |
| ''36430000000015'' | ''08/21'' | ''988'' | ''43'' | ''Diners Stolen'' |
===== Troubleshooting & Interpreting Response Codes =====
Contact westpac for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>



===== Important Notes and Caveats =====



===== User Notes and Experiences =====
<wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page.