TitlePage CyberSource Simple Order API

Transcription

Title PageCyberSource Simple Order APIRelease NotesFor Version 1.160TEST 2020CyberSource Corporation HQ P.O. Box 8999 San Francisco, CA 94128-8999 Phone: 800-530-9095

CyberSource Contact InformationFor general information about our company, products, and services, go tohttp://www.cybersource.com.For sales questions about any CyberSource Service, email sales@cybersource.com orcall 650-432-7350 or 888-330-2300 (toll free in the United States).For support information about any CyberSource Service, visit the Support Center athttp://www.cybersource.com/support.Copyright 2019 CyberSource Corporation. All rights reserved. CyberSource Corporation ("CyberSource") furnishes thisdocument and the software described in this document under the applicable agreement between the reader ofthis document ("You") and CyberSource ("Agreement"). You may use this document and/or software only inaccordance with the terms of the Agreement. Except as expressly set forth in the Agreement, the informationcontained in this document is subject to change without notice and therefore should not be interpreted in any wayas a guarantee or warranty by CyberSource. CyberSource assumes no responsibility or liability for any errorsthat may appear in this document. The copyrighted software that accompanies this document is licensed to Youfor use only in strict accordance with the Agreement. You should read the Agreement carefully before using thesoftware. Except as permitted by the Agreement, You may not reproduce any part of this document, store thisdocument in a retrieval system, or transmit this document, in any form or by any means, electronic, mechanical,recording, or otherwise, without the prior written consent of CyberSource.Restricted Rights LegendsFor Government or defense agencies. Use, duplication, or disclosure by the Government or defense agenciesis subject to restrictions as set forth the Rights in Technical Data and Computer Software clause at DFARS252.227-7013 and in similar clauses in the FAR and NASA FAR Supplement.For civilian agencies. Use, reproduction, or disclosure is subject to restrictions set forth in subparagraphs (a)through (d) of the Commercial Computer Software Restricted Rights clause at 52.227-19 and the limitations setforth in CyberSource Corporation's standard commercial agreement for this software. Unpublished rightsreserved under the copyright laws of the United States.TrademarksCyberSource, The Power of Payment, CyberSource Payment Manager, CyberSource Risk Manager,CyberSource Decision Manager, CyberSource Connect, Authorize.Net, and eCheck.net are trademarks and/orservice marks of CyberSource Corporation. All other brands and product names are trademarks or registeredtrademarks of their respective owners.2

CONTENTSContentsAbout This GuideFor XML Users6For SOAP UsersChapter 166Release Notes for Version 1.1607Version 1.160 7New Request Fields 7New Reply Fields 8Chapter 2Release Notes for Versions 1.158 and 1.159Version 1.158 9New Request Fields 9Renamed Request FieldsVersion 1.159Chapter 391010Release Notes for Version 1.15711Version 1.157 11New Request Fields 11New Reply Fields 12Chapter 4Release Notes for Version 1.156Version 1.156 13New Request Fields 13New Reply Fields 13Renamed Request Fields15Newly Documented Request FieldsNewly Documented Reply FieldsSimple Order API Release Notes August 20191315173

ContentsChapter 5Release Notes for Version 1.15518Version 1.155 18New Request Fields 18New Reply Fields 21Newly Documented Request FieldsNewly Documented Reply FieldsChapter 624Release Notes for Versions 1.154Version 1.154 25New Request FieldsChapter 7242525Release Notes for Versions 1.152 and 1.15327Version 1.152 27New Request Fields 27New Reply Fields 28Version 1.153 28New Request Fields28Newly Documented Request FieldsChapter 829Release Notes for Version 1.15130Version 1.151 30New Request Fields 30New Reply Fields 30Newly Documented Request FieldsChapter 9Release Notes for Version 1.150Version 1.150 32New Request Fields3232Newly Documented Request FieldsChapter 103132Release Notes for Version 1.14933Version 1.149 33New Request Fields 33New Reply Fields 36Newly Documented Request FieldsNewly Documented Reply FieldsSimple Order API Release Notes August 201940414

