Home > API Fields > Reply Fields


Reply Fields

 

Because CyberSource can add reply fields and reason codes at any time:

nYou must parse the reply data according to the names of the fields instead of the field order in the reply. For more information about parsing reply fields, see the documentation for your client.

nYour error handler should be able to process new reason codes without problems.

nYour error handler should use the decision field to determine the result if it receives a reply flag that it does not recognize.

 

Your payment processor can include API reply fields that are not documented in this guide. See Credit Card Services Using the Simple Order API for detailed descriptions of additional API reply fields.

Table 3Reply Fields

Field

Description

Returned By

Data Type & Length

ccAuthReply_amount

Amount that was authorized.

 

ccAuthReply

String (15)

ccAuthReply_authorizationCode

Authorization code. Returned only when the processor returns this value.

 

ccAuthReply

String (7)

ccAuthReply_authorizedDateTime

Time of authorization.

ccAuthReply

Date and time (20)

ccAuthReply_avsCode

AVS results. See Credit Card Services Using the Simple Order API for a detailed list of AVS codes.

ccAuthReply

String (1)

ccAuthReply_avsCodeRaw

AVS result code sent directly from the processor. Returned only when the processor returns this value.

 

ccAuthReply

String (10)

ccAuthReply_cvCode

CVN result code. See Credit Card Services Using the Simple Order API for a detailed list of CVN codes.

ccAuthReply

String (1)

ccAuthReply_cvCodeRaw

CVN result code sent directly from the processor. Returned only when the processor returns this value.

ccAuthReply

String (10)

ccAuthReply_processorResponse

For most processors, this is the error message sent directly from the bank. Returned only when the processor returns this value.

ccAuthReply

String (10)

ccAuthReply_reasonCode

Numeric value corresponding to the result of the credit card authorization request. See Credit Card Services Using the Simple Order API for a detailed list of reason codes.

ccAuthReply

Integer (5)

ccAuthReply_reconciliationID

Reference number for the transaction. This value is not returned for all processors.

ccAuthReply

String (60)

decision

Summarizes the result of the overall request. Possible values:

nACCEPT

nERROR

nREJECT

nREVIEW: Returned only when you use CyberSource Decision Manager.

ccAuthReply

String (6)

invalidField_0...N

Fields in the request that contained invalid data.

For information about missing or invalid fields, see Getting Started with CyberSource Advanced for the Simple Order API.

ccAuthReply

String (100)

merchantReferenceCode

Order reference or tracking number that you provided in the request. If you included multi-byte characters in this field in the request, the returned value might include corrupted characters.

ccAuthReply

String (50)

missingField_0...N

Required fields that were missing from the request.

For information about missing or invalid fields, see Getting Started with CyberSource Advanced for the Simple Order API.

ccAuthReply

String (100)

purchaseTotals_currency

Currency used for the order. For the possible values, see the ISO Standard Currency Codes.

ccAuthReply

String (5)

reasonCode

Numeric value corresponding to the result of the overall request. See Credit Card Services Using the Simple Order API for a detailed list of reason codes.

ccAuthReply

Integer (5)

requestID

Identifier for the request.

 

ccAuthReply

String (26)

requestToken

Request token data created by CyberSource for each reply. The field is an encoded string that contains no confidential information such as an account or card verification number. The string can contain a maximum of 256 characters.

ccAuthReply

String (256)