Authorization Service

This section provides the information that you need for requesting the authorization service using these methods which determine the request fields that are required to request the authorization service. In addition, different request fields are required in order to request the authorization service. The type of card used to process the transaction determines which request fields are used.
After you send the request, verify the response messages to make sure that the request was successful.
A value of
ACCEPT
 for the
decision
 field indicates success.
For information about response codes, see
Reason Codes for the Simple Order API
.

Endpoint

Set the
ccAuthService_run
 field to
true
.
Send the request to
https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
.

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

Optional Fields for Authorizing a Payment for Apple Pay Transactions

You can include these optional fields in a request for an authorization:
paymentNetworkToken_assuranceLevel
paymentNetworkToken_assuranceMethod
Set this field to the tokenization confidence level that is assigned by the token service provider.
paymentNetworkToken_deviceTechType
Set this field to one of these options:
  • 001
    : Secure Element (SE)
  • 002
    : Host card emulation (HCE)
paymentNetworkToken_requestorID
Set this field to your token requestor ID that is assigned by the token service provider.

Authorizing a Payment Using
Cybersource
 Decryption for American Express

Follow these steps to authorize a payment using
Cybersource
 decryption for American Express:

NVP Example:
Cybersource
 Decryption and American Express

Request 
ccAuthService_run=true
merchantID=demomerchant
merchantReferenceCode=demorefnum
billTo_firstName>Jane
billTo_lastName=Smith
billTo_street1=123 Main Street
billTo_city=Small Town
billTo_state=CA
billTo_postalCode=98765        
billTo_country=US
billTo_email=jsmith@example.com
purchaseTotals_currency=USD
purchaseTotals_grandTotalAmount=5.00
encryptedPayment_descriptor=RklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U
encryptedPayment_data=ABCDEFabcdefABCDEFabcdef0987654321234567
encryptedPayment_encoding=Base64
card_cardType=003
paymentSolution=001
Response 
merchantReferenceCode=demorefnum
requestID=4465840340765000001541
decision=ACCEPT
reasonCode=100
requestToken=Ahj/7wSR5C/4Icd2fdAKakGLadfg5535r/ghx3Z90AoBj3u
token_expirationMonth=07
token_expirationYear=2025
token_prefix=239845
token_suffix=2947
purchaseTotals_currency=USD
ccAuthReply_reasonCode=100
ccAuthReply_amount=5.00
ccAuthReply_authorizationCode=888888
ccAuthReply_avsCode=X
ccAuthReply_avsCodeRaw=I1
ccAuthReply_authorizedDateTime=2015-11-03T20:53:54Z
ccAuthReply_processorResponse=100
ccAuthReply_reconciliationID=11267051CGJSMQDC

XML Example:
Cybersource
 Decryption and American Express

Request 
<requestMessage xmlns="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>
    <encryptedPayment>
        <descriptor>RklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U</descriptor>
        <data>ABCDEFabcdefABCDEFabcdef0987654321234567</data>
        <encoding>Base64</encoding>
    </encryptedPayment>
    <card>
        <cardType>003</cardType>
    </card>
    <paymentSolution>001</paymentSolution>
</requestMessage>
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:token>
        <c:expirationMonth>07</c:expirationMonth>
        <c:expirationYear>2025</c:expirationYear>
        <c:prefix>239845</c:prefix>
        <c:suffix>2947</c:suffix>
    </c:token>
    <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>

Required Fields for Authorizing a Payment Using
Cybersource
 Decryption for Mastercard

Authorizing a Payment Using
Cybersource
 Decryption for Mastercard

Follow these steps to authorize a payment using
Cybersource
 decryption for Mastercard:

NVP Example:
Cybersource
 Decryption and Mastercard

Authorization Request
ccAuthService_run=true
merchantID=demomerchant
merchantReferenceCode=demorefnum
billTo_firstName=Jane
billTo_lastName=Smith
billTo_street1=123 Main Street
billTo_city=Small Town
billTo_state=CA
billTo_postalCode=98765
billTo_country=US
billTo_email=jsmith@example.com
purchaseTotals_currency=USD
purchaseTotals_grandTotalAmount=5.00
encryptedPayment_descriptor=RklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U
encryptedPayment_data=ABCDEFabcdefABCDEFabcdef0987654321234567
encryptedPayment_encoding=Base64
card_cardType=002