ContentsChapter 11Release Notes for Version 1.148Version 1.148 42New Request Fields42Newly Documented Request FieldsChapter 124242Release Notes for Version 1.147Version 1.147 43New Request Fields43Newly Documented Request FieldsNewly Documented Reply FieldsSimple Order API Release Notes August 20194344455

ABOUT GUIDEAbout This GuideIn these release notes, each chapter lists fields that have been changed or added to theSimple Order API since the previous version. This guide contains information for the mostrecent 12 releases. See the implementation guides at the Support Center for details aboutusing the API to request ICS services.These release notes use the name-value pair field names to show the changes made tothe API.For XML UsersIn the release notes, when changes to the name-value pair fields are presented, notesdescribing the corresponding changes in the XML element names are also included. Theexamples show an element’s child elements in no particular order. See the XML schemafor the required order of elements in your XML messages.See the current version of the XML schema Processor.NoteFor SOAP UsersWith the changes to existing elements and the addition of new XML elements to theschema, you will see parallel changes in the existing proxy classes or the addition of newproxy classes in the SOAP implementations.Simple Order API Release Notes August 20196

CHAPTERRelease Notes for Version1.1601Version 1.160New Request FieldsTable 1New Request Fields for Version 1.160Name-Value Pair FieldNameNotes for XMLWhere Field emptionIndicator delegatedAuthenticationExemptionIndicator is a newDocumentation for thisfield will be publishedsoon.child element of ccAuthService cator delegatedAuthenticationExemptionIndicator is a newchild element ofDocumentation for thisfield will be publishedsoon. ccSaleService .merchant antID merchant is a new child elementof requestMessage . merchant Documentation forthese fields will bepublished soon. acquirerBIN cardAcceptorID visaMerchantID /merchant Simple Order API Release Notes August 20197

Chapter 1Release Notes for Version 1.160New Reply FieldsTable 2New Reply Fields for Version 1.160Name-Value PairField NameNotes for XMLWhere Field IsDocumentedccAuthReplycardReferenceData cardReferenceData is a newchild element of ccAuthReply .Documentation for thisfield will be publishedsoon.Simple Order API Release Notes August 20198

CHAPTERRelease Notes for Versions1.158 and 1.1592Version 1.158New Request FieldsTable 3New Request Fields for Version 1.158Name-Value PairField NameNotes for XMLWhere Field IsDocumentedccSaleServicedeferredAuthIndicator ccSaleService is a new childelement of ccSaleService .Documentation for thisfield will be publishedsoon.jpo businessNameAlphanumeric businessNameAlphanumeric is a new childelement of jpo .Credit Card ServicesUsing the Simple OrderAPIjpo businessNameJapanese businessNameJapanese is anew child element of jpo .Credit Card ServicesUsing the Simple OrderAPIjpo businessNameKatakana businessNameKatakana is anew child element of jpo .Credit Card ServicesUsing the Simple OrderAPIjpo jis2TrackData businessNamejis2TrackData is a new child element of jpo .Card-Present ProcessingUsing the Simple OrderAPIwallet enrollmentID enrollmentID is a new childelement of wallet .Documentation for thisfield will be publishedsoon.Simple Order API Release Notes August 20199

Chapter 2Release Notes for Versions 1.158 and 1.159Renamed Request FieldsTable 4Renamed Request Fields for Version 1.158Name-Value PairField NamepayerAuthEnrollServicerequestorIdwas renamed toNotes for XML payerAuthEnrollService requestorId wasrenamed to payerAuthEnrollServicerequestorID .payerAuthEnrollServicerequestorIDVersion 1.159There are no field changes.Simple Order API Release Notes August 201910

CHAPTERRelease Notes for Version1.1573Version 1.157New Request FieldsTable 5New Request Fields for Version 1.157Name-Value PairField NameNotes for XMLWhere Field od abortService is a new childelement of requestMessage .Documentation for thesefields will be rvice run abortService cardholderVerificationMethod commerceIndicator run /abortService ccAuthServicedeferredAuthIndicator deferredAuthIndicator is anew child element of ccAuthService .ccSaleServicedeferredAuthIndicator deferredAuthIndicator is anew child element of ccSaleService .voidServicevoidReasonSimple Order API Release Notes August 2019 voidReason is a new childelement of voidReason .Credit Card ServicesUsing the Simple OrderAPIDocumentation for thisfield will be publishedsoon.Documentation for thisfield will be publishedsoon.11

