eWAY API


Hosted Payment Solution

The eWAY Hosted Payment solution allows your customers' to be redirected to a secure eWAY payment page to enter their details in securely. Customers will enter their credit card details and finalise their payment before being returned to your website. This method provides a complete PCI-DSS compliant payment solution, while still allowing you to modify it to be customised design.

We provide you with an API, HTML code and testing environment to integrate the eWAY Hosted Payment solution.

The gateway URL is:
Payment Request: https://nz.ewaygateway.com/Request
Payment Result: https://nz.ewaygateway.com/Result


For specification information please see the Hosted Payment Solution Document

You can link with any of the following languages that support HTML FORMS using the POST method. If there are any other solutions required, please contact us.

You can build and test your site to link to eWAY before you have joined. All you need to do is pass the required test account information. This uses the real payment page so there is little changes required once you have joined eWAY.

In order to test the Hosted Payment solution you will need to pass the following information:

The gateway URL is:
Payment Request: https://nz.ewaygateway.com/Request
Payment Result: https://nz.ewaygateway.com/Result

Note: Your eWAYCustomerID is emailed to you in your "eWAY Welcome Letter"  when you join eWAY.

A successful transaction returns (Example):

<TransactionResponse>
<AuthCode>315153</AuthCode>
<ResponseCode>00</ResponseCode>
<ReturnAmount>10.00</ReturnAmount>
<TrxnNumber>1005039</TrxnNumber>
<TrxnStatus>true</TrxnStatus>
<TrxnResponseMessage>AUTH CODE:315153</TrxnResponseMessage>
<MerchantOption1>Option1</MerchantOption1>
<MerchantOption2>Option2</MerchantOption2>
<MerchantOption3>Option3</MerchantOption3>
<MerchantReference>513456</MerchantReference>
<MerchantInvoice>Inv 21540</MerchantInvoice>
<ErrorMessage />
</TransactionResponse>

While a failed transaction returns:

<TransactionResponse>
<AuthCode></AuthCode>
<ResponseCode>05</ResponseCode>
<ReturnAmount>10.00</ReturnAmount>
<TrxnNumber>1005040</TrxnNumber>
<TrxnStatus>false</TrxnStatus>
<TrxnResponseMessage>Do Not Honour</TrxnResponseMessage>
<MerchantOption1>Option1</MerchantOption1>
<MerchantOption2>Option2</MerchantOption2>
<MerchantOption3>Option3</MerchantOption3>
<MerchantReference>513456</MerchantReference>
<MerchantInvoice>Inv 21540</MerchantInvoice>
<ErrorMessage />
</TransactionResponse>

Please make sure you pass your eWAY Customer ID or the eWAY Test ID of "87654321" ONLY - passing any other ID may result in funds being deposited into another bank account other than your own.