paymentNetworkToken_requestorID=987654321plokijuhygtfrdeswa

paymentSolution=001
Authorization Response 
merchantReferenceCode=demorefnum
requestID=4465840340765000001541
decision=ACCEPT
reasonCode=100
requestToken=Ahj/7wSR5C/4Icd2fdAKakGLadfg5535r/ghx3Z90AoBj3u
token_expirationMonth=07
token_expirationYear=2025</c:expirationYear>
token_prefix=239845
token_suffix=2947
purchaseTotals_currency=USD
ccAuthReply_reasonCode=100
ccAuthReply_amount=5.00
ccAuthReply_authorizationCode=888888
ccAuthReply_avsCode=X
ccAuthReply_avsCodeRaw=I1
ccAuthReply_authorizedDateTime=2015-11-03T20:53:54Z
ccAuthReply_processorResponse=100
ccAuthReply_reconciliationID=11267051CGJSMQDC

XML Example:
Cybersource
 Decryption and Mastercard

Request
<requestMessage xmlns="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>
    <encryptedPayment>
        <descriptor>RklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U</descriptor>
        <data>ABCDEFabcdefABCDEFabcdef0987654321234567</data>
        <encoding>Base64</encoding>
    </encryptedPayment>
    <card>
        <cardType>002</cardType>
    </card>
    <ccAuthService run="true"/>
    <paymentNetworkToken>
        
<requestorID>987654321plokijuhygtfrdeswa</requestorID> 

    </paymentNetworkToken>
    <paymentSolution>001</paymentSolution>
</requestMessage>
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:token>
        <c:expirationMonth>07</c:expirationMonth>
        <c:expirationYear>2025</c:expirationYear>
        <c:prefix>239845</c:prefix>
        <c:suffix>2947</c:suffix>
    </c:token>
    <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>

Required Fields for Authorizing a Payment Using
Cybersource
 Decryption for Visa

Authorizing a Payment Using
Cybersource
 Decryption for Visa

Follow these steps to authorize a payment using
Cybersource
 decryption for Visa:

NVP Example:
Cybersource
 Decryption and Visa

Request
ccAuthService_run=true
merchantID=demomerchant
merchantReferenceCode=demorefnum
billTo_firstName=Jane
billTo_lastName=Smith
billTo_street1=123 Main Street
billTo_city=Small Town
billTo_state=CA
billTo_postalCode=98765
billTo_country=US
billTo_email=jsmith@example.com
purchaseTotals_currency=USD
purchaseTotals_grandTotalAmount=5.00
encryptedPayment_descriptor=RklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U
encryptedPayment_data=ABCDEFabcdefABCDEFabcdef0987654321234567
encryptedPayment_encoding=Base64
card_cardType=001

paymentNetworkToken_requestorID=987654321plokijuhygtfrdeswa
 
paymentSolution=001
Response
merchantReferenceCode=demorefnum
requestID=4465840340765000001541
decision=ACCEPT
reasonCode=100
requestToken=Ahj/7wSR5C/4Icd2fdAKakGLadfg5535r/ghx3Z90AoBj3u
token_expirationMonth=07
token_expirationYear=2025
token_prefix=239845
token_suffix=2947
purchaseTotals_currency=USD
ccAuthReply_reasonCode=100
ccAuthReply_amount=5.00
ccAuthReply_authorizationCode=888888
ccAuthReply_avsCode=X
ccAuthReply_avsCodeRaw=I1
ccAuthReply_authorizedDateTime=2015-11-03T20:53:54Z
ccAuthReply_processorResponse=100
ccAuthReply_reconciliationID=11267051CGJSMQDC

XML Example:
Cybersource
 Decryption and Visa

