Create Requests

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

  1. Select the ISO format Collection in Sandbox. 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 Sandbox server.
  • PORT is dynamically assigned to ISO requests.

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

Example :

We have created an ISO collection named Acquiring_Platform_POS and within this collection we will simulate a Card Authorization request named Auth_0100_0110. The request & response body data is shown below:

// Request Body
<isomsg>
  <header/>
  <field id="0" value="0100"/>
  <!-- MTI (Message Type Identifier) for Authorization request -->
  <field id="3" value="210000"/>
  <!-- Processing Code: 210000 for Card Authorization -->
  <field id="4" value="000000002000"/>
  <!-- Transaction Amount: 20.00 (amount in cents) -->
  <field id="22" value="801"/>
  <!-- POS Entry Mode -->
  <field id="43" value="Cranium"/>
  <!-- Card Acceptor Name/Location -->
  <field id="49" value="826"/>
  <!-- Transaction Currency Code (826 = GBP) -->
  <field id="61" value="1651412110"/>
  <!-- Reserved Private -->
</isomsg>

// Response Body
<isomsg>
  <header/>
  <field id="0" value="0110"/>
  <!-- MTI (Message Type Identifier) for Authorization response -->
  <field id="3" value="{{$echo()}}"/>
  <!-- Echoes the request's Processing Code -->
  <field id="4" value="{{$echo()}}"/>
  <!-- Echoes the request's Transaction Amount -->
  <field id="22" value="{{$echo()}}"/>
  <!-- Echoes the request's POS Entry Mode -->
  <field id="35" value="{{$echo()}}"/>
  <!-- Track 2 Data -->
  <field id="38" value="008001"/>
  <!-- Authorization Identification Response -->
  <field id="39" value="00"/>
  <!-- Response Code: 00 (Approved) -->
  <field id="43" value="{{$echo()}}"/>
  <!-- Echoes the request's Card Acceptor Name -->
  <field id="49" value="{{$echo()}}"/>
  <!-- Echoes the request's Currency Code -->
  <field id="61" value="{{$echo()}}"/>
  <!-- Echoes the request's Reserved Private field -->
</isomsg>
  • The {{$echo()}} function in a response field automatically returns the same value sent in the corresponding request field, making it easy to mirror request data back in the response without hardcoding values.

Execute ISO Request

To test/ececute an ISO request:

  1. Copy the URL & Port of the desired ISO request within the Sandbox.
  2. Go to the Studio module and Paste the Sandbox 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 Sandbox after simulating a request or any changes in it.
  • User can also create Collections and organize the simulated requests in Studio module for future uses.
  • Now follow above steps and execute this above simulated request in Studio 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 Sandbox, enabling you to test and validate your ISO-based integrations effectively.