Changelog for Ratenkauf Verkauf-V3 API ======================================= The following sections list the changes in the Ratenkauf Verkauf-V3 API definition. Summary ------- * Feature - Publish Ratenkauf V3-API (V3.75.1) * Feature - Extend initialization to consent and MTAN and return all transaction info after its initialization (V3.76.0) * Feature - Extend Patch-Endpoint for self-integration (V3.76.1) * Feature - Endpoint for creating device-Ident Token (V3.79.0) * Feature - Endpoint for self integration (init + decision) (V3.80.0) * Feature - Added company name field to initialization (V3.81.0) * Feature - Added Prod domain and authentication-free endpoint for webshop information (V3.82.0) * Feature - Add Mtan for self-integration (V3.84.0) * Feature - Add Redirect-Url to Ratenkauf site (V3.85.0) * Feature - Rename Redirect-Url field (V3.86.0) * Feature - Transaction patch Endpoint (V3.87.0) * Feature - Example Values for Transaction Api Added (V3.88.0) * Feature - Authorization Endpoint for self-integration (V3.88.1) * Feature - Move Self-Integration API to another openapi (V3.88.2) * Feature - Initialization for express checkout (V3.96.0) * Feature - Add further texts to Webshop information-Endpoint (V3.98.0) * Feature - Enable initialization for diacritics (V3.99.0) * Feature - Add further fields for payment/interest plan (V3.102.0) * Feature - Increased maximum number of products for shopping card (V3.103.0) * Feature - Add further fields on transaction information (V3.104.0) * Feature - Add further information on a transaction's decision data (V3.105.0) * Feature - Remove contact, bank and customerRelationship from Patch as it is not allowed anyways (V3.113.0) * Feature - Added max length restriction for city field (V3.114.0) * Feature - Added flexprice field (V3.120.0) * Feature - Added 'withoutFlexprice' attribute to OrderDetails. (V3.120.1) * Feature - Added 'messageDE' to Constraint Violation (V3.124.0) * Feature - Expanded max length restriction for city field (V3.124.1) * Feature - Added productUrl and productImageUrl to ShoppingCartInformationItem (V3.125.1) * Bugfix - Fixed pattern for orderId, firstName, lastName, birthName (V3.125.2) * Feature - Added payment type info to init endpoint (V3.132.0) * Feature - Added installment and invoice information to webshop get endpoint (V3.133.0) * Feature - Added information on maximal and minimal order value for installment- and billPayment (V3.133.1) * Feature - Removed static min- and max-values for transaction patch (V3.125.0) * Feature - Added support for HmacSha256 body signature authentication (V3.138.0) * Feature - Added field originalInterest to the interest object (V3.150.0) * Feature - Added information about active interest rate flexibilisation to webshop endpoint (V3.165.0) * Feature - Added endpoint for retrieving the texts for webshops (V3.173.0) * Feature - Increased limit of additionalAddressInformation to 500 chars (V3.179.0) * Feature - Additionally to ecommerce, direct sales transactions can now be initialized (V3.184.0) * Feature - Added cancellation endpoint for direct sales shops (V3.185.0) * Feature - Added urlStatusChangeNotifyCallback field to the initialization endpoint (V3.185.1) * Feature - Removed required attribute for redirect-urls (V3.185.2) * Feature - Added field `upsellingPossible` to transactionSummary (V3.186.0) * Feature - Enabled cancellation endpoint for direct sales transaction for more statuses (V3.191.0) Details ------- * Feature - Publish Ratenkauf V3-API (V3.75.1) openapi.yaml and CHANGELOG.md files are accessible through the respective Backend-Service * Feature - Extend initialization to consent and MTAN and return all transaction info after its initialization (V3.76.0) A consent can be given when initializing a transaction. The whole transaction information will be returned after its initialization. Properties emailAdvertisement and mobileAdvertisement are now merged in advertisement. Property mobilePhoneNumberInvalid can be set for the MTAN procedure when initializing. * Feature - Extend Patch-Endpoint for self-integration (V3.76.1) The endpoint is extended to update the financing term, contact info, customer relationship data, and bank info of a specific transaction. Property skipMobilePhoneNumberValidation can be set for a MTAN procedure. * Feature - add Endpoint for creating device-Ident Token (V3.79.0) The new endpoint needs to be called in serviceintegration if payment page frontend is not used. When initializing or authorizing a transaction, this will be validated as mandatory. * Feature - add Endpoint for self integration (V3.80.0) preAuthorization endpoints now initializes and triggers the decision process for self integration * Feature - Added company name field to initialization (V3.81.0) initialisation endpoints now have an extra field for the company name. If this field is filled, the request will be rejected. * Feature - Added Prod domain and authentication-free endpoint for webshop information (V3.82.0) Domain https://ratenkauf.easycredit.de is listed under servers. Webshop endpoint can also be accessed without authentication. * Feature - Add Mtan for self-integration (V3.84.0) * transmit customers mtan * resend mtan to customer * add status and remaining attempts to Mtan object * expose transaction get endpoint for si basepath * Feature - Add Redirect-Url to Ratenkauf site (V3.85.0) A Redirect-Url to the Ratenkauf site is given in a new field within the Initialization response * Feature - Rename Redirect-Url field (V3.86.0) The field was renamed to 'redirectUrl' * Feature - Transaction patch Endpoint (V3.87.0) A new Endpoint was added for PATCH Operation on Transaction. With this Endpoint following fields in Transaction can be updated 1. Order value 2. Shopping cart information 3. Shop transaction identifier ode orderId 4. financing term 5. contact information 6. bank information 7. customer relationship information * Feature - Example Values for Transaction Api Examples were added for all required Values * Feature - Add authorization End-Point for self-integration (V3.88.1) A new Endpoint authorization for self-integration was added and should be used to authorize self-integration Transactions * Feature - Move Self-Integration API to another openapi (V3.88.2) The self-integration API ist available at /api/payment/si/v3/openapi * Feature - Initialization for express checkout (V3.96.0) required objects customer and address (for order details) are now optional (nullable) to initialize a transaction. However if an address object is given it must contain required and valid data for the initialization. * Feature - Add further texts to Webshop information-Endpoint (V3.98.0) Texts regarding declarations of consent, illustrative example, and product details are now provided through the webhop-info-endpoint * Feature - Enable initialization for diacritics (V3.99.0) Diacritics are accepted for fields such as name, last name and birth name * Feature - Add further fields for payment/interest plan (V3.102.0) Further information on the payment/interest plan is available * Feature - Increased maximum number of products for shopping card (V3.103.0) Maximum number of products for shopping card is set to 1000 * Feature - Add further fields on transaction information (V3.104.0) Further information on the summary and decision of a transaction (e.g. possible payment plans and pre-contractual info) is available * Feature - Add further information on a transaction's decision data (V3.105.0) Further information on the decision outcome will be given * Feature - Remove contact, bank and customerRelationship from PATCH transaction as it is not allowed anyways (V3.113.0) * Feature - Added max length restriction for city field (V3.114.0) City field is now restricted to a max length of 25 chars * Feature - Added flexprice field (V3.120.0) Info for the webshop whether flexprice is currently active or a flexprice action is planned for the future. * Feature - Added 'withoutFlexprice' attribute to OrderDetails. (V3.120.1) Added an additional attribute withoutFlexprice which defaults to false. This Attribute indicates if a flexprice calculation should NOT be used. Flexprices (for Example 0.00%) can only be deactivated (true) if there are flexprice informations provided. * Feature - Added 'messageDE' to Constraint Violation (V3.124.0) Added 'messageDE' to Constraint Violation as a german translation for our Error-Messages * Feature - Expanded max length restriction for city field (V3.124.1) City field restriction expanded to a max length of 255 chars * Feature - Added productUrl and productImageUrl to ShoppingCartInformationItem (V3.125.1) Added additional fields to ShoppingCartInformationItem. * Bugfix - Fixed pattern for orderId, firstName, lastName, birthName (V3.125.2) Pattern was partially wrong (À-ú-z), and matched everything due to star. * Feature - Added payment type info to init endpoint (V3.132.0) Initialize transaction with specified payment type. BILL_PAYMENT type is not usable yet. * Feature - Added INSTALLMENT_PAYMENT and BILL_PAYMENT information to webshop get endpoint (V3.133.0) Added information on whether INSTALLMENT_PAYMENT or BILL_PAYMENT is activated for the given webshop. * Feature - Added information on maximal and minimal order value for installment- and billPayment (V3.133.1) Added the fields minBillingValue, maxBillingValue, minInstallmentValue, and maxInstallmentValue to our webshop endpoint response to provide information on the maximum and minimum order values per transaction for the given shop. * Feature - Removed static min- and max-values for transaction patch (V3.125.0) Values will be set individually based on the agreed conditions for the given shop. * Feature - Added support for HmacSha256 body signature authentication (V3.138.0) HmacSha256 body signature authentication is now supported for endpoint security. Older signature methods will continue to be supported, but it is recommended to transition to HmacSha256 for enhanced security. * Feature - Added field switchPaymentPossible (V3.140.0) Info on transaction if a switch between payment methods is possible. * Feature - Added field originalInterest to the interest object (V3.150.0) OriginalInterest is the interest without flexprice * Feature - Added information about active interest rate flexibilisation to webshop endpoint (V3.165.0) Webshop endpoint has been expanded to include information about the currently active interest rate flexibilisation campaign. * Feature -Added endpoint for retrieving the texts for webshops (V3.173.0) Webshop endpoint has been added to retrieve just the confirmation texts without additional webshop information * Feature - Increased limit of additionalAddressInformation to 500 chars (V3.179.0) The restriction for additionalAddressInformation was increased from 50 to 500 chars. * Feature - Additionally to ecommerce, direct sales transactions can now be initialized (V3.184.0) Transactions for shop type: Direct Sales can now be initialized. Those transactions require the field orderId to be filled. * Feature - Added cancellation endpoint for direct sales shops (V3.185.0) Transaction cancellation endpoint for Direct Sales shops has beed added. Calling this endpoint for another shop type will result in an error. Before canceling a transaction the transaction has to be in status PREAUTHORIZED. * Feature - Added urlStatusChangeNotifyCallback field to the initialization endpoint (V3.185.1) An optional urlStatusChangeNotifyCallback field for transaction status changes notifications was added. If the transaction changes status the provided callback will be called with a GET request. If you provide a callback-url like https://www.example.com you will be notified about the transaction through GET https://www.example.com?transactionId= * Feature - Removed required attribute for redirect-urls (V3.185.2) Removed required attribute for redirect URLs (`urlSuccess`, `urlCancellation`, `urlDenial`). These fields are no longer marked as required in the API definition to support direct sales initializations, where redirect URLs are optional. Note that for eCommerce transactions, all three URLs remain required and a 400 BAD REQUEST will be returned when one or more urls are missing. * Feature - Added field `upsellingPossible` to transactionSummary (V3.186.0) Added field `upsellingPossible` to transactionSummary to indicate whether an upselling is possible for the transaction. The field will be set once the transaction has a positive decision and will be false in case of no upselling possible. * Feature - Enabled cancellation endpoint for direct sales transaction for status OPEN (V3.192.0) The cancellation endpoint for direct sales transactions can now be called for transactions in the status OPEN. Previously, only transactions in PREAUTHORIZED status could be cancelled.