API Fields

Do not use the following characters: < > $ % ^ * _ = [ ] \ { } | ; ~ ` Using these characters may result in data validation errors.

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:

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. Each item field is 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.

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