Response

When the App receives a webview response, it must guide the customer to the start address URL provided in the response. The App should actively monitor the webview's progress as the transaction continues.

Once the webview reaches the close address URL, the App should automatically close the webview, signaling that the transaction process has concluded. After closing the webview, the App can proceed with any necessary post-transaction steps, such as confirming payment status or providing the customer with a receipt.

<?xml version="1.0" encoding="UTF-8"?>
<mobile>
  <webview>
    <start>URL the customer must be directed to</start>
    <close>URL that marks the end of the process</close>
    <abort>URL that marks an error during the process</abort>
    <code>Transaction code used in completing the request</code>
  </webview>
</mobile>

To complete the transaction, the App must now make a second request to the gateway. This request includes will trigger the final authorisation stage of the transaction, and return the authorisation response. The request must be sent to:

https://secure.telr.com/gateway/mobile_complete.xml

Request layout for transaction completion

<?xml version="1.0" encoding="UTF-8"?>
<mobile>
  <store>Store ID</store>
  <key>Authentication Key</key>
  <complete>Transaction code obtained in the WebView response</complete>
</mobile>

If the App detects an error during the webview process or if the webview reaches the URL provided as the abort address, it should immediately close the webview. Following this, the App must send an abort request to the payment gateway using the specified URL for abort actions.

This ensures that the transaction is properly canceled and no unintended processing occurs. The abort request URL will be provided as part of your integration documentation, and all communication should follow the required format for such requests.

Request layout for transaction abort

<?xml version="1.0" encoding="UTF-8"?>
<mobile>
  <store>Store ID</store>
  <key>Authentication Key</key>
  <abort>Transaction code obtained in the WebView response</abort>
</mobile>