Numbered Elements

 

The Cybersource XML schema includes several numbered elements. You can include these complex elements more than once in a request. For example, when a customer order includes more than one item, you must include multiple <item> elements in your request. Each item is numbered, starting with 0. The XML schema uses an id attribute in the item’s opening tag to indicate the number. For example:

<item id="0">

As a name-value pair field name, this tag is called item_0. In this portion of the field name, the underscore before the number does not indicate hierarchy in the XML schema. The item fields are generically referred to as item_#_<element name> in the documentation.

Below is an example of the numbered <item> element and the corresponding name-value pair field names. If you are using the Simple Object Access Protocol (SOAP), the client contains a corresponding Item class.

Example 5Numbered XML Schema Element Names and
Name-Value Pair Field Names

XML Schema
Element Names

Corresponding Name-Value Pair Field Names

<item id="0">
  <unitPrice>
  <quantity>
</item>


item_0_unitPrice
item_0_quantity

<item id="1">
  <unitPrice>
  <quantity>
</item>


item_1_unitPrice
item_1_quantity

 

When a request in XML format includes an <item> element, the element must include an id attribute. For example: <item id="0">.