API Fields

Formatting Restrictions

Unless otherwise noted, all field names are case sensitive and all fields accept special characters such as @, #, and %.

 

The values of the item_#_ fields must not contain carets (^) or colons (:) because these characters are reserved for use by the Cybersource services.

Values for request-level and item-level fields must not contain new lines or carriage returns. However, they can contain embedded spaces and any other printable characters. Cybersource removes all leading and trailing spaces.

TeleCheck

Request fields must not contain ampersands (&).

Data Type Definitions

 

For more information about these data types, see the World Wide Web Consortium (W3C) XML Schema Part 2: Datatypes Second Edition.

Table 11Data Type Definitions

Data Type

Description

Date and time

Format is YYYY-MM-DDThh:mm:ssZ, where:

nT separates the date and the time

nZ indicates Coordinated Universal Time (UTC), also known as Greenwich Mean Time (GMT)

Example  2020-01-11T22:47:57Z equals January 11, 2020, at 22:47:57 (10:47:57 p.m.).

Integer

Whole number {..., -3, -2, -1, 0, 1, 2, 3, ...}

String

Sequence of letters, numbers, spaces, and special characters