Request
<requestMessage xmlns="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>
    <encryptedPayment>
        <descriptor>RklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U</descriptor>
        <data>ABCDEFabcdefABCDEFabcdef0987654321234567</data>
        <encoding>Base64</encoding>
    </encryptedPayment>
    <card>
        <cardType>001</cardType>
    </card>
    <ccAuthService run="true"/>
    <paymentNetworkToken>
        
<requestorID>987654321plokijuhygtfrdeswa</requestorID>
 
    </paymentNetworkToken>
    <paymentSolution>001</paymentSolution>
</requestMessage>
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:token>
        <c:expirationMonth>07</c:expirationMonth>
        <c:expirationYear>2025</c:expirationYear>
        <c:prefix>239845</c:prefix>
        <c:suffix>2947</c:suffix>
    </c:token>
    </c:purchaseTotals>
    <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>

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
ccAuthService_cavv
For a transaction that uses 3-D Secure, set this field to the 3-D Secure cryptogram.
ccAuthService_commerceIndicator
For a transaction that does not use 3-D Secure, set this field to
internet
.
For a transaction that uses 3-D Secure, set this field to
aesk
.
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
purchaseTotals_currency
purchaseTotals_grandTotalAmount
Either
purchaseTotals_grandTotalAmount
 or
item_#_unitPrice
 must be included in the request.

Authorizing a Payment Using Merchant Decryption for American Express

Follow these steps to authorize a payment using merchant decryption for American Express:

NVP Example: Merchant Decryption and American Express

Request 
ccAuthService_run=true
ccAuthService_cavv=ABCDEFabcdefABCDEFabcdef0987654321234567
ccAuthService_commerceIndicator=aesk
merchantID=demomerchant
merchantReferenceCode=demorefnum
billTo_firstName=Jane
billTo_lastName=Smith
billTo_street1=123 Main Street
billTo_city=Small Town
billTo_state=CA
billTo_postalCode=98765
billTo_country=US
billTo_email=jsmith@example.com
purchaseTotals_currency=USD
purchaseTotals_grandTotalAmount=5.00
card_accountNumber=37828224631xxxx
card_expirationMonth=12
card_expirationYear=2020
card_cvNumber=123
card_cardType=003
paymentNetworkToken_transactionType=1
paymentSolution=001
Response 
merchantReferenceCode=demorefnum
requestID=4465840340765000001541
decision=ACCEPT
reasonCode=100
requestToken=Ahj/7wSR5C/4Icd2fdAKakGLadfg5535r/ghx3Z90AoBj3u
purchaseTotals_currency=USD
ccAuthReply_reasonCode=100
ccAuthReply_amount=5.00
ccAuthReply_authorizationCode=888888
ccAuthReply_avsCode=X
ccAuthReply_avsCodeRaw=I1
ccAuthReply_authorizedDateTime=2015-11-03T20:53:54Z
ccAuthReply_processorResponse=100
ccAuthReply_reconciliationID=11267051CGJSMQDC

XML Example: Merchant Decryption and American Express

Request 
<requestMessage xmlns="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> 
    </paymentNetworkToken>
    <paymentSolution>001</paymentSolution>
</requestMessage>
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>

Required Fields for Authorizing a Payment Using Merchant Decryption for Mastercard

billTo_city
billTo_country
billTo_email
billTo_firstName
billTo_lastName
billTo_postalCode
billTo_state
billTo_street1
cardTypeSelectionIndicator
If omitted, this field defaults to
1
.
ccAuthService_commerceIndicator
For a transaction that does not use 3-D Secure, set this field to
internet
.
For a transaction that uses 3-D Secure, set this field to
spa
.
ccAuthService_networkTokenCryptogram
Set this field to the network token cryptogram.
ccAuthService_run
Set this field to
true
.
merchantID
merchantReferenceCode
purchaseTotals_currency
purchaseTotals_grandTotalAmount
Either
purchaseTotals_grandTotalAmount
 or
item_#_unitPrice
 must be included in the request.