Chapter 3Release Notes for Version 1.157New Reply FieldsTable 6New Reply Fields for Version 1.157Name-Value Pair FieldNameNotes for XMLWhere Field IsDocumentedreason abortReply abortReply is a new child elementof replyMessage .Documentation forthese fields will bepublished soon.reasonCode abortReplyrequestDateTimeabortReply abortReply reason commerceIndicator run / abortReply Simple Order API Release Notes August 201912

CHAPTERRelease Notes for Version1.1564Version 1.156New Request FieldsTable 7New Request Fields for Version 1.156Name-Value PairField NameNotes for XMLWhere Field IsDocumented actualFinalDestination isDocumentation for thisfield will be Destinationa new child element ofdecisionManagerTravelLegdepartureDateTimechild element ofitempassengerNationality passengerNationality is anew child element of item . decisionManagerTravelData . departureDateTime is a new decisionManagerTravelLeg .Documentation for thisfield will be publishedsoon.Documentation for thisfield will be publishedsoon.New Reply FieldsTable 8New Reply Fields for Version 1.156Name-Value Pair FieldNameNotes for XMLWhere Field IsDocumentedafsReply ipCarrier ipCarrier is a new child element of afsReply .Documentation forthis field will bepublished soon.afsReply ipOrganization ipOrganization is a new childelement of afsReply .Documentation forthis field will bepublished soon.Simple Order API Release Notes August 201913

Chapter 4Table 8Release Notes for Version 1.156New Reply Fields for Version 1.156 (Continued)Name-Value Pair FieldNameNotes for XMLWhere Field IsDocumenteddecisionReply travelactualFinalDestinationCountry travel is a new child element of decisionReply .Documentation forthese fields will bepublished soon.decisionReply travelactualFinalDestinationCitydecisionReply travelactualFinalDestinationLatitudedecisionReply travelactualFinalDestinationLongitudedecisionReply travelfirstDepartureCountrydecisionReply travelfirstDepartureCitydecisionReply travelfirstDepartureLatitudedecisionReply travelfirstDepartureLongitudedecisionReply travelfirstDestinationCountrydecisionReply travelfirstDestinationCitydecisionReply travelfirstDestinationLatitudedecisionReply travelfirstDestinationLongitudedecisionReply travellastDestinationCountrydecisionReply travellastDestinationCity travel actualFinalDestinationCountry actualFinalDestinationCity actualFinalDestinationLatitude actualFinalDestinationLongitude firstDepartureCountry firstDepartureCity firstDepartureLatitude firstDepartureLongitude firstDestinationCountry firstDestinationCity firstDestinationLatitude firstDestinationLongitude lastDestinationCountry lastDestinationCity lastDestinationLatitude lastDestinationLongitude /travel decisionReply travellastDestinationLatitudedecisionReply travellastDestinationLongitudeSimple Order API Release Notes August 201914

Chapter 4Release Notes for Version 1.156Renamed Request FieldsTable 9Renamed Request Fields for Version 1.156Name-Value PairField NamepayerAuthEnrollServicerequestorIdwas renamed toNotes for XML payerAuthEnrollService requestorId wasrenamed to payerAuthEnrollServicerequestorID .payerAuthEnrollServicerequestorIDNewly Documented RequestFieldsTable 10Newly Documented Request FieldsName-Value PairField NameWhere Field Is DocumentedNotesairlineDataboardingFeeAirline Processing Using the SimpleOrder APIThis field was originallydocumented in onIDPayment Network Tokenization Usingthe Simple Order APIThis field was originallydocumented in Version1.154.Apple Pay Using the Simple OrderAPIGoogle Pay Using the Simple OrderAPISamsung Pay Using the SimpleOrder APIccAuthServicenetworkTokenCryptogramPayment Network Tokenization Usingthe Simple Order APIApple Pay Using the Simple OrderAPIThis field was originallydocumented in Version1.154.Google Pay Using the Simple OrderAPISamsung Pay Using the SimpleOrder APISimple Order API Release Notes August 201915

