Changelog

This changelog lists all additions and updates to the integration, in chronological order:

Ver.	Date	Author	Update information
1	30/11/2019	N Turner	New guide replacing original separate Hosted and Direct Integration Guides.
1.01	24/08/2020	N Turner	Updated Test Amounts to include settlement outcome in test amounts table.
1.02	23/09/2020	N Turner	Updated Example Integration Code Direct Integration Sale Transaction (with 3-D Secure) and Example Library Code Direct Sale Transaction (with 3-D Secure) for 3DS v2.
1.03	22/10/2020	N Turner	Updated 3-D Secure Options (Hosted and Direct Integration) section to reflect changes to 3DS options.
1.04	25/10/2020	N Turner	Removed CUROPT_SSL_VERIFYPEER from sample code.
1.05	25/11/2020	N Turner	Removed threeDSVersion and merchantCategoryCode fields from sample code.
1.06	07/12/2020	N Turner	Replaced Merchant ID and MID with Merchant Account ID. Updated Transaction Types section to indicate specific MOTO or CA account may be required.
1.07	08/12/2020	N Turner	Added detailing Visa Stored Credentials Framework (Credentials on File).
1.08	23/01/2021	N Turner	Updated Digital Wallet Transactions section to add Google Pay details.
1.09	28/01/2021	N Turner	Corrected ‘AmazonPay’ to ‘Amazon Pay’ and other minor spelling corrections.
1.1	03/02/2021	N Turner	Removed details for eReceipts integration.
1.11	21/02/2021	N Turner	Updated Integration Testing section to detail 3DS response simulation.
1.12	18/03/2021	N Turner	Added Digital Wallet Tokens section covering the features of Digital Wallet Payment Tokens.
1.13	23/03/2021	N Turner	Updated Integration Testing section to add SCA soft-decline test amounts.
1.14	13/06/2021	N Turner	Revised Card Identification section adding more details and support for Discover and Diners Club. Updated Integration Testing section to add further testing details for Referral response testing. Corrected mistakes in the available threeDSOptionsin the 3-D Secure Options (Hosted and Direct Integration) section. Amended Field Formats section to remove XML format and explain how to pass boolean values. Added rtAgreementType, rtSequenceCount and rtSequenceNumber fields to the Request Fields section. Added rtSequenceCount and rtSequenceNumber fields to the Transaction Types - Continuous Authority section. Corrected the descriptions for response code’s 65794 and 65796 in the Response Codes section. Removed the text ‘(reserved for future use)’ from response code descriptions in the Response Codes section. Reformatted CSS selectors and attribute names and added details regarding custom fonts to the Hosted Fields Styling section. Added formAmountEditable field to the Hosted Payment Page Options section. Updated threeDSEnrolled and threeDSAuthenticated values in 3-D Secure and Retry Transaction Advice Codes sections.
1.15	16/06/2021	N Turner	Added further explanations and updated the response codes in the Response Codes section..
1.16	22/07/2021	S Fowle	Added links to fields mentioned in Response Codes in the Response Codes section. Updated Response Code descriptions in in the Response Codes section. Anonymised content, removing any specific URLs, Merchant Account IDs, etc.
1.17	14/08/2021	N Turner	Various formatting changes and clarifications. Added more details to sections HTTP Requests and Field Formats sections. Added details on how to switch between latest and legacy 3-D Secure responses to the 3-D Secure - Hosted Implementation section. Updated details about mandatory 3-D Secure information to sections the 3-D Secure - Hosted Implementation, Direct Implementation and 3-D Secure Options (Hosted and Direct Integration) sections. Updated details regarding complex fields threeDSRequest, threeDSResponse, checkoutRequest and checkoutResponse to sections 3-D Secure - Direct Implementation, PayPal Transactions - Direct Implementation and Amazon Pay - Direct Implementation. Updated details on 3-D Secure requests in the Request and Response field sections. Added details on 3-D Secure fallback to version 1 and PSD2 SCA in the Advanced Features section. Added PSD2 SCA Compliance and exemptions to the Credentials on File Matrix. Added clarification that Hosted Fields can be used with standard fields to the Hosted Payment Fields Library section. Updated and moved Hosted Payment Form Options to the Hosted Payment Page Options section. Moved details on Duplicate Transaction checking section. Revised details on Delaying Capture and Settlement. Moved details on Recurring transaction and Credentials on File to Integration Testing section. Removed rtSequenceCount and rtSequenceNumber fields from the New Transactions - Request Fields section. Added details on Acquirer specific options and response details in the Acquirer Data section. Added card token details to the Gateway Wallet section. Updated cloned fields in the Transaction Cloning-Cloned Fields section. Added cardFlags field and ‘Scheme Code’ table column to the Card Identification section.
2	03/10/2021	N Turner	Added example threeDSOptions to code samples. Added addition information on the 3-D Secure fields to the Retry Transaction Advice Codes section. Added matrix for correct Credentials on File (COF) flagging in new section. Added more details on SCA declines and new section in SCA soft declines. Added note that Diners Club do not support AVS to the Test Cards section.
2.01	29/10/2021	N Turner	Added details on maximum transaction storage period to section Security and Compliance, Credentials on File, Recurring Transaction Agreements and Payment Tokenisation sections. Added details on maximum capture and refund periods to the Supported Actions section. Corrected capitalisation of ‘Gateway’ and ‘Card Scheme’.
2.02	19/11/2021	N Turner	Added details on Google Pay Merchant Identifier to the Google Pay Configuration section.
2.03	15/12/2021	N Turner	Added emphasis to use the callbackURL when updating backend systems to the Redirect URL section.
2.04	13/01/2022	N Turner	Correct reference to Android Pay in the Apple Pay Configuration section.
2.05	15/02/2022	N Turner	Replaced reference to ‘Hosted Payment Fields SDK Guide’ in the Hosted Integration section.
2.06	28/04/2022	N Turner	Updates in preparation of 3-D Secure version 1 being phase out. Added details on HTTP POST parameter limit in the HTTP Requests section. Corrected card flags in the Card Identification section.
3	17/05/2022	N Turner	Rewrites to how the redirectURL is handled in the Redirect URL section. Removed all references to 3-D Secure version 1 including Legacy 3-D Secure API section. Rewrite of 3-D Secure - Direct Implementation section to show direct integration steps clearer. Amended references to 3-D Secure - Direct Implementation section that should have been the Direct Implementation section.
3.01	02/06/2022	N Turner	Added list of fields which can be tokenised by the Hosted Payment Fields Library to Hosted Payment Form Library - Form Construction section. Corrected ‘data-hostedform-modal’ attribute in the Hosted Sale Transaction sample code.
3.02	09/06/2022	N Turner	Corrected response codes 935 and 936 in the Response Codes section.
3.03	25/07/2022	N Turner	Updated Payment Tokenisation section to link to the Gateway Wallet details. Updated the Digital Wallet Transactions section to cover the new Masterpass Click to Pay implementation. Updated possible values for action field in section Management Requests - Request Fields section.
3.04	03/09/2022	N Turner	Corrected some cross references.
3.05	10/09/2022	N Turner	Clarified that fields in ‘browserInfo’ are appended to the request, in the Amazon Pay and PPRO sections.
3.06	08/11/2022	N Turner	Added section heading Mandatory 3-D Secure Information to highlight mandatory 3-D Secure Information and then linked it to the ‘browserInfo’ comment in sample code in the Amazon Pay and PPRO sections. Corrected spelling of ‘hire purchase’ in Standing Instruction MITs section. Expanded the description for response code 65796 in in the Response Codes section.
3.07	24/11/2022	N Turner	Expanded the description for response code 65566 in the Response Codes section. Clarified IP address formats for remoteAddress in the New Transactions - Request Fields section., IPAD in the Risk Check Options section and browserIPAddress in the 3-D Secure Request Fields section. Clarified that the threeDSXID contains the Directory Server Transaction ID in the 3-D Secure Transaction Identifier section. Corrected section Digital Wallets - Hosted Implementation section to indicate that Digital Wallets are supported when using the Hosted Integration.
3.08	01/02/2023	N Turner	Corrected the details for a zero value duplicateDelay in the Duplicate Transaction Checking section. Corrected maximum refund period in the Supported Actions section. Corrected test 149.99 amount in the Test Amount section. Added details for rtAdviceCode and rtRetryAfter fields to the New Transactions - Response Fields and the Retry Transaction Advice Codes sections. Inserted new sections for Nomupay, Nuapay, and Qi Digital. Updated chapters PayPal, Amazon Pay and PPRO to reflect new terminology. Updated Capture Delay section to clarify what happens if capture delay results in the transaction not being captured. Moved Digital Wallet Transactions section to after to Gateway Wallet section. Removed misleading sentence from each APM section regarding which Integrations they can be used with.
3.09	09/05/2023	N Turner	Added details for rtAmountFixed field to the Credentials on File and Recurring Transaction Agreements sections. Added threeDSPolicy 7 to the SCA Using 3-D Secure section. Added formWalletRequired to appendix the Hosted Payment Page Options section.
3.10	06/09/2023	N Turner	Clarified the use of countryCode in the New Transactions - Request Fields section. Renamed 'Merchant Account Mapping' section to ‘Merchant Account Routing’ and all references to it. Altered ‘documented in’ to ‘detailed in’ to standardise terminology. Added formRedirectDelay field to the Hosted Payment Page Options section. Removed mandatory indicators for deviceAcceptContent and deviceAcceptCharset in Device Information section.
4.00	07/09/2023	S Fowle	Moved Integration Guide online.
4.01	26/03/2024	S Fowle	Reference to manual authorisations removed from the guide and removed associated appendix.
4.02	30/03/2024	N Turner	Added walletID, cardID, cardToken, customerAddressID, formSaveCardRequired and formWalletRequired to Hosted Payment Page Options section.
4.03	16/05/2024	N Turner	Added threeDSVersion to 3-D Secure External Authentication Request (Direct Integration) section. Corrected sample code in the Example Integration Code - Hosted section. Corrected spelling of paymentDateInMonth in section 26.5.2. Renamed remoteAddress to deviceIpAddress throughout and add to the Device Information Fields section. Error codes 65577, 65578, 65579, 66667 and 66923 added to the Gateway Response Codes section. cardFlags details updated in the Card Identification section.
4.04	29/05/2024	S Fowle	Confirmation of Visa 3-D Secure parameter mandatory fields (from 12 August 2024) added to 3-D Secure Authentication - Request Fields section.
4.05	01/07/2024	S Fowle	Added new Z5 and Z6 response codes to the Authorisation Response Codes section.
4.06	22/07/2024	S Fowle	Updated Credential on File text before matrix.
4.07	10/02/2025	S Fowle	Added originalResponseCode, originalResponseStatus, originalResponseMessage field details to Supported Actions section. Corrected Nomupay checkout option mobilephone to phoneNumber and added clarity to default source of checkout option values. Renamed remoteAddress to deviceIpAddress throughout and added to Advanced Data section. Updated throughout to clarify that type 2 can mean both CIT MOTO and MIT CNP depending on initiator.
4.08	12/02/2025	S Fowle	Added Blik to PPRO Payment Method Tags.
4.09	27/02/2025	N Turner	Updated Test Amounts
4.10	31/03/2025	N Turner	Amended text for General Response Code 65579
4.11	08/04/2025	J Dyer	Updated 3-D Secure Enrolment/Authentication Only section
4.12	24/04/2025	S Fowle	Added response codes 292 (5C) and 440 (9G) to the Authorisation Response Codes section.
4.13	18/05/2025	S Fowle	Updated formatting of links in guide.
4.14	27/06/2025	S Fowle	Amended text for Capture in Supported Actions section.
4.15	06/07/2025	J Dyer	Added new Pay Button section.
4.16	24/09/2025	S Fowle	Added "This integration type is deprecated from the 17th November 2025." under Nuapay section.
4.17	20/10/2025	S Fowle	Added 341(6P) and 46 response codes.
4.18	03/11/2025	S Speakman	Added OBMC section. Removed Nuapay section. Removed PBBA section.