Home > Requesting the CyberSource Service


Requesting the CyberSource Service

Authorization Service

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 any additional API reply fields.

See Request Fields , and Reply Fields, for detailed descriptions of each API.

To request an authorization using a Visa card:

 

 

Step 1Set the card_accountNumber field to the payment network token value.

Step 2Set the card_expirationMonth and card_expirationYear fields to the payment network token expiration date fields.

Step 3Set the ccAuthService_cavv field to the 3D Secure cryptogram of the payment network token.

 

For a 40-byte cryptogram, split the cryptogram into two 20-byte binary values (block A and block B). Send the first 20-byte value (block A) in the cardholder authentication verification value (CAVV) field. Send the second 20-byte value (block B) in the transaction ID (XID) field.

Step 4Set the ccAuthService_xid field to the 3D Secure cryptogram of the payment network token.

Step 5Set the paymentNetworkToken_transactionType field to 1.

Step 6Set the ccAuthService_commerceIndicator field to internet.

Step 7Set the paymentSolution field to 007.

 

Example 1Authorization Request

<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.121">

<merchantID>demomerchant</merchantID>

<merchantReferenceCode>demorefnum</merchantReferenceCode>

<purchaseTotals>

<currency>USD</currency>

<grandTotalAmount>5.00</grandTotalAmount>

</purchaseTotals>

<card>

<accountNumber>4650100000000839</accountNumber>

<expirationMonth>12</expirationMonth>

<expirationYear>2020</expirationYear>

<cardType>001</cardType>

</card>

<ccAuthService run="true">

<cavv>ABCDEFabcdefABCDEFabcdef0987654321234567</cavv>

<commerceIndicator>internet</commerceIndicator>

<xid>ABCDEFabcdefABCDEFabcdef0987654321234567</xid>

</ccAuthService>

<paymentNetworkToken>

<transactionType>1</transactionType>

<requestorID>1234567890</requestorID>

</paymentNetworkToken>

<paymentSolution>007</paymentSolution>

</requestMessage>

Example 2Authorization Response

<c:replyMessage>

<c:merchantReferenceCode>demorefnum</c:merchantReferenceCode>

<c:requestID>4465840340765000001541</c:requestID>

<c:decision>ACCEPT</c:decision>

<c:reasonCode>100</c:reasonCode>

<c:requestToken>Ahj/7wSR5C/4Icd2fdAKakGLadfg5535r/ghx3Z90AoBj3u</c:requestToken>

<c:purchaseTotals>

<c:currency>USD</c:currency>

</c:purchaseTotals>

<c:ccAuthReply>

<c:reasonCode>100</c:reasonCode>

<c:amount>5.00</c:amount>

<c:authorizationCode>888888</c:authorizationCode>

<c:avsCode>X</c:avsCode>

<c:avsCodeRaw>I1</c:avsCodeRaw>

<c:authorizedDateTime>2015-11-03T20:53:54Z</c:authorizedDateTime>

<c:processorResponse>100</c:processorResponse>

<c:reconciliationID>11267051CGJSMQDC</c:reconciliationID>

</c:ccAuthReply>

</c:replyMessage>