Chapter 4Table 10Release Notes for Version 1.156Newly Documented Request Fields (Continued)Name-Value PairField NameWhere Field Is Payment Network Tokenization Usingthe Simple Order APIThis field was originallydocumented in Version1.154.Apple Pay Using the Simple OrderAPIGoogle Pay Using the Simple OrderAPISamsung Pay Using the SimpleOrder APIccCheckStatusServiceauthRequestIDCredit Card Services Using the SimpleOrder APIThis field was originallydocumented in Version1.152.personalID typeCredit Card Services Using the SimpleOrder APIThis field was originallydocumented in Version1.123.taxServicecommitIndicatorTax Calculation Service for the SimpleOrder APIThis field was originallydocumented in Version1.151.taxServicerefundIndicatorTax Calculation Service for the SimpleOrder APIThis field was originallydocumented in Version1.151.taxServicedateOverrideReasonTax Calculation Service for the SimpleOrder APIThis field was originallydocumented in Version1.151.taxServicereportingDateTax Calculation Service for the SimpleOrder APIThis field was originallydocumented in Version1.151.Simple Order API Release Notes August 201916

Chapter 4Release Notes for Version 1.156Newly Documented Reply FieldsTable 11Newly Documented Reply FieldsName-Value PairField NameWhere Field Is Credit Card Services Using the SimpleOrder APIThis field was originallydocumented in Version1.152.ccCheckStatusReplypaymentStatusCredit Card Services Using the SimpleOrder APIThis field was originallydocumented in Version1.152.ccCheckStatusReplyreasonCodeCredit Card Services Using the SimpleOrder APIThis field was originallydocumented in Version1.152.installmentdownPaymentCredit Card Services Using the SimpleOrder APIThis field was originallydocumented in Version1.152.taxReplycommitIndicatorTax Calculation Service for the SimpleOrder APIThis field was originallydocumented in Version1.151.taxReplyrefundIndicatorTax Calculation Service for the SimpleOrder APIThis field was originallydocumented in Version1.151.Simple Order API Release Notes August 201917

CHAPTERRelease Notes for Version1.1555Version 1.155New Request FieldsTable 12New Request Fields for Version 1.155Name-Value PairField NamebillTocompanyPhoneNumberbillTo prefixNotes for XMLWhere Field IsDocumented companyPhoneNumber is a newDocumentation for thisfield will be publishedsoon.child element of billTo . prefix is a new child element of billTo .Documentation for thisfield will be publishedsoon. cryptocurrencyPurchase isccAuthServicecryptocurrencyPurchasea new child element of ccAuthService .Credit Card ServicesUsing the Simple OrderAPIccAuthServicelowValueExemptionIndicator lowValueExemptionIndicator is a new child element of ccAuthService .Credit Card ServicesUsing the Simple r riskAnalysisExemptionIndicator is a new child element of ccAuthService .Credit Card ServicesUsing the Simple or secureCorporatePaymentIndicator is a new child element of ccAuthService .Credit Card ServicesUsing the Simple ator trustedMerchantExemptionIndicator is a new child elementof ccAuthService .Credit Card ServicesUsing the Simple OrderAPIccAuthServiceverificationType verificationType is a newCredit Card ServicesUsing the Simple OrderAPIchild element of ccAuthService .Simple Order API Release Notes August 201918