transactionMode
Required only for merchants in Saudi Arabia.
ucaf_authenticationData
For a transaction that uses 3-D Secure, set this field to the 3-D Secure cryptogram.
ucaf_collectionIndicator
Set this field to
2
.

Authorizing a Payment Using Merchant Decryption for Mastercard

Follow these steps to authorize a payment using merchant decryption for Mastercard:

NVP Example: Merchant Decryption and Mastercard

Request
ccAuthService_run=true
ccAuthService_commerceIndicator=spa
merchantID=demomerchant
merchantReferenceCode=demorefnum
billTo_firstName=Jane
billTo_lastName=Smith
billTo_street1=123 Main Street
billTo_city=Small Town
billTo_state=CA
billTo_postalCode=98765
billTo_country=US
billTo_email=jsmith@example.com
purchaseTotals_currency=USD
purchastTotals_grandTotalAmount=5.00
card_accountNumber=555555555555xxxx
card_expirationMonth=12
card_expirationYear=2020
card_cvnNumber=123
card_cardType=002
ucaf_authenticationData=ABCDEFabcdefABCDscdef0987654321234567
ucaf_collectionIndicator=2

paymentNetworkToken_requestorID=987654321plokijuhygtfrdeswa
 
paymentNetworkToken_transactionType=1
paymentSolution=001
Response
merchantReferenceCode=demorefnum
requestID=4465840340765000001541
decision=accept
reasonCode=100
requestToken=Ahj/7wSR5C/4Icd2fdAKakGLadfg5535r/ghx3Z90AoBj3u
purchaseTotals_currency=USD
ccAuthReply_reasonCode=100
ccAuthReply_amount=5.00
ccAuthReply_authorizationCode=888888
ccAuthReply_avsCode=X
ccAuthReply_avsCodeRaw=I1
ccAuthReply_authorizedDateTime=2015-11-03T20:53:54Z
ccAuthReply_processorResponse=100
ccAuthReply_reconciliationID=11267051CGJSMQDC

XML Example: Merchant Decryption and Mastercard

Request
<requestMessage xmlns="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>555555555555xxxx</accountNumber>
        <expirationMonth>12</expirationMonth>
        <expirationYear>2020</expirationYear>
        <cvNumber>123</cvNumber>
        <cardType>002</cardType>
    </card>
    <ucaf>
        <authenticationData>ABCDEFabcdefABCDscdef0987654321234567</authenticationData>
        <collectionIndicator>2</collectionIndicator>
    </ucaf>
    <ccAuthService run="true">
        <commerceIndicator>spa</commerceIndicator>
    </ccAuthService> 
    <paymentNetworkToken>
        <requestorID>987654321plokijuhygtfrdeswa</requestorID> <!-- Required only for GPXVisa Platform Connect and GPXVisa Platform Connect. -->
        <transactionType>1</transactionType> 
    </paymentNetworkToken>
    <paymentSolution>001</paymentSolution>
</requestMessage>
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>

Required Fields for Authorizing a Payment Using Merchant Decryption for Visa

billTo_city
billTo_country
billTo_email
billTo_firstName
billTo_lastName
billTo_postalCode
billTo_state
billTo_street1
cardTypeSelectionIndicator
If omitted, this field defaults to
1
.
ccAuthService_cavv
For a card that supports 3-D Secure, set this field to the 3-D Secure cryptogram.
ccAuthService_commerceIndicator
For a transaction that does not use 3-D Secure, set this field to the ECI value contained in the Apple Pay response payload.
For a transaction that uses 3-D Secure, set this field to
5
 (
vbv
).
ccAuthService_networkTokenCryptogram
Set this field to the network token cryptogram.
ccAuthService_run
Set this field to
true
.
merchantID
merchantReferenceCode
purchaseTotals_currency
purchaseTotals_grandTotalAmount
Either
purchaseTotals_grandTotalAmount
 or
item_#_unitPrice
 must be included in the request.
transactionMode
Required only for merchants in Saudi Arabia.

Authorizing a Payment Using Merchant Decryption for Visa

Follow these steps to authorize a payment using merchant decryption for Visa:

NVP Example: Merchant Decryption and Visa

Request
ccAuthService_run=true
ccAuthService_cavv=ABCDEFabcdefABCDEFabcdef0987654321234567
ccAuthService_commerceIndicator=internet
merchantID=demomerchant
merchantReferenceCode=demorefnum
billTo_firstName=Jane
billTo_lastName=Smith
billTo_street1=123 Main Street
billTo_city=Small Town
billTo_state=CA
billTo_postalCode=98765
billTo_country=US
billTo_email=jsmith@example.com
purchaseTotals_currency=USD
purchastTotals_grandTotalAmount=5.00
card_accountNumber=4111111111111111
card_expirationMonth=12
card_expirationYear=2020
card_cvnNumber=123
card_cardType=001

paymentNetworkToken_requestorID=987654321plokijuhygtfrdeswa
 
paymentNetworkToken_transactionType=1
paymentSolution=001
Response
merchantReferenceCode=demorefnum
requestID=4465840340765000001541
decision=accept
reasonCode=100
requestToken=Ahj/7wSR5C/4Icd2fdAKakGLadfg5535r/ghx3Z90AoBj3u
purchaseTotals_currency=USD
ccAuthReply_reasonCode=100
ccAuthReply_amount=5.00
ccAuthReply_authorizationCode=888888
ccAuthReply_avsCode=X
ccAuthReply_avsCodeRaw=I1
ccAuthReply_authorizedDateTime=2015-11-03T20:53:54Z
ccAuthReply_processorResponse=100
ccAuthReply_reconciliationID=11267051CGJSMQDC

XML Example: Merchant Decryption and Visa

Request
<requestMessage xmlns="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>4111111111111111</accountNumber>
        <expirationMonth>12</expirationMonth>
        <expirationYear>2020</expirationYear>
        <cvNumber>123</cvNumber>
        <cardType>001</cardType>
    </card>
    <ccAuthService run="true">
        <cavv>ABCDEFabcdefABCDEFabcdef0987654321234567</cavv>
        <commerceIndicator>internet</commerceIndicator>
    </ccAuthService>
    <paymentNetworkToken>
        <requestorID>987654321plokijuhygtfrdeswa</requestorID> <!-- Required only for 
GPXVisa Platform Connect and GPXVisa Platform Connect
. -->
        <transactionType>1</transactionType> 
    </paymentNetworkToken>
    <paymentSolution>001</paymentSolution>
</requestMessage>
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>

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

billTo_city
billTo_country
billTo_email
billTo_firstName
billTo_lastName
billTo_postalCode
billTo_state
billTo_street1
ccAuthService_run
Set this field to
true
.
encryptedPayment_data
Set this field to the Base64-encoded value obtained from the
paymentData
 property of the
PKPaymentToken
 object.
encryptedPayment_descriptor
Set this field to
RklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U
.
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.

Authorizing a Payment Using
Cybersource
 Decryption for American Express

Follow these steps to authorize a payment using
Cybersource
 decryption for American Express:
  1. Request the service. Set the
    ccAuthService_run
     field to
    true
    , and send the request to one of these endpoints:
    • https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • https://ics2wsa.ic3.com/commerce/1.x/transactionProcessor
  2. Check the response message to make sure that the request was successful. A value of
    ACCEPT
     for the
    decision
     field indicates success. For information about reason codes, see Reason Codes for the Simple Order API.

NVP Example:
Cybersource
 Decryption and American Express

