2.15.0 Test Environment Current

v.2.15.0 - Test Environment

2026-10-27 - Planned deployment to Live 2026-10-15 - Test Environment

2026-10-27 - Planned deployment to Live

2026-10-15 - Test Environment

Added

eWP Redemption - Tax Withholding on the Order, Webhook and Transaction History

An eWP (BART) sell is taxed after settlement. The withheld German taxes are now shown on the order, on the order webhook and on the transaction-history entry, so partners can explain the cash the customer actually receives.

  • Documentation Location: API REFERENCE - Trading - Digital Assets; API REFERENCE - Webhooks; API REFERENCE - Transaction History
  • Added fields: germanCit, solidaritySurcharge, churchTax and their sum taxDeductionTotal (decimal, optional, >= 0) on the order executionData (DigitalAssetsOrderExecutionData), on the executionData of the DIGITAL_ASSET_ORDER_NOTIFICATION webhook, and on the digital trading transaction in the transaction history.
  • Behavior change: a redemption now produces two webhooks with status: FILLED. The first is sent at settlement and carries the gross proceeds and the fee. The second, with notificationType: UPDATED, is sent once the tax has been processed and booked, and adds the four tax fields (all 0 when the sale realised no gain).
  • Behavior change: the transaction-history entry of the redemption is updated in place when the tax is booked. Its netAmount becomes gross amount minus fee minus taxDeductionTotal, which is the cash credited to the customer.
  • Note: the tax fields are populated only for SELL orders with a processed tax result. Webhooks are delivered at least once, so the second notification can arrive again with the same figures. Process it idempotently by orderId.

Traditional Assets - Minimum Order Amount

Traditional asset orders whose value is below one cent are now rejected, because their fill would round to a gross amount of 0.00.

  • Documentation Location: API REFERENCE - Trading - Traditional Assets; API REFERENCE - Webhooks
  • New enum value: ORDER_BELOW_MINIMUM_AMOUNT on TraditionalAssetOrderNotificationErrorCodeEnum.
  • Behavior change: an order whose value (quantity multiplied by the price the order is priced at: limit price, market price, or the higher of stop and market price) is below 0.01 EUR is rejected through the traditional asset order notification with this error code. An order of exactly 0.01 EUR is accepted.
  • Note: the check applies to orders placed by the partner. Savings-plan executions and tokenized-asset orders keep their own minimums.

Identification Verification - CANCELLED Status

An identification that the customer cancels at the identification provider now ends in its own status.

  • Documentation Location: API REFERENCE - Entities; API REFERENCE - Webhooks
  • New enum value: CANCELLED on IdentificationVerificationStatusEnum.
  • Endpoints affected: GET /entities/identification-verifications/{identificationVerificationId} and the identification verification webhook.
  • Note: clients that validate the status against a fixed list should add CANCELLED. To retry, start a new identification verification.

Entity Webhooks - existingEntityId on Duplicate Errors

When an entity create is rejected as a duplicate, the webhook error now tells the partner which existing entity it duplicates.

  • Documentation Location: API REFERENCE - Webhooks
  • Added field: existingEntityId (UUID, optional) on EntityValidationError. It is present only when errorType is ALREADY_EXISTS_ERROR and the request duplicates an entity of the same partner (natural person, legal entity, beneficial owner, legal representative). The value is the id returned when that entity was created.
  • Note: use it to link the rejected request to the existing record instead of searching for it.

Document Signatures - Product Document Types

Signatures of the product documents can now be read back.

  • Documentation Location: API REFERENCE - Documents; API REFERENCE - Entities
  • New enum values: KIID, RISK_INFORMATION, CONSUMER_INFORMATION and PRODUCT_TERMS_AND_CONDITIONS on DocumentSignatureTypeEnum.
  • Endpoints affected: the documentType of the signed documents on the natural person (naturalPersonSignedDocuments) and on the customer (signedDocumentsRelatedToCustomer).
  • Behavior change: POST /v2/documents/sign already accepted signatures of these partner document types, but the natural person and customer did not return them correctly. They are now returned with the new documentType values.
  • Note: customerId is required when signing a document of any of these four types, as for TERMS_AND_CONDITIONS. The rule is unchanged; the description of customerId now lists all five types. Clients that validate documentType against a fixed list should add the new values.

Changed

Entities - Creating an Existing Person or Company, and Partner-Scoped modifiedOn

Two changes to how the Entities API handles natural persons and legal entities that already exist on the platform.

  • Documentation Location: API REFERENCE - Entities; API REFERENCE - Webhooks
  • Behavior change: POST to create a natural person or legal entity that already exists on the platform keeps the stored shared data. Only values missing from it are taken from the request; differing values in the request no longer overwrite it. Use PATCH to change shared data.
  • Changed: modifiedOn on natural persons and legal entities, and on their webhooks, is the date your partner's record was last modified. It changes when your own data or the entity's status changes, or when shared data visible to you changes. Changes made by other partners to their own records of the same person or company do not affect it.
  • Note: the descriptions of createdOn and verifiedOn on the legal entity were corrected (they wrongly referred to a natural person). The values are unchanged.

Price Streams - Partly Unsupported Market Requests

A price-stream request that mixes supported and unsupported markets no longer fails as a whole.

  • Documentation Location: API REFERENCE - WebSocket Prices; API REFERENCE - WebSocket Tokenized Prices
  • Endpoints affected: /websocket/prices on the digital asset and the tokenized asset price streams.
  • Behavior change: an ERROR response closes the connection, with one exception. When some requested markets are unsupported but at least one is supported, a single ERROR response lists the unsupported ones (unsupported markets: ...) and PRICES responses for the supported markets follow on the same connection.
  • Note: do not treat every ERROR response as the end of the connection. Check whether PRICES responses keep arriving.