Chapter 5Table 12Release Notes for Version 1.155New Request Fields for Version 1.155 (Continued)Name-Value PairField NameNotes for XMLWhere Field IsDocumentedccSaleServicecryptocurrencyPurchasea new child element ofccSaleServicelowValueExemptionIndicator lowValueExemptionIndicator is a new child element of ccSaleService .Documentation for thisfield will be dicator riskAnalysisExemptionIndicator is a new child element of ccSaleService .Documentation for thisfield will be ndicator secureCorporatePaymentIndicator is a new child element of ccSaleService .Documentation for thisfield will be nIndicator trustedMerchantExemptionIndicator is a new child elementof ccSaleService .Documentation for thisfield will be publishedsoon.checkcheckTransactionCode checkTransactionCode is anew child element of check .Documentation for thisfield will be publishedsoon.checkcustomerPresent customerPresent is a newchild element of check .Documentation for thisfield will be publishedsoon.ecAVSService ecAVSService is a new childelement of requestMessage .Documentation for thisfield will be publishedsoon. firstInstallmentAmount isCredit Card ServicesUsing the Simple ntgracePeriodDuration cryptocurrencyPurchase is ccSaleService .a new child element of installment . gracePeriodDuration is anew child element of installment .Credit Card ServicesUsing the Simple OrderAPIinstallmentgracePeriodDurationType gracePeriodDurationType installmentmaximumTotalCount maximumTotalCount is a newchild element of installment .Credit Card ServicesUsing the Simple OrderAPIinstallmentminimumTotalCount minimumTotalCount is a newchild element of installment .Credit Card ServicesUsing the Simple OrderAPISimple Order API Release Notes August 2019is a new child element of installment .Credit Card ServicesUsing the Simple OrderAPI19

Chapter 5Table 12Release Notes for Version 1.155New Request Fields for Version 1.155 (Continued)Name-Value PairField NameNotes for XMLWhere Field IsDocumentedmPOS deviceType mPOS is a new child element of requestMessage .Documentation for thisfield will be publishedsoon. mPOS deviceType /mPOS payerAuthEnrollServicerequestorId requestorId is a new childelement of payerAuthEnrollService .payerAuthEnrollServicerequestoName requestorName is a new childelement of payerAuthEnrollService .Documentation for thisfield will be publishedsoon.Documentation for thisfield will be publishedsoon.personalID issuedBy issuedBy is a new child elementof personalID .Documentation for thisfield will be publishedsoon.tokenSourcetransientToken tokenSource is a new childelement of requestMessage .Documentation for thisfield will be publishedsoon. tokenSource transientToken /tokenSource Simple Order API Release Notes August 201920

Chapter 5Release Notes for Version 1.155New Reply FieldsTable 13New Reply Fields for Version 1.155Name-Value PairField NameNotes for XMLWhere Field IsDocumentedecAVSReplyaddedOrClosedDate ecAVSReply is a new childelement of replyMessage .ecAVSReplyadditionalStatusCode ecAVSReply Documentation for thesefields will be eNumberecAVSReplymatchBillToCompanyTaxID addedOrClosedDate additionalStatusCode calculatedResponse customerDataConditionCode fcraDisputeCode lastReturnDate lastReturnProcessorResponse lastUpdateDate matchBillToAddress matchBillToCity matchBillToCompany matchBillToCompanyPhoneNumber matchBillToCompanyTaxID matchBillToDateOfBirth matchBillToFirstName matchBillToFullName matchBillToLastName ecAVSReplymatchBillToDateOfBirth matchBillToMiddleName ecAVSReplymatchBillToFirstName matchBillToPhoneNumber ecAVSReplymatchBillToFullName matchBillToPostalCode ecAVSReplymatchBillToLastNameSimple Order API Release Notes August 2019 matchBillToPrefix 21

Chapter 5Table 13Release Notes for Version 1.155New Reply Fields for Version 1.155 (Continued)Name-Value PairField NameNotes for XMLecAVSReplymatchBillToMiddleName matchBillToSSN ecAVSReplymatchBillToPhoneNumber matchBillToSuffix VSReplyoverallMatchScore matchBillToState Where Field IsDocumentedDocumentation for thesefields will be publishedsoon. matchPersonalID matchPersonalIDIssuedBy matchPersonalIDType numberOfReturns overallMatchScore previousStatusCode primaryStatusCode reasonCode scoredAccountProcessorResponse1 scoredAccountProcessorResponse2 scoredAccountProcessorResponse3 scoredAccountProcessorResponse5 secondaryStatusCode validationType /ecAVSReply sponse2Simple Order API Release Notes August 201922

