{"title":"PayWay","slug":"payway-payment-provider","url":"https://support.storeconnect.com/articles/payway-payment-provider","url_markdown":"https://support.storeconnect.com/articles/payway-payment-provider.md","subtitle":null,"summary":"Configure PayWay (Westpac Online Pay) for checkout payments in StoreConnect, including optional 3D Secure 2 authentication for enhanced fraud protection and liability shift.","type":"Help_Documentation","video_url":"","keywords":"payway, westpac, westpac online pay, payment gateway, payment provider, api key, 3d secure, 3ds2, 3d secure 2, checkout payments, merchant account, australian payment gateway, sandbox mode, production mode, payment integration, threeds_contract_id, device fingerprinting, liability shift","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"PayWay (also known as Westpac Online Pay) is a Westpac payment gateway for Australian businesses. If you use PayWay, you can integrate it directly with StoreConnect.\n\nPayWay supports standard checkout payments with optional 3D Secure 2 (3DS2) authentication.\n\n## What you need\n\n-   A [PayWay merchant account](https://www.payway.com.au)\n-   A publishable API key and secret API key from your PayWay portal\n-   Your merchant account ID (for production)\n-   A 3DS contract ID from PayWay (if enabling 3DS2)\n\n## Step 1: Get your PayWay API keys\n\n1.  Sign in to your [PayWay merchant portal](https://www.payway.com.au).\n2.  Go to **Settings \u003e REST API Keys**.\n3.  Copy your **Publishable API key** and **Secret API key**.\n\nSee the [PayWay REST API documentation](https://www.payway.com.au/docs/rest.html) for more detail on API keys and authentication.\n\n## Step 2: Configure PayWay as a payment provider in StoreConnect\n\n1.  In StoreConnect, go to the **Payment Providers** list and select **New**.\n2.  Enter the payment provider details as follows, then select **Save**.\n\n| StoreConnect field | Value                     |\n|--------------------|---------------------------|\n| Provider           | PayWay                    |\n| API Mode           | `sandbox` or `production` |\n| API Key            | Publishable API key       |\n| API Secret         | Secret API key            |\n| API Options        | Use for 3DS2 (see below)  |\n\n## Step 3: Set your merchant account ID (production only)\n\nIn production mode, add your merchant account ID to the **API Options** field:\n\n```\nmerchant_account: \"YOUR_MERCHANT_ACCOUNT_ID\"\n```\n\nIn sandbox mode this is not required — StoreConnect automatically uses the PayWay test merchant account.\n\n## Enable 3D Secure 2 (3DS2)\n\n3DS2 is an opt-in feature that adds an authentication step to card payments. When enabled, the checkout performs device fingerprinting, a 3DS lookup, and presents an in-page challenge if required by the card issuer. Passing 3DS2 shifts chargeback liability for eligible transactions to the card issuer.\n\n3DS2 authentication applies to initial purchases, additional payments, and subscription billing.\n\nTo enable 3DS2, add the following to the **API Options** field:\n\n```\nthree_d_secure: true\nthreeds_contract_id: \"YOUR_3DS_CONTRACT_ID\"\n```\n\nObtain your 3DS contract ID from PayWay. Contact your Westpac relationship manager or the [PayWay support team](https://www.payway.com.au) if you do not have one.\n\nA full production configuration with merchant account and 3DS2 enabled:\n\n```\nmerchant_account: \"YOUR_MERCHANT_ACCOUNT_ID\"\nthree_d_secure: true\nthreeds_contract_id: \"YOUR_3DS_CONTRACT_ID\"\n```\n\n## Payment error messages\n\nWhen a card payment is declined, the specific error message returned by PayWay is displayed on the checkout form. This allows customers to understand the reason for the decline — for example, an incorrect card number or insufficient funds — without needing to contact support."}