Checkout API release notes
-
Production Checkout version: 1.2.3
-
Test Checkout version: 1.1.8
-
Checkout API version: v1
-
Test Payment Gateway version: 20260312
These release notes describe changes to the platform. For more information about a change, please contact us at
support@altapay.com.
Checkout API is versioned using Semantic Versioning. The version number is in the format of
MAJOR.MINOR.PATCH. The version number is increased when:
MAJOR is increased when there are breaking changes to the API.MINOR is increased when there are new features or non-breaking changes to the API.PATCH is increased when there are bug fixes or other minor changes to the API.
Info
All the breaking changes will come with different version of the API.
Merchants will be notified in advance about any planned deprecations of existing API.
There are different categories of changes, as explained in the following table:
| Release note type |
Explanation |
Change |
A very important change that you need to be aware of |
API Change |
A change to the API |
Feature |
A new feature |
Minor |
A minor change |
Tech |
A technical change |
Bug Fix |
A bug fix |
2026
1.2.10 2026-05-20
| Change type |
Description |
Gateway version |
Feature |
Remove Dankort as payment option for ApplePay integration. |
N/A |
1.2.9 2026-05-19
| Change type |
Description |
Gateway version |
Feature |
Add support for Bancontact payment method. |
N/A |
API Change |
Add AuthorisationCode parameter to callbacks. |
N/A |
Tech |
Add TLS 1.3 protocol support for HTTPS calls. |
N/A |
1.2.8 2026-04-16
| Change type |
Description |
Gateway version |
Bug Fix |
Fixed backward compatibility issue with ApplePay flow. |
N/A |
1.2.7 2026-04-16
| Change type |
Description |
Gateway version |
Bug Fix |
Enforced HTTP/1.1 protocol for webhooks (callbacks, notifications, order verification requests) to improve stability versus different cloud and CDN providers. |
N/A |
1.2.6 2026-04-13
| Change type |
Description |
Gateway version |
Bug Fix |
Fixed race condition in JS SDK for QR/Payment link initialised sessions. |
N/A |
1.2.5 2026-04-09
| Change type |
Description |
Gateway version |
Bug Fix |
Connectivity improvements for webhooks (callbacks, notifications, order verification requests) to work with different cloud and CDN providers. |
N/A |
1.2.4 2026-04-03
| Change type |
Description |
Gateway version |
API Change |
Apply changes to support native mobile SDK integration with Apple Pay. |
N/A |
Bug Fix |
Added User-Agent header to merchant notifications and callbacks |
N/A |
1.2.3 2026-03-19
| Change type |
Description |
Gateway version |
Bug Fix |
Fix error in the connection to merchant |
N/A |
1.2.2 2026-02-19
| Change type |
Description |
Gateway version |
Feature |
Add a mechanism to retrieve the device identifier for fraud detection. |
N/A |
Tech |
Update OpenAPI specification for backward compatibility, resolving date serialization mismatches. |
N/A |
Bug Fix |
Fix various issues by improving logging, exception handling, database charset compatibility, and REST path validation. |
N/A |
1.2.1 2026-02-09
| Change type |
Description |
Gateway version |
Tech |
Add support for MarketPay domains. |
N/A |
1.2.0 2026-01-30
| Change type |
Description |
Gateway version |
Feature |
Manage checkout sessions with 3rd party providers. This change improves conversion rates and fraud detection with some of the payment methods. |
20260113 |
API Change |
Redesign of ApplePay initialisation. This change improves monitoring capabilities for ApplePay transactions and was prerequisite for agreements support (coming soon). |
N/A |
Tech |
Improve database resilience. |
N/A |
2025
1.1.6 2025-12-11
| Change type |
Description |
Gateway version |
Tech |
Improve internal monitoring. |
N/A |
1.1.5 2025-10-30
| Change type |
Description |
Gateway version |
Bug Fix |
Fix styling issues on payment form for Klarna payments. |
N/A |
1.1.4 2025-10-22
1.1.3 2025-09-26
1.1.1 2025-09-05
| Change type |
Description |
Gateway version |
Bug Fix |
Correct mapping of LiableForChargeback in notification JSON callbacks |
N/A |
1.1.0 2025-09-01
| Change type |
Description |
Gateway version |
Tech |
Update Quarkus to 3.x version |
N/A |
1.0.51 2025-08-28
| Change type |
Description |
Gateway version |
Change |
Extend callback retries after IO errors |
N/A |
1.0.50 2025-08-25
| Change type |
Description |
Gateway version |
Bug Fix |
Add CardHolderName to a JSON callback |
N/A |
1.0.49 2025-07-17
| Change type |
Description |
Gateway version |
Change |
Support instant retry of callback upon connection reset from server |
N/A |
1.0.48 2025-07-17
| Change type |
Description |
Gateway version |
Bug Fix |
Propagate checkout metadata for ApplePay operations |
N/A |
Bug Fix |
Propagate organisation VAT ID |
N/A |
1.0.47 2025-07-17
| Change type |
Description |
Gateway version |
Bug Fix |
Fix checkbox alignment issue in Safari for default payment form |
N/A |
1.0.45 2025-06-24
| Change type |
Description |
Gateway version |
Change |
Add Dankort cards support for Apple Pay |
N/A |
Change |
Add Strex payment method |
20250618 |
Change |
Add Billie payment method for business customers |
20250618 |
API Change |
Add optional organisation field in customer object |
20250618 |
1.0.44 2025-06-12
| Change type |
Description |
Gateway version |
Tech |
Improve cross domain handling |
N/A |
1.0.43 2025-05-01
| Change type |
Description |
Gateway version |
Bug Fix |
Fix error in logging on parsing of empty request body |
N/A |
1.0.42 2025-04-30
| Change type |
Description |
Gateway version |
Bug Fix |
Fix language-specific characters encoding issues for API requests |
N/A |
1.0.41 2025-03-27
| Change type |
Description |
Gateway version |
Feature |
Add support for AFT transactions |
20250326 |
API Change |
Add optional recipient field in order for AFT |
20250326 |
API Change |
Add accountIdentifier field in customer and recipient for AFT |
20250326 |
API Change |
Add authorisationExpiryDate to the PaymentInformation element of PaymentCallback |
20250326 |
1.0.40 2025-02-18
| Change type |
Description |
Gateway version |
Bug Fix |
Correctly feed customer first and last name into card payment form if no billing address is provided. |
N/A |
1.0.39 2025-02-10
| Change type |
Description |
Gateway version |
Bug Fix |
Do not require customer email for all payment methods and update the payment method filtering to show only the ones which have matching customer information. |
N/A |
1.0.38 2025-01-17
| Change type |
Description |
Gateway version |
API Change |
Update definition of OpenAPI PaymentHandlingType enum. |
N/A |
Bug Fix |
Correctly prolong session lifetime when longer living payment link is generated. |
N/A |
Bug Fix |
Fix rules when checkout session is reset and payments invalidated after merchant service updated the session data.
There were some race conditions between completing the payment and invalidating it due to order and configuration data changed.
|
N/A |
1.0.37 2025-01-07
| Change type |
Description |
Gateway version |
API Change |
Add type to JS PaymentMethod that can be used in onRenderPaymentMethod callback. |
N/A |
Tech |
Internal communication performance improvements. |
N/A |
2024
1.0.36 2024-12-16
| Change type |
Description |
Gateway version |
Minor |
Accept 200, 202 and 204 response status codes for notification callbacks. |
N/A |
Minor |
Reject gracefully if VERIFY_ORDER response is not complete. |
N/A |
Change |
Update Klarna popup design |
N/A |
1.0.35 2024-12-05
| Change type |
Description |
Gateway version |
Minor |
(Skipped) |
N/A |
1.0.34 2024-11-29
| Change type |
Description |
Gateway version |
Bug Fix |
Loosen up condition of JS failure callbacks to avoid false negative payment failures due to network communication issues. |
N/A |
1.0.33 2024-11-25
| Change type |
Description |
Gateway version |
Tech |
Database performance improvements |
N/A |
Tech |
Internal platform monitoring improvements |
N/A |
1.0.32 2024-11-21
| Change type |
Description |
Gateway version |
Tech |
Database performance improvements |
N/A |
1.0.31 2024-11-19
| Change type |
Description |
Gateway version |
Tech |
Stability improvements |
N/A |
1.0.30 2024-11-18
| Change type |
Description |
Gateway version |
Tech |
Add low level communication logging |
N/A |
1.0.29 2024-11-07
| Change type |
Description |
Gateway version |
API Change |
Add birthdate and username to the Customer Information element |
N/A |
1.0.28 2024-10-28
| Change type |
Description |
Gateway version |
Tech |
Change underlying database structure to imporve response times |
N/A |
1.0.26 2024-10-23
| Change type |
Description |
Gateway version |
Bug Fix |
Add missing externalPaymentId reference for ApplePay payments. |
N/A |
Bug Fix |
Fix bug resulting in changing the payment status shown via Checkout API to cancelled for successfully completed payments when session was updated after completing the payment. |
N/A |
1.0.25 2024-10-21
| Change type |
Description |
Gateway version |
Feature |
Expose AltaPayMethodHandlers.js standalone from our JS SDK for merchants willing to orchestrate front-end independently and utilise ApplePay. More details on the initialisation of payments could be found here |
N/A |
Bug Fix |
Fixed styling issues on payment form for SEPA payments. |
N/A |
Bug Fix |
Fixed CVC, expiry year and month styling issues on payment form. |
N/A |
Minor |
Improve user experience by showing a processing animation when the consumer has submitted the payment page |
N/A |
Minor |
Expose merchantErrorCode in JS failure callbacks. See example in handling callbacks section |
N/A |
1.0.24 2024-10-11
| Change type |
Description |
Gateway version |
Bug Fix |
Cancel active cached payments when checkout session data is updated. |
N/A |
1.0.23 2024-10-04
| Change type |
Description |
Gateway version |
Bug Fix |
Properly handle URL callbacks when using ApplePay |
N/A |
1.0.22 2024-10-04
| Change type |
Description |
Gateway version |
Bug Fix |
Fix callback issue resulting in calling redirected URL twice. |
N/A |
1.0.21 2024-10-02
1.0.20 2024-10-01
1.0.19 2024-09-24
| Change type |
Description |
Gateway version |
Bug Fix |
Fix wrong notification body format for "new payment created" notifications. |
N/A |
Bug Fix |
Add to callbacks and notifications missing error messages and flag indicating if error should be shown to the customer. |
N/A |
Feature |
Add support for ApplePay inside nested iframe window by providing origin query param to iframe source URL. |
N/A |
1.0.18 2024-09-13
| Change type |
Description |
Gateway version |
Bug Fix |
Correct null value handling for ApplePay requests with minimal data. |
N/A |
1.0.17 2024-09-12
| Change type |
Description |
Gateway version |
Change |
Add payment form styling support for mobile devices |
N/A |
1.0.16 2024-09-05
| Change type |
Description |
Gateway version |
API Change |
Order lines quantity field type is corrected to be double. |
N/A |
Bug Fix |
Fix checkout defaulting some fields to 0 when not set. |
N/A |
Bug Fix |
Fix font mismatch between fields on payment form |
N/A |
Change |
Add support for surcharge in default payment form styling |
N/A |
API Change |
RiskAnalysis data is added to the callbacks |
N/A |
1.0.15 2024-08-01
| Change type |
Description |
Gateway version |
Change |
Introduce new styling for payment form |
N/A |
1.0.14 2024-06-24
| Change type |
Description |
Gateway version |
Feature |
Add support for pending payment status |
N/A |
1.0.13 2024-06-24
| Change type |
Description |
Gateway version |
Bug Fix |
Allow retries after failed payment |
N/A |
1.0.12 2024-06-19
| Change type |
Description |
Gateway version |
Bug Fix |
Improved null value handling in JS SDK |
N/A |
1.0.11 2024-06-17
| Change type |
Description |
Gateway version |
Minor |
Improved styling of payment form |
N/A |
1.0.10 2024-06-13
| Change type |
Description |
Gateway version |
Bug Fix |
Properly handle redirects for Przelewy24 and iDEAL |
N/A |
Bug Fix |
Properly select active payment in case of multiple payments started by customer |
N/A |
1.0.9 2024-06-12
| Change type |
Description |
Gateway version |
Tech |
Internal release |
N/A |
1.0.8 2024-06-04
| Change type |
Description |
Gateway version |
Tech |
UI performance improved by serving Checkout JS SDK as single bundle. |
N/A |
1.0.7 2024-05-29
| Change type |
Description |
Gateway version |
API Change
Feature |
Allow to control whether payment form should be displayed on the current page or redirected. |
N/A |
Bug Fix |
Fix UX issues caused by incorrectly cached JS scripts in browser. |
N/A |
1.0.6 2024-05-13
| Change type |
Description |
Gateway version |
API Change
Feature |
Improvements to JSON callbacks data model. |
N/A |
API Change
Feature |
Add firstName, lastName, region as optional fields in billingAddress and shippingAddress. |
N/A |
1.0.5 2024-05-03
| Change type |
Description |
Gateway version |
Bug Fix |
Fix undefined error in JS when payment methods got filtered out. |
N/A |
Bug Fix |
Support in-app redirects when Checkout is used inside iframe. |
N/A |
API Change
Feature |
Add support for JSON callbacks and notifications. bodyFormat flag added to callbacks configuration in the API. |
N/A |
1.0.4 2024-04-23
| Change type |
Description |
Gateway version |
Bug Fix |
Fix Finshark not working for some banks when displayed in the iframe. |
N/A |
Bug Fix |
Fix NPE when authenticating with empty body and content type header set. |
N/A |
1.0.3 2024-04-22
| Change type |
Description |
Gateway version |
Bug Fix |
Fixed a bug that we showed multiple times the same payment methods, if merchant has multiple configurations of this payment method in the gateway.
Now single entry of each payment method is presented to the customer. |
N/A |
Feature |
Sort payment methods based on their relevance in specific countries. |
N/A |
API Change
Feature |
Provide differenent level of access tokens in order to support more complex use cases. The changes includes:
- adding role to the token,
- allowing MERCHANT to access all data while keeping CUSTOMER checkout sessions isolated,
- allowing to create new access tokens only for given checkout session. |
N/A |
1.0.2 2024-04-19
| Change type |
Description |
Gateway version |
Bug Fix |
Corrected using the proper payment authType for ApplePay. |
N/A |
Bug Fix |
Corrected payment method rendering to have all the payment methods rendered in proper order and at the same time. |
N/A |
1.0.1 2024-04-05
| Change type |
Description |
Gateway version |
Feature |
Support for custom translations of payment method names and descriptions. This feature allows merchants to provide their own naming and descriptions in the payment gateway configuration. |
20240327 |
API Change
Minor |
Added name and description in payment method metadata. This feature allows merchants to further customise payment methods rendering and improve customer experience. |
20240327 |
Bug Fix |
Corrected handling of active payment when customer switches payment methods and reopens the payment windows multiple times. |
N/A |
Feature |
Support for minimal checkout session containing amount, currency and order ID. |
N/A |
Feature
API Change |
Provide payment link next to base64-encoded QR Code in response for creating QR code for the checkout session. |
N/A |
API Change |
Rename QR endpoints to payment links. |
N/A |
0.9.16 2024-03-13
| Change type |
Description |
Feature
API Change |
Allow paying with a saved card. |
Bug Fix |
From now on the billing address is not mandatory (but then country should be provided), and checkoutAPI will filter out payment methods that require it but it is not provided. |
0.9.15 2024-03-04
| Change type |
Description |
Tech |
Technical and security improvements to ApplePay handling. |
Bug Fix |
Fixed payment method filtering when payment method is no supporting specific operations for agreements - like automatic capture or reserve. |
0.9.13 2024-02-22
| Change type |
Description |
Feature
API Change |
Support default QR Landing page provided by AltaPay - A MarketPay Company when merchant is not providing their own QR page. |
API Change |
Support agreements details that are displayed to the customer inside checkout session configuration section. |
Bug Fix |
Support dynamic merchant domain for ApplePay.
Plase keep in mind that everv domain used for ApplePay has to be verified on Apple side - to do so please reach out to our support. |
Tech |
Update ApplePay payment handling to support their newest security requirements. |
Bug Fix |
Fix support for PayPal on mobile devices. |
0.9.12 2024-02-12
| Change type |
Description |
Bug Fix |
Preserve order of payment methods. By default they are alphabetically sorted unless there are local regulations
that are applicable for payment methods ordering (for example in Finland and Sweden). |
Bug Fix |
Fix initialisation race condition issue for QR payments. |
Minor
API Change |
Expose paymentType as metadata field for payment method, indicating how the payment will be processed - one time payment or agreement. |
Bug Fix |
Fix checkout not sending notifications towards merchant systems. |
0.9.11 2024-02-08
| Change type |
Description |
Minor |
Allow negative values as unitPrice in order lines. |
Bug Fix |
Fix issue with notifications not being processed due to expired JWT token. |
Feature
API Change |
Add possibility to fallback to one time payment when requesting agreement and given payment method is not supporting agreements. |
0.9.10 2024-02-02
| Change type |
Description |
Bug Fix |
Fix issue with callbacks request with redirects being called twice - once in backend and once in frontend.
Now they are properly evaluated via backend and frontend is calling only redirect URL. |
Bug Fix |
Fix issue of checkout not properly resolving status of the payment after frontend issues. |
Feature |
Support custom payment method logo and description configuration from merchant's configuration on the payment gateway. |
Feature
API Change |
Add support for subscription and charge and subscription and reserve operations. Allowing subscription setup and charge or reserve being done in one step. |
0.9.9 2024-01-26
| Change type |
Description |
Bug Fix |
Fix the issue with notifications not being sent when there is either redirect URL configured or merchant's callback OK response return redirect. |
Bug Fix |
Properly support redirections from URL callbacks when using payment window in embedded iframe. |
Feature |
Allow to close opened payment windows programmatically. |
Bug Fix |
Fix issue with multiplied payment status listeners when customer closes and reopens the same payment window multiple times. |
0.9.8 2024-01-03
| Change type |
Description |
Feature
API Change |
Support order line details required by Klarna and other acquirers. |
Feature
API Change |
Add externalPaymentId to Session.activePayment and Payment schema to represent identifier of the payment in the payment gateway. |
Bug Fix |
Correct casing of agreementManagementURL to be agreementManagementUrl similar to other URL fields |
Bug Fix |
Correct description of Swish payment method. |
Bug Fix |
Add missing icons for Twint, Trustly and SEPA |
Bug Fix |
Correct handling long URLs for callbacks |
Minor |
Expose interface IAltaPay in JS SDK library. This gives autocompletion based on the interface after importing JS SDK module. |
2023
0.9.7 2023-12-19
| Change type |
Description |
Bug Fix |
Handle the case when no payment methods are available |
Bug Fix |
Add more descriptive error messages |
Bug Fix |
Fix QR payments functionality |
Bug Fix |
Fix functionality for passing transaction_info |
Feature
API Change |
Support recurring and unscheduled agreement setup |
Minor
API Change |
Use enum for payment statuses |
Minor
API Change |
Add country to session configuration to be able to filter payment methods by country code |
Minor
API Change |
Add shop name to session configuration to be able to filter payment methods by shop name |
Minor
API Change |
Add language to session configuration. It's used in the names of payment methods and payment forms |
0.9.6 2023-12-09
| Change type |
Description |
Bug Fix |
Fix ApplePay payment method throwing exception when order is not fully configured |
Bug Fix |
Fix payment methods loading when currencies configured for them were empty |
Bug Fix |
Fix payment methods loading when currencies configured for them were empty |
0.9.5 2023-12-06
| Change type |
Description |
Bug Fix |
Fix mobile app redirection issues |
Minor |
Update logos for payment methods |
Minor
API Change |
Add basic payment information to session object |
Minor |
Use payment status from session object instead of calling payment endpoint in JS SDK |
Bug Fix |
Correctly handle null or empty token and sessionID in JS SDK initialization |
Bug Fix |
Correctly handle cases when customer is retrying to pay with the same payment method after clicking back or refreshing the page |
Minor
API Change |
Add transactionInfo section to order details |
0.9.4 2023-11-24
| Change type |
Description |
Bug Fix |
Fix bad request error when creating session with minimal required data |
Bug Fix |
Add missing metadata to payment methods for customisation |
Feature |
Add support for mobile app redirections |
0.9.3 2023-11-22
| Change type |
Description |
Tech |
Monitoring improvements |
0.9.2 2023-11-20
| Change type |
Description |
Bug Fix |
Do not require context field in session API schema |
Minor |
Display payment product name as a part of payment method description for acquirers that support multiple different payment products |
Feature |
Add payment method customisation. Now merchants can filter and customise look and feel of the payments methods if they don't want to rely on the default rendering. |
Minor
API Change |
Add phone number to customer data |
0.9.1 2023-11-15
| Change type |
Description |
Bug Fix |
Reload payment methods when session data was changed |
API Change |
Allow Checkout integrators to get information about the status of the payment directly from session |
Minor
API Change |
Add operationId to OpenAPI spec |
Minor |
Improve handling of sessionId in create and update session operations - rely on path param and make body param optional |
Bug Fix |
Fix null pointer exception for terminals that cannot be converted into payment methods |
0.9.0 2023-11-07
| Change type |
Description |
API Change |
Initial release of Checkout API V1 |
Tech |
Initial release of Checkout JS SDK |
Tech |
Initial release of Checkout service |