Need help?

Request layout

<?xml version="1.0" encoding="UTF-8"?>
<remote>
  <store>Store ID</store>
  <key>Authentication Key</key>
  <tran>
    <type>Transaction type</type>
    <class>Transaction class</class>
    <cartid>Transaction cart ID</cartid>
    <description>Transaction description</description>
    <test>Test mode</test>
    <currency>Transaction currency</currency>
    <amount>Transaction amount</amount>
    <ref>Previous transaction reference</ref>
  </tran>
  <card>
    <number>Card number</number>
    <expiry>
    <month>Expiry date - month</month>
    <year>Expiry date - year</year>
    </expiry>
    <cvv>CVV</cvv>
  </card>
  <billing>
    <name>
      <title>Title</title>
      <first>Forenames</first>
      <last>Surname</last>
    </name>
    <address>
      <line1>Street address – line 1</line1>
      <line2>Street address – line 2</line2>
      <line3>Street address – line 3</line3>
      <city>City</city>
      <region>Region</region>
      <country>Country</country>
      <zip>Zip/Area/Postcode</zip>
    </address>
    <email>Email address</email>
    <ip>IP address</ip>
  </billing>
</remote>

To include the delivery details, add a …. section as follows

<?xml version="1.0" encoding="UTF-8"?>
<remote>
  <store>Store ID</store>
  <key>Authentication Key</key>
  <tran>
  ....
  </tran>
  <card>
  ....
  </card>
  <billing>
  ....
  </billing>
  <delivery>
    <name>
      <title>Title</title>
      <first>Forenames</first>
      <last>Surname</last>
    </name>
    <address>
      <line1>Street address – line 1</line1>
      <line2>Street address – line 2</line2>
      <line3>Street address – line 3</line3>
      <city>City</city>
      <region>Region</region>
      <country>Country</country>
      <zip>Zip/Area/Postcode</zip>
    </address>
  </delivery>
</remote>

To include the extra data fields, add a …. field as follows:

<?xml version="1.0" encoding="UTF-8"?>
<remote>
  <store>Store ID</store>
  <password>Store password</password>  
  <tran>
  ....
  </tran>
  <card>
  ....
  </card>
  <billing>
  ....
  </billing>
  <extra>
    <val1>data for xtra_val1</val1>
    <acnum>data for xtra_acnum</acnum>
    ....
  </extra>
</remote>

To convert the ‘xtraname’ format to xml, simply remove the ‘xtra’ part and include the remainder inside the section.

You can include both delivery and extra data sections if required.