Authorization Service
Chase Paymentech SolutionsSimple Order API
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
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 totrue.
- encyrptedPayment_data
- Set this field to the Base64-encoded value obtained from thepaymentDataproperty of thePKPaymentTokenobject.
- encryptedPayment_descriptor
- Set this field toRklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U.
- merchantID
- merchantReferenceCode
- paymentSolution
- Set this field to001
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust 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
Cybersource
Decryption for American Express Follow these steps to authorize a payment using
Cybersource
decryption for American Express:- Request the service. Set theccAuthService_runfield totrue, 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
- Check the response message to make sure that the request was successful. A value ofACCEPTfor thedecisionfield indicates success. For information about reason codes, see Reason Codes for the Simple Order API.
NVP Example: Cybersource Decryption and
American Express
Cybersource
Decryption and
American ExpressRequest
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
Cybersource
Decryption and
American ExpressRequest
<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
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 totrue.
- encyrptedPayment_data
- Set this field to the Base64-encoded value obtained from thepaymentDataproperty of thePKPaymentTokenobject.
- encryptedPayment_descriptor
- Set this field toRklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U.
- merchantID
- merchantReferenceCode
- paymentSolution
- Set this field to001
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust be included in the request.
- paymentNetworkToken_transactionType
- Set this field to1.
Authorizing a Payment Using Cybersource Decryption for Discover
Cybersource
Decryption for DiscoverFollow these steps to authorize a payment using
Cybersource
decryption for Discover:- Request the service. Set theccAuthService_runfield totrue, 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
- Check the response message to make sure that the request was successful. A value ofACCEPTfor thedecisionfield indicates success. For information about reason codes, see Reason Codes for the Simple Order API.
NVP Example: Cybersource Decryption and
Discover
Cybersource
Decryption and
DiscoverRequest
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
Cybersource
Decryption and
DiscoverRequest
<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
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 totrue.
- encyrptedPayment_data
- Set this field to the Base64-encoded value obtained from thepaymentDataproperty of thePKPaymentTokenobject.
- encryptedPayment_descriptor
- Set this field toRklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U.
- merchantID
- merchantReferenceCode
- paymentSolution
- Set this field to001
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust be included in the request.
Authorizing a Payment Using Cybersource Decryption for Mastercard
Cybersource
Decryption for MastercardFollow these steps to authorize a payment using
Cybersource
decryption for Mastercard:- Request the service. Set theccAuthService_runfield totrue, 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
- Check the response message to make sure that the request was successful. A value ofACCEPTfor thedecisionfield indicates success. For information about reason codes, see Reason Codes for the Simple Order API.
NVP Example: Cybersource Decryption and
Mastercard
Cybersource
Decryption and
MastercardAuthorization 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
Cybersource
Decryption and
MastercardRequest
<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
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 totrue.
- encyrptedPayment_data
- Set this field to the Base64-encoded value obtained from thepaymentDataproperty of thePKPaymentTokenobject.
- encryptedPayment_descriptor
- Set this field toRklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U.
- merchantID
- merchantReferenceCode
- paymentSolution
- Set this field to001
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust be included in the request.
Authorizing a Payment Using Cybersource Decryption for Visa
Cybersource
Decryption for Visa Follow these steps to authorize a payment using
Cybersource
decryption for Visa:- Request the service. Set theccAuthService_runfield totrue, 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
- Check the response message to make sure that the request was successful. A value ofACCEPTfor thedecisionfield indicates success. For information about reason codes, see Reason Codes for the Simple Order API.
NVP Example: Cybersource Decryption and
Visa
Cybersource
Decryption and
VisaRequest
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
Cybersource
Decryption and
VisaRequest
<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 tointernet.
- For a transaction that uses 3-D Secure, set this field toaesk.
- ccAuthService_networkTokenCryptogram
- Set this field to the network token cryptogram.
- Include the whole 20-byte cryptogram in theccAuthService_networkTokenCryptogramfield. For a 40-byte cryptogram, split the cryptogram into two 20-byte binary values (block A and block B). Set theccAuthService_networkTokenCryptogramfield to the block A value and set theccAuthService_xidfield to the block B value.
- ccAuthService_run
- Set this field totrue.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust 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:
- Request the service. Set theccAuthService_runfield totrue, 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
- Check the response message to make sure that the request was successful. A value ofACCEPTfor thedecisionfield 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 tointernet.
- For a transaction that uses 3-D Secure, set this field todipb.
- ccAuthService_networkTokenCryptogram
- Set this field to the network token cryptogram.
- ccAuthService_run
- Set this field totrue.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust 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:
- Request the service. Set theccAuthService_runfield totrue, 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
- Check the response message to make sure that the request was successful. A value ofACCEPTfor thedecisionfield 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 tointernet.
- For a transaction that uses 3-D Secure, set this field tospa.
- ccAuthService_networkTokenCryptogram
- Set this field to the network token cryptogram.
- ccAuthService_run
- Set this field totrue.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust 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 to2.
Authorizing a Payment Using Merchant Decryption for Mastercard
Follow these steps to authorize a payment using merchant
decryption for Mastercard:
- Request the service. Set theccAuthService_runfield totrue, 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
- Check the response message to make sure that the request was successful. A value ofACCEPTfor thedecisionfield 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 to5(vbv).
- ccAuthService_networkTokenCryptogram
- Set this field to the network token cryptogram.
- ccAuthService_run
- Set this field totrue.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust 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:
- Request the service. Set theccAuthService_runfield totrue, 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
- Check the response message to make sure that the request was successful. A value ofACCEPTfor thedecisionfield 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 forGPXVisa 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
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 totrue.
- encryptedPayment_data
- Set this field to the Base64-encoded value obtained from thepaymentDataproperty of thePKPaymentTokenobject.
- encryptedPayment_descriptor
- Set this field toRklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust 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
Cybersource
Decryption and
American ExpressRequest
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
Cybersource
Decryption and
American ExpressRequest
<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
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 totrue.
- encryptedPayment_data
- Set this field to the Base64-encoded value obtained from thepaymentDataproperty of thePKPaymentTokenobject.
- encryptedPayment_descriptor
- Set this field toRklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust be included in the request.
NVP Example: Cybersource Decryption and
Discover
Cybersource
Decryption and
DiscoverRequest
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
Cybersource
Decryption and
DiscoverRequest
<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
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 totrue.
- encryptedPayment_data
- Set this field to the Base64-encoded value obtained from thepaymentDataproperty of thePKPaymentTokenobject.
- encryptedPayment_descriptor
- Set this field toRklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust be included in the request.
NVP Example: Cybersource Decryption and
Mastercard
Cybersource
Decryption and
MastercardAuthorization 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
Cybersource
Decryption and
MastercardRequest
<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
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 totrue.
- encryptedPayment_data
- Set this field to the Base64-encoded value obtained from thepaymentDataproperty of thePKPaymentTokenobject.
- encryptedPayment_descriptor
- Set this field toRklEPUNPTU1PTi5BUFBMRS5JTkFQUC5QQVlNRU5U.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust be included in the request.
NVP Example: Cybersource Decryption for Visa
Cybersource
Decryption for VisaRequest
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
Cybersource
Decryption for VisaRequest
<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 tointernet.
- For a transaction that uses 3-D Secure, set this field toaesk.
- ccAuthService_networkTokenCryptogram
- Set this field to the network token cryptogram.
- Include the whole 20-byte cryptogram in theccAuthService_networkTokenCryptogramfield. For a 40-byte cryptogram, split the cryptogram into two 20-byte binary values (block A and block B). Set theccAuthService_networkTokenCryptogramfield to the block A value and set theccAuthService_xidfield to the block B value.
- ccAuthService_run
- Set this field totrue.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust 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 tointernet.
- For a transaction that uses 3-D Secure, set this field todipb.
- ccAuthService_networkTokenCryptogram
- Set this field to the network token cryptogram.
- ccAuthService_run
- Set this field totrue.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust 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 tointernet.
- For a transaction that uses 3-D Secure, set this field tospa.
- ccAuthService_networkTokenCryptogram
- Set this field to the network token cryptogram.
- ccAuthService_run
- Set this field totrue.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust 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 to2.
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 to5(vbv).
- ccAuthService_networkTokenCryptogram
- Set this field to the network token cryptogram.
- ccAuthService_run
- Set this field totrue.
- merchantID
- merchantReferenceCode
- paymentNetworkToken_transactionType
- Set this field to1.
- paymentSolution
- Set this field to001.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- EitherpurchaseTotals_grandTotalAmountoritem_#_unitPricemust 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 forGPXVisa 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>