Home > API Fields


API Fields

This appendix describes the SCMP (Simple Commerce Message Protocol) API fields that you can use to access Cybersource Payer Authentication services. SCMP API is a legacy name-value pair API that is supported for merchants who have already implemented it. If you are new to Cybersource and want to connect to services, use the Simple Order API.

Formatting Restrictions

Unless otherwise noted, all fields are order and case insensitive and the fields accept special characters such as @, #, and %.

 

Request-level and offer-level field names and values must not contain carets (^) or colons (:). However, they can contain embedded spaces and any other printable characters. If you use more than one consecutive space, the extra spaces will be removed.

For Atos, the bill_ fields must not contain colons (:).

Data Type Definitions

Table 20 Data Type Definitions

Data Type

Description

Date and time

The format is YYYY-MM-DDThhmmssZ. For example, 2018-08-11T224757Z is equal to August 11, 2018, at 10:47:57 P.M. The T separate the date and the time. The Z indicates Coordinated Universal Time (UTC), which is also known as Greenwich Mean Time.

Decimal

Number that includes a decimal point. Examples: 23.45, -0.1, 4.0, 90809.0468.

Integer

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

Nonnegative integer

Whole number greater than or equal to zero {0, 1, 2, 3, …}.

Positive integer

Whole number greater than zero {1, 2, 3, …}.

String

Sequence of letters, numbers, spaces, and special characters, such as @ and #.