Title Page CyberSource Simple Order API Release Notes For Versions 1.117 and 1.118 June 2015 CyberSource Corporation HQ | P.O. Box 8999 | San Francisco, CA 94128-8999 | Phone: 800-530-9095 CyberSource Contact Information For general information about our company, products, and services, go to http://www.cybersource.com. For sales questions about any CyberSource Service, email [email protected] or call 650-432-7350 or 888-330-2300 (toll free in the United States). For support information about any CyberSource Service, visit the Support Center at http://www.cybersource.com/support. Copyright © 2015 CyberSource Corporation. All rights reserved. CyberSource Corporation ("CyberSource") furnishes this document and the software described in this document under the applicable agreement between the reader of this document ("You") and CyberSource ("Agreement"). You may use this document and/or software only in accordance with the terms of the Agreement. Except as expressly set forth in the Agreement, the information contained in this document is subject to change without notice and therefore should not be interpreted in any way as a guarantee or warranty by CyberSource. CyberSource assumes no responsibility or liability for any errors that may appear in this document. The copyrighted software that accompanies this document is licensed to You for use only in strict accordance with the Agreement. You should read the Agreement carefully before using the software. Except as permitted by the Agreement, You may not reproduce any part of this document, store this document 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 Legends For Government or defense agencies. Use, duplication, or disclosure by the Government or defense agencies is subject to restrictions as set forth the Rights in Technical Data and Computer Software clause at DFARS 252.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 set forth in CyberSource Corporation's standard commercial agreement for this software. Unpublished rights reserved under the copyright laws of the United States. Trademarks CyberSource, The Power of Payment, CyberSource Payment Manager, CyberSource Risk Manager, CyberSource Decision Manager, CyberSource Connect, Authorize.Net, and eCheck.net are trademarks and/or service marks of CyberSource Corporation. All other brands and product names are trademarks or registered trademarks of their respective owners. 2 CONTENTS Contents About This Guide For XML Users For SOAP Users Chapter 1 6 6 6 Release Notes for Versions 1.117 and 1.1118 7 Version 1.117 7 New Request Field 7 Renamed Reply Field 7 Version 1.118 8 New Reply Fields Chapter 2 8 Release Notes for Versions 1.115 and 1.1116 9 Version 1.115 9 New Request Fields 9 New Reply Fields 12 Version 1.116 16 New Request Fields 16 New Reply Fields 16 Chapter 3 Release Notes for Versions 1.113 and 1.1114 18 Version 1.113 18 New Request Fields 18 New Reply Fields 20 Version 1.114 20 New Request Fields Chapter 4 20 Release Notes for Version 1.112 Version 1.112 21 New Request Fields Simple Order API Release Notes | June 2015 21 21 3 Contents Chapter 5 Release Notes for Version 1.111 Version 1.111 Chapter 6 22 Release Notes for Version 1.110 Version 1.110 Chapter 7 22 23 23 Release Notes for Versions 1.108 and 1.109 24 Version 1.108 24 New Request Fields 24 New Reply Fields 24 Removed Reply Fields 25 Version 1.109 25 New Request Fields 25 Newly Documented Request Fields Newly Documented Reply Fields Chapter 8 32 Release Notes for Versions 1.106 and 1.107 Version 1.106 33 New Request Fields Version 1.107 34 New Reply Fields 33 33 34 Newly Documented Request Fields Newly Documented Reply Fields Chapter 9 32 34 36 Release Notes for Versions 1.104 and 1.105 Version 1.104 39 New Request Fields 39 39 Version 1.105 40 New Request Fields 40 New Reply Fields 41 Chapter 10 Release Notes for Versions 1.102 and 1.103 Version 1.102 44 New Request Fields 44 Version 1.103 47 New Request Fields 47 Simple Order API Release Notes | June 2015 44 4 Contents New Reply Fields 47 Newly Documented Request Fields Chapter 11 48 Release Notes for Versions 1.100 and 1.101 Version 1.100 49 New Reply Fields 49 49 Version 1.101 49 New Request Fields 49 New Reply Fields 50 Chapter 12 Release Notes for Version 1.99 Version 1.99 51 New Reply Field 51 Newly Documented Request Field Newly Documented Reply Fields Simple Order API Release Notes | June 2015 51 51 52 5 ABOUT GUIDE About This 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 using the API to request ICS services. These release notes use the name-value pair field names to show the changes made to the API. For XML Users In the release notes, when changes to the name-value pair fields are presented, notes describing the corresponding changes in the XML element names are also included. The examples show an element’s child elements in no particular order. See the XML schema for the required order of elements in your XML messages. See the current version of the XML schema at: https://ics2ws.ic3.com/commerce/1.x/transactionProcessor. Note For SOAP Users With the changes to existing elements and the addition of new XML elements to the schema, you will see parallel changes in the existing proxy classes or the addition of new proxy classes in the SOAP implementations. Simple Order API Release Notes | June 2015 6 CHAPTER 1 Release Notes for Versions 1.117 and 1.1118 Version 1.117 New Request Field Table 1 New Request Field for Version 1.117 Name-Value Pair Field Name prenoteTransaction Notes for XML Where Field Is Documented <prenoteTransaction> is a new Direct Debit Services for Chase Paymentech Solutions Using the Simple Order API child element of <requestMessage>. Renamed Reply Field Table 2 New Reply Field for Version 1.117 Name-Value Pair Field Name Notes for XML paresEnrolled <paresEnrolled> was renamed to <paresStatus>. was renamed to paresStatus Simple Order API Release Notes | June 2015 7 Chapter 1 Release Notes for Versions 1.117 and 1.1118 Version 1.118 New Reply Fields Table 3 New Reply Fields for Version 1.116 Name-Value Pair Field Name Notes for XML Where Field Is Documented afsReply_cardBin <afsReply> is a new child element of <cardBin>. Documentation for this field will be published soon. Simple Order API Release Notes | June 2015 8 CHAPTER 2 Release Notes for Versions 1.115 and 1.1116 Version 1.115 New Request Fields Table 4 New Request Fields for Version 1.115 Name-Value Pair Field Name Notes for XML Where Field Is Documented ccSaleService_ overridePayment Method <ccSaleService> is a new child element of <requestMessage>. Documentation for this field will be published soon. ccSaleService_ commerceIndicator ccSaleService_ partialAuthIndicator <ccSaleService> <commerceIndicator> <reconciliationID> <commerceIndicator> ccSaleService_cavv <commerceIndicator> ccSaleService_xid <commerceIndicator> ccSaleService_ reconciliationID <commerceIndicator> ccSaleCreditService_ commerceIndicator ccSaleCreditService_ reconciliationID </ccSaleService> <ccSaleCreditService> is a new child element of <requestMessage>. Documentation for this field will be published soon. <ccSaleCreditService> <commerceIndicator> <reconciliationID> </ccSaleCreditService> Simple Order API Release Notes | June 2015 9 Chapter 2 Table 4 Release Notes for Versions 1.115 and 1.1116 New Request Fields for Version 1.115 (Continued) Name-Value Pair Field Name ccSaleReversalService _saleRequestID Notes for XML Where Field Is Documented <ccSaleReversalService> is a Documentation for this field will be published soon. new child element of <requestMessage>. <ccSaleReversalService> <saleRequestID> </ccSaleReversalService> pinDebitPurchase Service_paymentType <paymentType> is a new child element of <pinDebitPurchaseService>. pinDebitPurchase Service_ebtCategory PIN Debit Processing Using the Simple Order API <ebtCategory> is a new child element of <pinDebitPurchaseService>. pinDebitPurchase Service_ transactionType pinDebitPurchase Service_ ebtVoucherSerial Number pinDebitPurchase Service_ authorizationCode pinDebitCreditService_ paymentType <transactionType> is a new child element of <pinDebitPurchaseService>. <ebtVoucherSerialNumber> is a new child element of <pinDebitPurchaseService>. <authorizationCode> is a new child element of <pinDebitPurchaseService>. <paymentType> is a new child element of <pinDebitCreditService>. pinDebitCreditService_ ebtCategory PIN Debit Processing Using the Simple Order API <paymentType> is a new child element of <pinDebitCreditService>. pinDebitCreditService_ transactionType <paymentType> is a new child element of <pinDebitCreditService>. aft_indicator aft_serviceFee <indicator> is a new child element of <aft>. Direct Pay Using the Simple Order API <serviceFee> is a new child element of <aft>. aft_foreignExchange <foreignExchange> is a new child element of <aft>. Simple Order API Release Notes | June 2015 10 Chapter 2 Table 4 Release Notes for Versions 1.115 and 1.1116 New Request Fields for Version 1.115 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented ancillaryData_ ticketNumber <ancillaryData> is a new child element of <requestMessage>. Airline Processing Using the Simple Order APIs ancillaryData_ passengerName <ancillaryData> ancillaryData_ connectedTicket Number ancillaryData_ creditReasonIndicator ancillaryData_service service_categoryCode service_ subcategoryCode service_id <ticketNumber> <passengerName> <connectedTicketNumber> <creditReasonIndicator> <service> </ancillaryData> <service> is mapped to <service> and is a new child element of <ancillaryData>. Airline Processing Using the Simple Order API <service> <categoryCode> <subcategoryCode> <id> </service> balanceInquiry Simple Order API Release Notes | June 2015 <balanceInquiry> is a new child element of <requestMessage>. Credit Card Services Using the Simple Order API 11 Chapter 2 Release Notes for Versions 1.115 and 1.1116 New Reply Fields Table 5 New Reply Fields for Version 1.115 Name-Value Pair Field Name Notes for XML Where Field Is Documented ccAuthReply_ amountType <amountType> is a new child element of <ccAuthReply>. Credit Card Services Using the Simple Order API ccAuthReply_ accountType <accountType> is a new child element of <ccAuthReply>. Credit Card Services Using the Simple Order API Simple Order API Release Notes | June 2015 12 Chapter 2 Table 5 Release Notes for Versions 1.115 and 1.1116 New Reply Fields for Version 1.115 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented ccSalesReply_ reasonCode <ccSalesReply> is a new child element of <replyMessage>. ccSalesReply_amount <ccSalesReply> Documentation for this field will be published soon. ccSalesReply_ authorizationCode ccSalesReply_ processorResponse <reasonCode> <amount> <authorizationCode> ccSalesReply_ avsCode <processorResponse> ccSalesReply_ avsCodeRaw <avsCodeRaw> ccSalesReply_cvCode ccSalesReply_ cvCodeRaw ccSalesReply_ cavvResponseCode ccSalesReply_ cavvResponseCode Raw ccSalesReply_ cardGroup ccSalesReply_ paymentNetwork TransactionID ccSalesReply_ cardCategory ccSalesReply_ accountBalance ccSalesReply_ authorizedDateTime <avsCode> <cvCode> <cvCodeRaw> <cavvResponseCode> <cavvResponseCodeRaw> <cardGroup> <paymentNetwork TransactionID> <cardCategory> <accountBalance> <authorizedDateTime> <requestAmount> <reconciliationID> <accountBalanceCurrency> <accountBalanceSign> </ccSalesReply> ccSalesReply_ requestAmount ccSalesReply_ reconciliationID ccSalesReply_ accountBalance Currency ccSalesReply_ accountBalanceSign Simple Order API Release Notes | June 2015 13 Chapter 2 Table 5 Release Notes for Versions 1.115 and 1.1116 New Reply Fields for Version 1.115 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented ccSaleCreditReply_ reasonCode <ccSalesCreditReply> is a new child element of <replyMessage>. ccSaleCreditReply_ amount <ccSalesCreditReply> Documentation for this field will be published soon. ccSaleCreditReply_ authorizationCode <reasonCode> <amount> ccSaleCreditReply_ processorResponse <authorizationCode> ccSaleCreditReply_ authorizedDateTime <authorizedDateTime> <processorResponse> <reconciliationID> ccSaleCreditReply_ reconciliationID <paymentNetwork ccSaleCreditReply_ paymentNetwork TransactionID TransactionID> ccSalesReversalReply _reasonCode <ccSalesReversalReply> is a ccSalesReversalReply _amount ccSalesReversalReply _authorizationCode ccSalesReversalReply _processorResponse </ccSalesCreditReply> new child element of <replyMessage>. Documentation for this field will be published soon. <ccSalesReversalReply> <reasonCode> <amount> <authorizationCode> ccSalesReversalReply _reconciliationID <processorResponse> ccSalesReversalReply _requestDateTime <requestDateTime> <reconciliationID> </ccSalesReversalReply> pinDebitPurchase Reply_accountType <accountType> is a new child element of <pinDebitPurchaseReply>. pinDebitPurchase Reply_amountType <amountType> is a new child element of <pinDebitPurchaseReply>. pinDebitPurchase Reply_accountBalance element of PIN Debit Processing Using the Simple Order API <accountBalance> is a new child <pinDebitPurchaseReply>. pinDebitPurchase Reply_accountBalance Currency new child element of pinDebitPurchase Reply_ accountBalanceSign child element of Simple Order API Release Notes | June 2015 <accountBalanceCurrency> is a <pinDebitPurchaseReply>. <accountBalanceSign> is a new <pinDebitPurchaseReply>. 14 Chapter 2 Table 5 Release Notes for Versions 1.115 and 1.1116 New Reply Fields for Version 1.115 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented airlineData_ creditReasonIndicator <creditReasonIndicator> is a new child element of <airlineData>. Documentation for this field will be published soon. airlineData_ ticketUpdateIndicator <ticketUpdateIndicator> is a new child element of <airlineData>. Documentation for this field will be published soon. Simple Order API Release Notes | June 2015 15 Chapter 2 Release Notes for Versions 1.115 and 1.1116 Version 1.116 New Request Fields Table 6 New Request Fields for Version 1.116 Name-Value Pair Field Name Notes for XML Where Field Is Documented <overridePaymentMethod> is a Documentation for this field will be published soon. ccSaleCreditService_ overridePayment Method new child element of dmeService_ eventType <dmeService> is a new child element of <requestMessage>. dmeService_ eventReply <dmeService> <ccSaleCreditService>. Documentation for this field will be published soon. <eventType> <eventReply> </dmeService> billTo_ custsomerUserName <overridePaymentMethod> is a new child element of <ccSaleCreditService>. Documentation for this field will be published soon. New Reply Fields Table 7 New Reply Fields for Version 1.116 Name-Value Pair Field Name Notes for XML Where Field Is Documented dmeReply_eventType <dmeReply> is a new child element of <replyMessage>. Documentation for this field will be published soon. dmeReply_eventInfo dmeReply_ eventHotListInfo <dmeReply> <eventType> dmeReply_eventPolicy <eventInfo> dmeReply_ additionalFields <eventHotListInfo> <eventPolicy> <additionalFields> </dmeReply> Simple Order API Release Notes | June 2015 16 Chapter 2 Table 7 Release Notes for Versions 1.115 and 1.1116 New Reply Fields for Version 1.116 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented field_provider <field> is mapped to <additionalFields> and is a new child element of <dmeReply>. Documentation for this field will be published soon. field_name field_value <field> <provider> <name> <value> </service> Simple Order API Release Notes | June 2015 17 CHAPTER 3 Release Notes for Versions 1.113 and 1.1114 Version 1.113 New Request Fields Table 8 New Request Fields for Version 1.113 Name-Value Pair Field Name Notes for XML Where Field Is Documented octService_ commerceIndicator <octService> is a new child element of <requestMessage>. Direct Pay Using the Simple Order API octService_ reconciliationID <octService> <commerceIndicator> <reconciliationID> </octService> invoiceHeader_ businessApplicationID <businessApplicationID> is a new child element of Direct Pay Using the Simple Order API <invoiceHeader>. recipient_name Simple Order API Release Notes | June 2015 <name> is a new child element of <recipient>. Direct Pay Using the Simple Order API 18 Chapter 3 Table 8 Release Notes for Versions 1.113 and 1.1114 New Request Fields for Version 1.113 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented sender_ referenceNumber <sender> is a new child element of <requestMessage>. Direct Pay Using the Simple Order API sender_ sourceOfFunds <sender> sender_name sender_address <referenceNumber> <sourceOfFunds> <name> sender_city <address> sender_state sender_postalCode sender_country <city> <state> <postalCode> <country> </sender> Simple Order API Release Notes | June 2015 19 Chapter 3 Release Notes for Versions 1.113 and 1.1114 New Reply Fields Table 9 New Reply Fields for Version 1.113 Name-Value Pair Field Name Notes for XML Where Field Is Documented octReply_reasonCode <octReply> is a new child element of <replyMessage>. Direct Pay Using the Simple Order API octReply_ requestDateTime octReply_ reconciliationID octReply_ processorResponse <octReply> <reasonCode> <requestDateTime> <reconciliationID> octReply_ approvalCode <processorResponse> octReply_amount <amount> <approvalCode> </octReply> Version 1.114 New Request Fields Table 10 New Request Fields for Version 1.114 Name-Value Pair Field Name Notes for XML Where Field Is Documented ccCaptureService_ sequence <sequence> is a new child element of <ccCaptureService>. Credit Card Services Using the Simple Order API ccCaptureService_ totalCount <totalCount> is a new child element of <ccCaptureService>. Credit Card Services Using the Simple Order API Simple Order API Release Notes | June 2015 20 CHAPTER 4 Release Notes for Version 1.112 Version 1.112 New Request Fields Table 11 New Request Fields for Version 1.112 Name-Value Pair Field Name Notes for XML Where Field Is Documented billTo_district <district> is a new child element of <billTo>. Credit Card Services Using the Simple Order API ecDebitService_ effectiveDate <effectiveDate> is a new child element of <ecDebitService>. Documentation for this field will be published soon. ecCreditService_ effectiveDate <effectiveDate> is a new child element of <ecCreditService>. Documentation for this field will be published soon. Simple Order API Release Notes | June 2015 21 CHAPTER Release Notes for Version 1.111 5 Version 1.111 There are no field changes in this version. Simple Order API Release Notes | June 2015 22 CHAPTER Release Notes for Version 1.110 6 Version 1.110 There are no field changes in this version. Simple Order API Release Notes | June 2015 23 CHAPTER 7 Release Notes for Versions 1.108 and 1.109 Version 1.108 New Request Fields Table 12 New Request Fields for Version 1.108 Name-Value Pair Field Name Notes for XML Where Field Is Documented ccCaptureService_ reconciliationID Alternate <reconciliationIDAlternate> Documentation for this field will be published soon. ccCreditService_ reconciliationID Alternate <reconciliationIDAlternate> is a new child element of <ccCaptureService>. is a new child element of <ccCreditService>. Documentation for this field will be published soon. New Reply Fields Table 13 New Reply Fields for Version 1.108 Name-Value Pair Field Name vcReply_customData Notes for XML Where Field Is Documented <customData> is a new child element Visa Checkout Using the Simple Order API of <vcReply>. vcCustomData_name vcCustomData_value vcCustomData_id <vcCustomData> is mapped to <customData> and is a new child element of <vcReply>. Visa Checkout Using the Simple Order API <vcCustomData> <name> <value> <id> </vcCustomData> Simple Order API Release Notes | June 2015 24 Chapter 7 Release Notes for Versions 1.108 and 1.109 Removed Reply Fields Table 14 Removed Reply Field for Version 1.108 Name-Value Pair Field Name Notes for XML vcReply_ merchantCustomData <merchantCustomData> was removed from the <vcReply> element. Version 1.109 New Request Fields Table 15 New Request Fields for Version 1.109 Name-Value Pair Field Name ccAuthService_ overridePayment Method Notes for XML Where Field Is Documented <overridePaymentMethod> is a Credit Card Services Using the Simple Order API new child element of <ccAuthService>. ccIncrementalAuth Service_ authRequestID <ccIncrementalAuthService> ccIncrementalAuth Service_duration <ccIncrementalAuthService> is a new child element of <requestMessage>. Documentation for these fields will be published soon. <authRequestID> <duration> </ccIncrementalAuthService> invoiceHeader_ totalTaxTypeCode <totalTaxTypeCode> is a new child element of <invoiceHeader>. Documentation for this field will be published soon. invoiceHeader_ cardAcceptorRef Number <cardAcceptorRefNumber> is a new child element of Documentation for this field will be published soon. invoiceHeader_ authorizedContact Name new child element of item_ taxStatusIndicator Simple Order API Release Notes | June 2015 <invoiceHeader>. <authorizedContactName> is a <invoiceHeader>. <taxStatusIndicator> is a new child element of <item>. Documentation for this field will be published soon. Documentation for this field will be published soon. 25 Chapter 7 Table 15 Release Notes for Versions 1.108 and 1.109 New Request Fields for Version 1.109 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented item_ discountManagement Indicator <discountManagement Indicator> is a new child element of <item>. Documentation for this field will be published soon. item_typeOfSupply <typeOfSupply> is a new child element of <item>. Documentation for this field will be published soon. item_sign <sign> is a new child element of <item>. Documentation for this field will be published soon. Simple Order API Release Notes | June 2015 26 Chapter 7 Table 15 Release Notes for Versions 1.108 and 1.109 New Request Fields for Version 1.109 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented lodgingData_ checkInDate <lodgingData> is a new child element of <requestMessage>. lodgingData_ checkOutDate <lodgingData> Documentation for these fields will be published soon. lodgingData_ dailyRoomRate1 <checkInDate> <checkOutDate> lodgingData_ dailyRoomRate2 <dailyRoomRate1> lodgingData_ dailyRoomRate3 <dailyRoomRate3> <dailyRoomRate2> <roomNights1> lodgingData_ roomNights1 lodgingData_ roomNights2 lodgingData_ roomNights3 lodgingData_ guestSmoking Preference lodgingData_ numberOfRooms Booked lodgingData_ numberOfGuests lodgingData_ roomBedType lodgingData_ roomTaxElements lodgingData_ roomRateType lodgingData_ guestName <roomNights2> <roomNights3> <guestSmokingPreference> <numberOfRoomsBooked> <numberOfGuests> <roomBedType> <roomTaxElements> <roomRateType> <guestName> <customerServicePhone Number> <corporateClientCode> <promotionalCode> <additionalCoupon> <roomLocation> <specialProgramCode> <tax> <prepaidCost> <foodAndBeverageCost> <roomTax> <adjustmentAmount> <phoneCost> <restaurantCost> <roomServiceCost> Simple Order API Release Notes | June 2015 27 Chapter 7 Table 15 Release Notes for Versions 1.108 and 1.109 New Request Fields for Version 1.109 (Continued) Name-Value Pair Field Name Notes for XML lodgingData_ customerService PhoneNumber <minibarCost> lodgingData_ corporateClientCode <miscellaneousCost> lodgingData_ promotionalCode <movieCost> Where Field Is Documented <laundryCost> <giftShopCost> <healthClubCost> lodgingData_ additionalCoupon lodgingData_ roomLocation lodgingData_ specialProgramCode lodgingData_tax <valetParkingCost> <cashDisbursementCost> <nonRoomCost> <businessCenterCost> <loungeBarCost> lodgingData_ prepaidCost <transportationCost> lodgingData_ foodAndBeverageCost <conferenceRoomCost> <gratuityCost> <audioVisualCost> lodgingData_roomTax lodgingData_ adjustmentAmount lodgingData_ phoneCost lodgingData_ restaurantCost lodgingData_ roomServiceCost <banquetCost> <internetAccessCost> <earlyCheckOutCost> <nonRoomTax> <travelAgencyCode> <travelAgencyName> </lodgingData> lodgingData_ minibarCost lodgingData_ laundryCost lodgingData_ miscellaneousCost lodgingData_ giftShopCost lodgingData_ movieCost lodgingData_ healthClubCost Simple Order API Release Notes | June 2015 28 Chapter 7 Table 15 Release Notes for Versions 1.108 and 1.109 New Request Fields for Version 1.109 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented otherTax_ vatTaxAmountSign <vatTaxAmountSign> is a new child element of <otherTax>. Documentation for this field will be published soon. paymentNetworkToken _originalCardCategory <originalCardCategory> is a Payment Network Tokenization Supplement lodgingData_ valetParkingCost lodgingData_ cashDisbursement Cost lodgingData_ nonRoomCost lodgingData_ businessCenterCost lodgingData_ loungeBarCost lodgingData_ transportationCost lodgingData_ gratuityCost lodgingData_ conferenceRoomCost lodgingData_ audioVisualCost lodgingData_ banquetCost lodgingData_ internetAccessCost lodgingData_ earlyCheckOutCost lodgingData_ nonRoomTax lodgingData_ travelAgencyCode lodgingData_ travelAgencyName new child element of <paymentNetworkToken>. pinDebitPurchase Service_ overridePayment Method Simple Order API Release Notes | June 2015 <overridePaymentMethod> is a new child element of <pinDebitPurchaseService>. Documentation for this field will be published soon. 29 Chapter 7 Table 15 Release Notes for Versions 1.108 and 1.109 New Request Fields for Version 1.109 (Continued) Name-Value Pair Field Name pinDebitCreditService_ overridePayment Method Notes for XML Where Field Is Documented <overridePaymentMethod> is a Documentation for this field will be published soon. new child element of <pinDebitCreditService>. promotion_ postTaxDiscount Indicator <postTaxDiscountIndicator> promotionGroup_ subtotalAmount <promotionGroup> is a new child element of <requestMessage>. promotionGroup_ taxRate <promotionGroup> promotionGroup_id is a new child element of <promotion>. Documentation for this field will be published soon. Documentation for these fields will be published soon. <subtotalAmount> <taxRate> <id> </promotionGroup> purchaseTotals_ discountAmountSign <purchaseTotals>. Documentation for this field will be published soon. purchaseTotals_ discountManagement Indicator <discountManagement Indicator> is a new child element of <purchaseTotals>. Documentation for this field will be published soon. purchaseTotals_ dutyAmountSign <dutyAmountSign> is a new child element of <purchaseTotals>. Documentation for this field will be published soon. purchaseTotals_ freightAmountSign <freightAmountSign> is a new child element of Documentation for this field will be published soon. <discountAmountSign> is a new child element of <purchaseTotals>. taxManagement Indicator <taxManagementIndicator> is a new child element of <requestMessage>. wallet_type <wallet> is a new child element of <requestMessage>. <wallet> Documentation for this field will be published soon. Credit Card Services Using the Simple Order API <type> </wallet> Simple Order API Release Notes | June 2015 30 Chapter 7 Release Notes for Versions 1.108 and 1.109 New Reply Fields Table 16 New Reply Fields for Version 1.09 Name-Value Pair Field Name Notes for XML Where Field Is Documented emvReply_ chipValidationResults <chipValidationResults> is a new child element of <emvReply>. Payment Network Tokenization Supplement emvReply_ chipValidationType <chipValidationType> is a new child element of <emvReply>. Payment Network Tokenization Supplement promotionGroupReply _discountApplied <promotionGroupReply> is a Documentation for these fields will be published soon. promotionGroupReply _id new child element of <replyMessage>. <promotionGroupReply> <discountApplied> <id> </promotionGroupReply> ccIncrementalAuth Reply_reasonCode ccIncrementalAuth Reply_amount <ccIncrementalAuthReply> is a new child element of <replyMessage>. Documentation for these fields will be published soon. <ccIncrementalAuthReply> ccIncrementalAuth Reply_ authorizationCode <reasonCode> ccIncrementalAuth Reply_ processorResponse <authorizationCode> <amount> <processorResponse> <authorizedDateTime> ccIncrementalAuth Reply_ authorizedDateTime ccIncrementalAuth Reply_reconciliationID ccIncrementalAuth Reply_ paymentNetwork TransactionID <reconciliationID> <paymentNetwork TransactionID> <cardCategory> </ccIncrementalAuthReply> ccIncrementalAuth Reply_cardCategory Simple Order API Release Notes | June 2015 31 Chapter 7 Release Notes for Versions 1.108 and 1.109 Newly Documented Request Fields Table 17 Newly Documented Request Fields Name-Value Pair Field Name Where Field Is Documented Notes ccCaptureService_ gratuityAmount Retail POS Processing for the Simple Order API This field was originally documented in Version 1.69 paymentNetworkToken_ requestorID Payment Network Tokenization Supplement This field was originally documented in Version 1.101. Newly Documented Reply Fields Table 18 Newly Documented Reply Fields Name-Value Pair Field Name Where Field Is Documented Notes paymentNetworkToken_ assuranceLevel Payment Network Tokenization Supplement This field was originally documented in Version 1.101. paymentNetworkToken_ accountStatus Payment Network Tokenization Supplement This field was originally documented in Version 1.101. Simple Order API Release Notes | June 2015 32 CHAPTER 8 Release Notes for Versions 1.106 and 1.107 Version 1.106 New Request Fields Table 19 New Request Fields for Version 1.106 Name-Value Pair Field Name Notes for XML Where Field Is Documented ccCaptureService_ dpdeBillingMonth <dpdeBillingMonth> is a new Documentation for this field will be published soon. child element of <ccCaptureService>. ccCreditService_ dpdeBillingMonth <dpdeBillingMonth> is a new child element of <ccCreditService>. Simple Order API Release Notes | June 2015 Documentation for this field will be published soon. 33 Chapter 8 Release Notes for Versions 1.106 and 1.107 Version 1.107 New Reply Fields Table 20 New Reply Fields for Version 1.107 Name-Value Pair Field Name Notes for XML Where Field Is Documented decryptVisaCheckout DataReply_ reasonCode <decryptVisaCheckoutData Reply> is a new child element of <replyMessage>. Visa Checkout Using the Simple Order API <decryptVisaCheckoutData Reply> <reasonCode> </decryptVisaCheckoutData Reply> Newly Documented Request Fields Table 21 Newly Documented Request Fields Name-Value Pair Field Name Where Field Is Documented Notes encryptedPayment_ descriptor Credit Card Services Supplement for Apple Pay This field was originally documented in Version 1.104. encryptedPayment_data Credit Card Services Using the Simple Order API and Credit Card Services Supplement for Apple Pay This field was originally documented in Version 1.104. encryptedPayment_ encoding Credit Card Services Supplement for Apple Pay This field was originally documented in Version 1.104. encryptedPayment_ wrappedKey Credit Card Services Using the Simple Order API This field was originally documented in Version 1.104. paymentNetworkToken_ transactionType Payment Network Tokenization Supplement This field was originally documented in Version 1.104. Simple Order API Release Notes | June 2015 34 Chapter 8 Table 21 Release Notes for Versions 1.106 and 1.107 Newly Documented Request Fields (Continued) Name-Value Pair Field Name Where Field Is Documented Notes paymentSolution Credit Card Services Using the Simple Order API and Credit Card Services Supplement for Apple Pay This field was originally documented in Version 1.104. card_prefix Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. decryptVisaCheckout DataService_run Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. shipTo_id Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. shipTo_ addressVerificationStatus Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vc_orderID Credit Card Services Using the Simple Order API This field was originally documented in Version 1.105. Simple Order API Release Notes | June 2015 35 Chapter 8 Release Notes for Versions 1.106 and 1.107 Newly Documented Reply Fields Table 22 Newly Documented Reply Fields Name-Value Pair Field Name Where Field Is Documented Notes card_suffix Visa Checkout Using the Simple Order API This field was originally documented in Version 1.101. vcReply_ creationTimeStamp Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ alternateShipping AddressCountryCode Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ alternateShipping AddressPostalCode Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ vcAccountLoginName Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ vcAccountFirstName Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ vcAccountLastName Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ vcAccountEncryptedID Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_vcAccountEmail Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ vcAccountMobile PhoneNumber Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ merchantReferenceID Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_subtotalAmount Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ shippingHandling Amount Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_taxAmount Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_discountAmount Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_giftWrapAmount Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ uncategorizedAmount Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. Simple Order API Release Notes | June 2015 36 Chapter 8 Table 22 Release Notes for Versions 1.106 and 1.107 Newly Documented Reply Fields (Continued) Name-Value Pair Field Name Where Field Is Documented Notes vcReply_ totalPurchaseAmount Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ walletReferenceID Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_promotionCode Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ merchantCustomData Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ paymentInstrumentID Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ codeVerificationStatus Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_issuerID Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ paymentInstrument NickName Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_nameOnCard Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_cardType Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_cardGroup Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_cardArt Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_riskAdvice Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_riskScore Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ riskAdditionalData Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_avsCodeRaw Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_cvnCodeRaw Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_eciRaw Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_eci Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_cavv Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. Simple Order API Release Notes | June 2015 37 Chapter 8 Table 22 Release Notes for Versions 1.106 and 1.107 Newly Documented Reply Fields (Continued) Name-Value Pair Field Name Where Field Is Documented Notes vcReply_veresEnrolled Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_veresTimeStamp Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_paresEnrolled Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_ paresTimeStamp Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcReply_xid Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcCardArt_filename Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcCardArt_height Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcCardArt_width Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. vcCardArt_id Visa Checkout Using the Simple Order API This field was originally documented in Version 1.105. Simple Order API Release Notes | June 2015 38 CHAPTER 9 Release Notes for Versions 1.104 and 1.105 Version 1.104 New Request Fields Table 23 New Request Fields for Version 1.104 Name-Value Pair Field Name paymentNetworkToken _transactionType Notes for XML Where Field Is Documented <transactionType> is a new child Documentation for this field will be published soon. element of <paymentNetworkToken>. paymentSolution <paymentSolution> is a new child element of <requestMessage>. Documentation for this field will be published soon. encryptedPayment_ descriptor <encryptedPayment> is a new Documentation for these fields will be published soon. encryptedPayment_ data encryptedPayment_ encoding encryptedPayment_ wrappedKey child element of <requestMessage>. <encryptedPayment> <descriptor> <data> <encoding> <wrappedKey> </encryptedPayment> Simple Order API Release Notes | June 2015 39 Chapter 9 Release Notes for Versions 1.104 and 1.105 Version 1.105 New Request Fields Table 24 New Request Fields for Version 1.105 Name-Value Pair Field Name Notes for XML Where Field Is Documented shipTo_id <id> is a new child element of <shipTo>. Documentation for this field will be published soon. shipTo_ addressVerification Status <addressVerification Status> is a new child element of <shipTo>. Documentation for this field will be published soon. card_prefix <prefix> is a new child element of <card>. Documentation for this field will be published soon. vc_orderID <vc> is a new child element of <requestMessage>. Documentation for this field will be published soon. <vc> <orderID> </vc> decryptVisaCheckout DataService Simple Order API Release Notes | June 2015 <decryptVisaCheckoutData Service> is a new child element of <requestMessage>. Documentation for this field will be published soon. 40 Chapter 9 Release Notes for Versions 1.104 and 1.105 New Reply Fields Table 25 New Reply Fields for Version 1.105 Name-Value Pair Field Name Notes for XML Where Field Is Documented vcReply_ creationTimeStamp <vcReply> is a new child element of <replyMessage>. vcReply_ alternateShipping AddressCountryCode <vcReply> Documentation for these fields will be published soon. vcReply_ alternateShipping AddressPostalCode vcReply_ vcAccountLoginName vcReply_ vcAccountFirstName vcReply_ vcAccountLastName vcReply_ vcAccountEncryptedID vcReply_ vcAccountEmail <creationTimeStamp> <alternateShipping AddressCountryCode> <alternateShipping AddressPostalCode> <vcAccountLoginName> <vcAccountFirstName> <vcAccountLastName> <vcAccountEncryptedID> <vcAccountEmail> <vcAccountMobile PhoneNumber> <merchantReferenceID> vcReply_ vcAccountMobile PhoneNumber <subtotalAmount> vcReply_ merchantReferenceID <taxAmount> vcReply_ subtotalAmount <shippingHandlingAmount> <discountAmount> <giftWrapAmount> vcReply_ shippingHandling Amount <uncategorizedAmount> vcReply_taxAmount <walletReferenceID> vcReply_ discountAmount <promotionCode> vcReply_ giftWrapAmount <paymentInstrumentID> vcReply_ uncategorizedAmount vcReply_ totalPurchaseAmount <totalPurchaseAmount> <merchantCustomData> <codeVerificationStatus> <issuerID> <paymentInstrument NickName> <nameOnCard> Simple Order API Release Notes | June 2015 41 Chapter 9 Table 25 Release Notes for Versions 1.104 and 1.105 New Reply Fields for Version 1.105 (Continued) Name-Value Pair Field Name vcReply_ walletReferenceID vcReply_ promotionCode Notes for XML <cardType> <cardGroup> <cardArt> vcReply_ merchantCustomData <riskAdvice> vcReply_ paymentInstrumentID <riskAdditionalData> vcReply_ codeVerificationStatus <riskScore> <avsCodeRaw> <cvnCodeRaw> vcReply_issuerID <eciRaw> vcReply_ paymentInstrument NickName <eci> vcReply_nameOnCard <veresEnrolled> vcReply_cardType <veresTimeStamp> vcReply_cardGroup <paresEnrolled> vcReply_cardArt <paresTimeStamp> vcReply_riskAdvice <xid> vcReply_riskScore Where Field Is Documented <cavv> </vcReply> vcReply_ riskAdditionalData vcReply_avsCodeRaw vcReply_cvnCodeRaw vcReply_eciRaw vcReply_eci vcReply_cavv vcReply_veresEnrolled vcReply_ veresTimeStamp vcReply_paresEnrolled vcReply_ paresTimeStamp vcReply_xid Simple Order API Release Notes | June 2015 42 Chapter 9 Table 25 Release Notes for Versions 1.104 and 1.105 New Reply Fields for Version 1.105 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented vcCardArt_filename <vcCardArt> is a new child element of <vcReply>. Documentation for these fields will be published soon. vcCardArt_height vcCardArt_width vcCardArt_id <vcCardArt> <filename> <height> <width> <id> </vcCardArt> Simple Order API Release Notes | June 2015 43 CHAPTER Release Notes for Versions 1.102 and 1.103 10 Version 1.102 New Request Fields Table 26 New Request Fields for Version 1.102 Name-Value Pair Field Name Notes for XML Where Field Is Documented ccAuthService_ duration <duration> is a new child element of <ccAuthService>. Documentation for this field will be published soon. ccCaptureService_ duration <duration> is a new child element of <ccCaptureService>. Documentation for this field will be published soon. ccCreditService_ duration <duration> is a new child element of <ccCreditService>. Documentation for this field will be published soon. Simple Order API Release Notes | June 2015 44 Chapter 10 Table 26 Release Notes for Versions 1.102 and 1.103 New Request Fields for Version 1.102 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented autoRentalData_ adjustmentCost <autoRentalData> is a new child element of <requestMessage>. autoRentalData_ adjustmentCode <autoRentalData> Documentation for these fields will be published soon. autoRentalData_ agreementNumber autoRentalData_ classCode autoRentalData_ customerService PhoneNumber autoRentalData_ dailyRate autoRentalData_ mileageCost autoRentalData_ gasCost <adjustmentCost> <adjustmentCode> <agreementNumber> <classCode> <customerServicePhone Number> <dailyRate> <mileageCost> <insuranceCost> <lateReturnCost> <maximumFreeMiles> autoRentalData_ insuranceCost <milesTraveled> autoRentalData_ lateReturnCost <parkingViolationCost> <oneWayCost> <pickUpCity> autoRentalData_ maximumFreeMiles autoRentalData_ milesTraveled autoRentalData_ oneWayCost autoRentalData_ parkingViolationCost <pickUpCountry> <pickUpDate> <pickUpState> <pickUpTime> <ratePerMile> <renterName> autoRentalData_ pickUpCity <returnCity> autoRentalData_ pickUpCountry <returnDate> autoRentalData_ pickUpDate autoRentalData_ pickUpState autoRentalData_ pickUpTime <returnCountry> <returnLocationID> <returnState> <returnTime> <specialProgramCode> </autoRentalData> autoRentalData_ ratePerMile Simple Order API Release Notes | June 2015 45 Chapter 10 Table 26 Release Notes for Versions 1.102 and 1.103 New Request Fields for Version 1.102 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented autoRentalData_ renterName autoRentalData_ returnCity autoRentalData_ returnCountry autoRentalData_ returnDate autoRentalData_ returnLocationID autoRentalData_ returnState autoRentalData_ returnTime autoRentalData_ specialProgramCode Simple Order API Release Notes | June 2015 46 Chapter 10 Release Notes for Versions 1.102 and 1.103 Version 1.103 New Request Fields Table 27 New Request Fields for Version 1.103 Name-Value Pair Field Name Notes for XML Where Field Is Documented deviceFingerprintRaw <deviceFingerprintRaw> is a Documentation for this field will be published soon. new child element of <requestMessage>. deviceFingerprintHash <deviceFingerprintHash> is a new child element of <requestMessage>. CyberSource Decision Manager Device Fingerprinting Guide, which is available on the Documentation page of the Business Center. New Reply Fields Table 28 New Reply Fields for Version 1.103 Name-Value Pair Field Name Notes for XML Where Field Is Documented bankTransferRefund Reply_iban <iban> is a new child element of <bankTransferRefundReply>. Documentation for this field will be published soon. directDebitReply_iban <iban> is a new child element of <directDebitReply>. Documentation for this field will be published soon. directDebitRefund Reply_iban <iban> is a new child element of <directDebitRefundReply>. Documentation for this field will be published soon. Simple Order API Release Notes | June 2015 47 Chapter 10 Release Notes for Versions 1.102 and 1.103 Newly Documented Request Fields Table 29 Newly Documented Request Fields Name-Value Pair Field Name Where Field Is Documented Notes ecAuthenticateService_ run Electronic Check Services Using the Simple Order API This field was originally documented in Version 1.48. ecAuthenticateService_ referenceNumber Electronic Check Services Using the Simple Order API This field was originally documented in Version 1.48. check_authenticateID Electronic Check Services Using the Simple Order API This field was originally documented in Version 1.48. Simple Order API Release Notes | June 2015 48 CHAPTER Release Notes for Versions 1.100 and 1.101 11 Version 1.100 New Reply Fields Table 30 New Reply Fields for Version 1.100 Name-Value Pair Field Name Notes for XML 14 new reply fields were added for Device Fingerprinting. Where Field Is Documented CyberSource Decision Manager Device Fingerprinting Guide, which is available on the Documentation page of the Business Center. Version 1.101 New Request Fields Table 31 New Request Fields for Version 1.101 Name-Value Pair Field Name paymentNetworkToken _requestorID Notes for XML Where Field Is Documented <paymentNetworkToken> is a new Documentation for this field will be published soon. child element of <requestMessage>. <paymentNetworkToken> <requestorID> </paymentNetworkToken> Simple Order API Release Notes | June 2015 49 Chapter 11 Table 31 Release Notes for Versions 1.100 and 1.101 New Request Fields for Version 1.101 (Continued) Name-Value Pair Field Name Notes for XML Where Field Is Documented recipient_dateOfBirth <recipient> is a new child element of <requestMessage>. Credit Card Services Using the Simple Order API recipient_postalCode recipient_accountID recipient_lastName <recipient> <dateOfBirth> <postalCode> <accountID> <lastName> </recipient> authIndicator <authIndicator> is a new child element of <requestMessage>. Credit Card Services Using the Simple Order API New Reply Fields Table 32 New Reply Fields for Version 1.101 Name-Value Pair Field Name Notes for XML Where Field Is Documented card_suffix <suffix> is a new child element of <card>. Documentation for this field will be published soon. paymentNetworkToken _assuranceLevel <paymentNetworkToken> is a new child element of <replyMessage>. paymentNetworkToken _accountStatus <paymentNetworkToken> Documentation for these fields will be published soon. <assuranceLevel> <accountStatus> </paymentNetworkToken> Simple Order API Release Notes | June 2015 50 CHAPTER Release Notes for Version 1.99 12 Version 1.99 New Reply Field Table 33 New Reply Field for Version 1.99 Name-Value Pair Field Name pos_ terminalIDAlternate Notes for XML Where Field Is Documented <terminalIDAlternate> is a new Retail POS Processing Using the Simple Order API child element of <pos>. Newly Documented Request Field Table 34 Newly Documented Request Field Name-Value Pair Field Name Where Field Is Documented Notes serviceFeeCalculate Service_run Service Fee Processing Using the Simple Order API This field was originally documented in Version 1.84. Simple Order API Release Notes | June 2015 51 Chapter 12 Release Notes for Version 1.99 Newly Documented Reply Fields Table 35 Newly Documented Reply Fields Name-Value Pair Field Name Where Field Is Documented Notes serviceFeeCalculateReply _reasonCode Service Fee Processing Using the Simple Order API These fields were originally documented in Version 1.84. serviceFeeCalculateReply _amount serviceFeeCalculateReply _requestDateTime Simple Order API Release Notes | June 2015 52
© Copyright 2024