Authorizations Using Merchant Decryption for American Express

This section provides the information you need in order to process an authorization using merchant decryption for American Express.

Required Fields for Authorizing a Payment Using Merchant Decryption for American Express

billTo_city
billTo_country
billTo_email
billTo_firstName
billTo_lastName
billTo_postalCode
billTo_state
billTo_street1
card_accountNumber
Set this field to the payment network token value.
card_expirationMonth
Set this field to the value from the payment network token expiration month.
card_expirationYear
Set this field to the value from the payment network token expiration year.
ccAuthService_cavv
Set this field to the network token cryptogram.
ccAuthService_commerceIndicator
Set this field to
internet
.
ccAuthService_networkTokenCryptogram
Set this field to the network token cryptogram.
Include the whole 20-byte cryptogram in the
ccAuthService_networkTokenCryptogram
 field. For a 40-byte cryptogram, split the cryptogram into two 20-byte binary values (block A and block B). Set the
ccAuthService_networkTokenCryptogram
 field to the block A value and set the
ccAuthService_xid
 field to the block B value.
ccAuthService_run
Set this field to
true
.
merchantID
merchantReferenceCode
paymentNetworkToken_transactionType
Set this field to
1
.
paymentSolution
Set this field to
001
.
purchaseTotals_currency
purchaseTotals_grandTotalAmount
Either
purchaseTotals_grandTotalAmount
 or
item_#_unitPrice
 must be included in the request.

Simple Order XML Example: Merchant Decryption and American Express

Light Dark
Request 
1234567891011121314151617181920212223242526272829303132
<="urn:schemas-cybersource-com:transaction-data-1.121">
    <merchantID>demomerchant</merchantID>
    <merchantReferenceCode>demorefnum</merchantReferenceCode>
    <billTo>
        <firstName>Jane</firstName>
        <lastName>Smith</lastName>
        <street1>123 Main Street</street1>
        <city>Small Town</city>
        <state>CA</state>
        <postalCode>98765</postalCode>
        <country>US</country>
        <email>jsmith@example.com</email>
    </billTo>
    <purchaseTotals>
        <currency>USD</currency>
        <grandTotalAmount>5.00</grandTotalAmount>
    </purchaseTotals>
    <card>
        <accountNumber>37828224631xxxx</accountNumber>
        <expirationMonth>12</expirationMonth>
        <expirationYear>2020</expirationYear>
        <cvNumber>123</cvNumber>
        <cardType>003</cardType>
    </card>
    <ccAuthService run="true">
        <cavv>ABCDEFabcdefABCDEFabcdef0987654321234567</cavv>
        <commerceIndicator>aesk</commerceIndicator>
    </ccAuthService>
    <paymentNetworkToken>
        <transactionType>1</transactionType> 
    <paymentSolution>001</paymentSolution>
</requestMessage>
Response to a Successful Request
1234567891011121314151617181920
<: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:>