Create Requests :

Follow these steps to create and configure a request for an ISO Hostbox:

  1. Select the ISO format Collection in Hostbox. Hover over it or click the three-dot menu, then choose New Request to open the Create Request dialog.
  2. Enter a label for the request and click Save.
  3. Once the request is created, click on the collection to view the newly created request.
  4. Click on the request to select it—the URL Input Box will display the dynamically generated URL.
  5. Choose the appropriate method for the request.
  6. Enter the required details, such as body, rules, and other parameters.
  7. Click Save to store the request.
  8. After saving, click the Start button to launch the Hostbox server.
  • PORT is dynamically assigned to ISO requests.

Explore the various features and functionalities available within the ISO Hostbox to effectively simulate and test your ISO-related applications and integrations.

Example :

We have created an ISO collection named Transaction and within this collection we will simulate a Transaction request named UPI_Debit which request & response body data is shown below :

// Request Body
<isomsg>
  <header/>
  <field id="0" value="0200"/>
  <!-- MTI (Message Type Identifier) for request -->
  <field id="2" value="9876543210987654321"/>
  <!-- Primary Account Number (PAN) -->
  <field id="3" value="310000"/>
  <!-- Processing Code: 310000 for UPI Debit -->
  <field id="4" value="000000010000"/>
  <!-- Transaction Amount: 100.00 (amount in cents) -->
  <field id="7" value="2503221123"/>
  <!-- Transmission Date & Time (YYMMDDhhmmss) -->
  <field id="11" value="123456"/>
  <!-- Systems Trace Audit Number (STAN) -->
  <field id="12" value="012345"/>
  <!-- Time, Local Transaction (hhmmss) -->
  <field id="13" value="2503"/>
  <!-- Date, Local Transaction (MMDD) -->
  <field id="41" value="12345678"/>
  <!-- Terminal Identification -->
  <field id="43" value="UPIAPP"/>
  <!-- Application Name -->
</isomsg>

// Response Body
<isomsg>
  <header/>
  <field id="0" value="0210"/>
  <!-- MTI (Message Type Identifier) for response -->
  <field id="2" value="9876543210987654321"/>
  <!-- Primary Account Number (PAN) -->
  <field id="4" value="000000010000"/>
  <!-- Transaction Amount: 100.00 (amount in cents) -->
  <field id="11" value="123456"/>
  <!-- Systems Trace Audit Number (STAN) -->
  <field id="39" value="00"/>
  <!-- Response Code: 00 (Approved) -->
  <field id="43" value="UPIAPP"/>
  <!-- Application Name -->
</isomsg>

Execute ISO Request

To test/ececute an ISO request:

  1. Copy the URL & Port of the desired ISO request within the Hostbox.
  2. Go to the API module and Paste the Hostbox request's URL.
  3. Provide any required data (body, method).
  4. Send the request.
  5. Compare the actual response to the expected response.
  • Make sure to start the Hostbox after simulating a request or any changes in it.
  • User can also create Collections and organize the simulated requests in API module for future uses.
  • Now follow above steps and execute this above simulated request in API module. User will get simulated response body as response after request execution.

By following these steps, you can create and execute ISO requests within the Hostbox, enabling you to test and validate your ISO-based integrations effectively.