Request 
ccAuthService_run=true
merchantID=demomerchant
merchantReferenceCode=demorefnum
billTo_firstName>Jane
billTo_lastName=Smith
billTo_street1=123 Main Street
billTo_city=Small Town
billTo_state=CA
billTo_postalCode=98765        
billTo_country=US
billTo_email=jsmith@example.com
purchaseTotals_currency=USD
purchaseTotals_grandTotalAmount=5.00
encryptedPayment_descriptor=RklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U
encryptedPayment_data=ABCDEFabcdefABCDEFabcdef0987654321234567
encryptedPayment_encoding=Base64
card_cardType=003
paymentSolution=001
Response 
merchantReferenceCode=demorefnum
requestID=4465840340765000001541
decision=ACCEPT
reasonCode=100
requestToken=Ahj/7wSR5C/4Icd2fdAKakGLadfg5535r/ghx3Z90AoBj3u
token_expirationMonth=07
token_expirationYear=2025
token_prefix=239845
token_suffix=2947
purchaseTotals_currency=USD
ccAuthReply_reasonCode=100
ccAuthReply_amount=5.00
ccAuthReply_authorizationCode=888888
ccAuthReply_avsCode=X
ccAuthReply_avsCodeRaw=I1
ccAuthReply_authorizedDateTime=2015-11-03T20:53:54Z
ccAuthReply_processorResponse=100
ccAuthReply_reconciliationID=11267051CGJSMQDC

XML Example:
Cybersource
 Decryption and American Express

Request 
<requestMessage xmlns="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>
    <encryptedPayment>
        <descriptor>RklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U</descriptor>
        <data>ABCDEFabcdefABCDEFabcdef0987654321234567</data>
        <encoding>Base64</encoding>
    </encryptedPayment>
    <card>
        <cardType>003</cardType>
    </card>
    <paymentSolution>001</paymentSolution>
</requestMessage>
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:token>
        <c:expirationMonth>07</c:expirationMonth>
        <c:expirationYear>2025</c:expirationYear>
        <c:prefix>239845</c:prefix>
        <c:suffix>2947</c:suffix>
    </c:token>
    <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>

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
For a transaction that uses 3-D Secure, set this field to the 3-D Secure cryptogram.
ccAuthService_commerceIndicator
For a transaction that does not use 3-D Secure, set this field to
internet
.
For a transaction that uses 3-D Secure, set this field to
aesk
.
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.

Authorizing a Payment Using Merchant Decryption for American Express

Follow these steps to authorize a payment using merchant decryption for American Express:
  1. Request the service. Set the
    ccAuthService_run
     field to
    true
    , and send the request to one of these endpoints:
    • https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • https://ics2wsa.ic3.com/commerce/1.x/transactionProcessor
  2. Check the response message to make sure that the request was successful. A value of
    ACCEPT
     for the
    decision
     field indicates success. For information about reason codes, see Reason Codes for the Simple Order API.

NVP Example: Merchant Decryption and American Express

Request 
ccAuthService_run=true
ccAuthService_cavv=ABCDEFabcdefABCDEFabcdef0987654321234567
ccAuthService_commerceIndicator=aesk
merchantID=demomerchant
merchantReferenceCode=demorefnum
billTo_firstName=Jane
billTo_lastName=Smith
billTo_street1=123 Main Street
billTo_city=Small Town
billTo_state=CA
billTo_postalCode=98765
billTo_country=US
billTo_email=jsmith@example.com
purchaseTotals_currency=USD
purchaseTotals_grandTotalAmount=5.00
card_accountNumber=37828224631xxxx
card_expirationMonth=12
card_expirationYear=2020
card_cvNumber=123
card_cardType=003
paymentNetworkToken_transactionType=1
paymentSolution=001
Response 
merchantReferenceCode=demorefnum
requestID=4465840340765000001541
decision=ACCEPT
reasonCode=100
requestToken=Ahj/7wSR5C/4Icd2fdAKakGLadfg5535r/ghx3Z90AoBj3u
purchaseTotals_currency=USD
ccAuthReply_reasonCode=100
ccAuthReply_amount=5.00
ccAuthReply_authorizationCode=888888
ccAuthReply_avsCode=X
ccAuthReply_avsCodeRaw=I1
ccAuthReply_authorizedDateTime=2015-11-03T20:53:54Z
ccAuthReply_processorResponse=100
ccAuthReply_reconciliationID=11267051CGJSMQDC

XML Example: Merchant Decryption and American Express

Request 
<requestMessage xmlns="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> 
    </paymentNetworkToken>
    <paymentSolution>001</paymentSolution>
</requestMessage>
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>