Chapter 5Table 13Release Notes for Version 1.155New Reply Fields for Version 1.155 (Continued)Name-Value PairField NameNotes for XMLWhere Field IsDocumentedDocumentation for thesefields will be ayerAuthEnrollReplychallengeRequired challengeRequired is a newchild element of payerAuthEnrollReply .payerAuthEnrollReplydirectoryServerTransactionID directoryServerTransactionID is a new childelement ofPayer AuthenticationUsing the Simple OrderAPIPayer AuthenticationUsing the Simple OrderAPI payerAuthEnrollReply .payerAuthValidateReply directoryServerTransactionID directoryServerTransactionID is a new childelement ofPayer AuthenticationUsing the Simple OrderAPI payerAuthValidateReply .Simple Order API Release Notes August 201923

Chapter 5Release Notes for Version 1.155Newly Documented RequestFieldsTable 14Newly Documented Request FieldsName-Value PairField NameWhere Field Is DocumentedNotesairlineDataboardingFeeAirline Processing Using the SimpleOrder APIThis field was originallydocumented in Version1.152.Newly Documented Reply FieldsTable 15Newly Documented Reply FieldsName-Value PairField NameWhere Field Is DocumentedNotesinstallmentdownPaymentCredit Card Services Using the SimpleOrder APIThis field was originallydocumented in Version1.152.Simple Order API Release Notes August 201924

CHAPTERRelease Notes for Versions1.1546Version 1.154New Request FieldsTable 16New Request Fields for Version 1.154Name-Value PairField NameNotes for XMLWhere Field IsDocumentedapSessionsServicesessionRequestID sessionRequestID is a newKlarna Services Usingthe Simple Order APIchild element of apSessionsService .apSessionsServicesessionsType sessionsType is a new childelement ofKlarna Services Usingthe Simple Order API apSessionsService .ccAuthServicedirectoryServerTransactionID directoryServerTransactionID is a new childelement of ccAuthService .Documentation for thisfield will be publishedsoon.ccAuthServicenetworkTokenCryptogram networkTokenCryptogram isa new child element ofDocumentation for thisfield will be publishedsoon.ccAuthServicepaSpecificationVersion ccAuthService . ccAuthService .Documentation for thisfield will be ionID directoryServerTransactionID is a new childelement of ccSaleService .Documentation for thisfield will be publishedsoon.ccSaleServicenetworkTokenCryptogram networkTokenCryptogram isa new child element ofDocumentation for thisfield will be publishedsoon.ccSaleServicepaSpecificationVersion paSpecificationVersion isa new child element of ccSaleService . paSpecificationVersion isa new child element of ccSaleService .Simple Order API Release Notes August 2019Documentation for thisfield will be publishedsoon.25

Chapter 6Table 16Release Notes for Versions 1.154New Request Fields for Version 1.154 (Continued)Name-Value PairField Namewallet discountAmountNotes for XMLWhere Field IsDocumented discountAmount is a new childDocumentation for thisfield will be publishedsoon.element of wallet .wallet eventTypewallet giftWrapAmount eventType is a new child elementof wallet .Documentation for thisfield will be publishedsoon. giftWrapAmount is a new childDocumentation for thisfield will be publishedsoon.element of wallet .wallet promotionCodewallet subtotalAmount promotionCode is a new childelement of wallet .Documentation for thisfield will be publishedsoon. subtotalAmount is a new childDocumentation for thisfield will be publishedsoon.element of wallet .wallettotalPurchaseAmountSimple Order API Release Notes August 2019 totalPurchaseAmount is anew child element of wallet .Documentation for thisfield will be publishedsoon.26

CHAPTERRelease Notes for Versions1.152 and 1.1537Version 1.152New Request FieldsTable 17New Request Fields for Version 1.152Name-Value PairField NameNotes for XMLWhere Field IsDocumentedairlineDataboardingFee boardingFee is a new childelement of airlineData .Documentation for thisfield will be publishedsoon.ccCheckStatusServiceauthRequestID ccCheckStatusService is aDocumentation for thisfield will be publishedsoon.new child element of authRequestID . ccCheckStatusService authRequestID /ccCheckStatusService Simple Order API Release Notes August 201927

Chapter 7Release Notes for Versions 1.152 and 1.153New Reply FieldsTable 1

Simple Order API Release Notes August 2019 6 About This Guide ABOUT GUIDE In these release notes, each chapter lists fields that have been changed or added to the Simple Order API since the previous version. This guide contains information for the most recent 12 releases. See the implementation guides at the Support Center for details about