Requesting Captures and Credits with Level III Data

To include Level III data in a capture or credit request:

Step 1

Authorize a credit card payment.

CyberSource recommends that for Level III transactions you include the total order amount in the authorization request, even though it is not required. Doing so ensures that CyberSource uses your total order amount and that the capture or credit request total amount matches the original authorization total amount. The field to use in the authorization request is purchaseTotals_grandTotalAmount.

Step 2

Capture the authorization.

Include the following information in the capture request:

■	Level II and Level III data: see the chapter in this document for the processor you are using. Also see Using Decimals and Strings.

■	Purchasing level field: the field name is ccCaptureService_purchasingLevel. Set this field to 3 to indicate that the request includes Level III data.

■	Basic fields required for every capture request.

For more information, see the Credit Card Services User Guide.

Step 3

For all processors except CyberSource through VisaNet, check the capture reply message.

The reply message includes a field that indicates whether CyberSource sent the Level III information to the processor. The field name is ccCaptureReply_purchasingLevel3Enabled. The possible values are:

■	Y: the account is enabled for Level III transactions. The Level III data was included in the request to the processor.

■	N: the account is not enabled for Level III transactions. The Level III data was not included in the request to the processor.

If your account is not enabled for Level III data or if you did not include the purchasing level field in your request, CyberSource does not include the Level III data in the request sent to the processor.

Step 4

If necessary, credit the payment.

Include the following information in the credit request:

■	Level II and Level III data: see the chapter in this document for the processor you are using. Also see Using Decimals and Strings.

 

OmniPay Direct does not require Level III data for credits. When you include Level III data in a credit request for OmniPay Direct, CyberSource does not pass the Level II data to OmniPay Direct.

 

RBS WorldPay Atlanta does not require Level II data for credits.

■	Purchasing level field: the field name is ccCreditService_purchasingLevel Set this field to 3 to indicate that the request includes Level III data.

■	Basic fields required for every credit request.

For more information, see the Credit Card Services User Guide.

Step 5

For all processors except CyberSource through VisaNet, check the credit reply message.

The reply message includes a field that indicates whether CyberSource sent the Level III information to the processor. The field name is ccCreditReply_purchasingLevel3Enabled. The possible values are:

■	Y: the account is enabled for Level III transactions. The Level III data was included in the request to the processor.

■	N: the account is not enabled for Level III transactions. The Level III data was not included in the request to the processor.

If your account is not enabled for Level III data or if you did not include the purchasing level field in your request, CyberSource does not include the Level III data in the request sent to the processor.