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

billTo_city
billTo_country
billTo_email
billTo_firstName
billTo_lastName
billTo_postalCode
billTo_state
billTo_street1
card_accountNumber
card_expirationMonth
card_expirationYear
ccAuthService_run
Set this field to
true
.
encyrptedPayment_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
paymentSolution
Set this field to
001
purchaseTotals_currency
purchaseTotals_grandTotalAmount
Either
purchaseTotals_grandTotalAmount
or
item_#_unitPrice
must be included in the request.

Optional Fields for Authorizing a Payment for Apple Pay Transactions

You can include these optional fields in a request for an authorization:
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:
  1. Request the service. Set the
    ccAuthService_run
    field to
    true
    , and send the request to one of these endpoints:
    • Internet endpoint:
      https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • Akamai endpoint:
      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
Cybersource
Decryption for Discover

billTo_city
billTo_country
billTo_email
billTo_firstName
billTo_lastName
billTo_postalCode
billTo_state
billTo_street1
card_accountNumber
card_expirationMonth
card_expirationYear
ccAuthService_run
Set this field to
true
.
encyrptedPayment_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
paymentSolution
Set this field to
001
purchaseTotals_currency
purchaseTotals_grandTotalAmount
Either
purchaseTotals_grandTotalAmount
or
item_#_unitPrice
must be included in the request.
paymentNetworkToken_transactionType
Set this field to
1
.

Authorizing a Payment Using
Cybersource
Decryption for Discover

Follow these steps to authorize a payment using
Cybersource
decryption for Discover:
  1. Request the service. Set the
    ccAuthService_run
    field to
    true
    , and send the request to one of these endpoints:
    • Internet endpoint:
      https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • Akamai endpoint:
      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 Discover

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=004 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 Discover

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>004</cardType> </card> <paymentSolution>001</paymentSolution> <ccAuthService run="true"/> </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

billTo_city
billTo_country
billTo_email
billTo_firstName
billTo_lastName
billTo_postalCode
billTo_state
billTo_street1
card_accountNumber
card_expirationMonth
card_expirationYear
ccAuthService_run
Set this field to
true
.
encyrptedPayment_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
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 Mastercard

Follow these steps to authorize a payment using
Cybersource
decryption for Mastercard:
  1. Request the service. Set the
    ccAuthService_run
    field to
    true
    , and send the request to one of these endpoints:
    • Internet endpoint:
      https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • Akamai endpoint:
      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 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 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> </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

billTo_city
billTo_country
billTo_email
billTo_firstName
billTo_lastName
billTo_postalCode
billTo_state
billTo_street1
card_accountNumber
card_expirationMonth
card_expirationYear
ccAuthService_run
Set this field to
true
.
encyrptedPayment_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
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 Visa

Follow these steps to authorize a payment using
Cybersource
decryption for Visa:
  1. Request the service. Set the
    ccAuthService_run
    field to
    true
    , and send the request to one of these endpoints:
    • Internet endpoint:
      https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • Akamai endpoint:
      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 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 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> </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
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:
    • Internet endpoint:
      https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • Akamai endpoint:
      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>

Required Fields for Authorizing a Payment Using Merchant Decryption for Discover

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
dipb
.
ccAuthService_networkTokenCryptogram
Set this field to the network token cryptogram.
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 Discover

Follow these steps to authorize a payment using merchant decryption for Discover:
  1. Request the service. Set the
    ccAuthService_run
    field to
    true
    , and send the request to one of these endpoints:
    • Internet endpoint:
      https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • Akamai endpoint:
      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 Discover

Request
ccAuthService_run=true ccAuthService_cavv=ABCDEFabcdefABCDEFabcdef0987654321234567 ccAuthService_commerceIndicator=dipb 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 purhcaseTotals_grandTotalAmount=5.00 card_accountNumber=601111111111xxxx card_expirationMonth=12 card_expirationYear=2020 card_cvNumber=123 card_cardType=004 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 Discover

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>601111111111xxxx</accountNumber> <expirationMonth>12</expirationMonth> <expirationYear>2020</expirationYear> <cvNumber>123</cvNumber> <cardType>004</cardType> </card> <ccAuthService run="true"> <cavv>ABCDEFabcdefABCDEFabcdef0987654321234567</cavv> <commerceIndicator>dipb</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
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_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
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.
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:
  1. Request the service. Set the
    ccAuthService_run
    field to
    true
    , and send the request to one of these endpoints:
    • Internet endpoint:
      https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • Akamai endpoint:
      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 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_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
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 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
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 Visa

Follow these steps to authorize a payment using merchant decryption for Visa:
  1. Request the service. Set the
    ccAuthService_run
    field to
    true
    , and send the request to one of these endpoints:
    • Internet endpoint:
      https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • Akamai endpoint:
      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 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_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.

Optional Fields for Authorizing a Payment for Apple Pay Transactions

You can include these optional fields in a request for an authorization:
paymentNetworkToken_requestorID
Set this field to your token requestor ID that is assigned by the token service provider.

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 Discover

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.

NVP Example:
Cybersource
Decryption and Discover

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=004 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 Discover

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>004</cardType> </card> <paymentSolution>001</paymentSolution> <ccAuthService run="true"/> </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

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.

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 paymentSolution=001
Authorization 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 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> </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

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.

NVP Example:
Cybersource
Decryption for 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 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 for 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> </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
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.

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 Discover

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
dipb
.
ccAuthService_networkTokenCryptogram
Set this field to the network token cryptogram.
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.

NVP Example: Merchant Decryption and Discover

Request
ccAuthService_run=true ccAuthService_cavv=ABCDEFabcdefABCDEFabcdef0987654321234567 ccAuthService_commerceIndicator=dipb 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 purhcaseTotals_grandTotalAmount=5.00 card_accountNumber=601111111111xxxx card_expirationMonth=12 card_expirationYear=2020 card_cvNumber=123 card_cardType=004 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 Discover

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>601111111111xxxx</accountNumber> <expirationMonth>12</expirationMonth> <expirationYear>2020</expirationYear> <cvNumber>123</cvNumber> <cardType>004</cardType> </card> <ccAuthService run="true"> <cavv>ABCDEFabcdefABCDEFabcdef0987654321234567</cavv> <commerceIndicator>dipb</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
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_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
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.
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
.

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_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
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 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
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.

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_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>