Changelog


Branch 2.x link

2.2.0 link

Released 2025-09-01 Terminal version: Samport AX 1.5.0

  • Added outcomeDescription in the response of Payment, Refund, Reversal and Capture. outcomeDescription gives a hint of the reason behind the current outcome while still protecting cardholder privacy.
  • Added Modeless Abort requests, which allows the ECR to send abort request without operation id using /Aborts
  • Improved the Modeless Abort requests: If the terminal is in a state that is not abortable, the response will return HTTP 403 Forbidden. If an asynchronous request is ongoing, the Ecr still need to check the transaction status.
  • Added new receipt type in response for Payment, Refund, Reversal and Capture: Embedded plain text receipt. The embedded plain text receipt is a plain text receipt that is formatted according to a specified receipt width. New lines is marked with the new line character \n, any empty space on the receipt is padded with space characters " ".
    The embedded receipt is divided into three sections; header, content and footer, each section formatted as described above. The width of the receipt can be specified in Payment-, Refund-, Reversal- and Capture-requests. If not specified the terminal default value will be used instead (normally 34).
    Read more about the new format here

2.1.0 link

Released 2025-04-23
Terminal version: Samport AX 1.4.0

  • Updated dialog and status description
  • Added the possibility to retrieve dialog information using /Dialogs without operationId
  • Added ReadCard (synchronous and asynchronous)
  • Changed subsequent async /status. Now returning “200 and the response” instead of “404 - Not Found” after terminal has completed the operation, so that if the response was lost you can just request it again!
  • Changed /Dialogs/{operationId}. Now returning “200 and empty dialog data” instead of “404 - Not Found” after terminal has completed the operation
  • Updated cashierId - now accepts alphanumeric characters
  • Added the possibility to get latest capture
  • Added the possibility to get capture by batch number

2.0.0 link

Released 2024-09-25
Terminal version: Samport AX 1.0.1

  • Plain HTTP instead of HTTPS
  • New (mandatory) header added to all requests: Authorization
  • New (mandatory) header added to all responses: Server-Authorization
  • Amounts must now be specified as integers in the lowest unit of the currency (using exponent 0).
    For example, 100,50 EUR (one hundred euros and fifty cents) must be sent as 10050.
  • VAT amount is no longer supported
  • customData may now only contain alpha numeric characters. Max length of keys is 16 characters, max length of values is 32 characters, and max number of key-value-pairs is 5
  • currencyCode and currencySymbol is now string instead of string enum.
  • All timestamps are now using ISO 8601 format, e.g. 2024-03-15T13:45:30.123+02:00
    • Authentication hash uses Coordinated Universal Time (UTC) with a zero hour offset. e.g. 2024-03-15T13:45:30.123Z
  • Changed authorizationMethod from object to string enum
  • Changed authorizationResponder from object to string enum
  • Changed entryMode from object to string enum
  • Changed verificationMethod from object to string enum
  • Removed Messages/endpoints:
    • CashAdvance (synchronous and asynchronous)
    • ReadCard (synchronous and asynchronous)
  • Changed Messages:
    • Payment request:
      • Removed amounts.vat
    • Payment response:
      • Removed amounts.surcharge
      • Removed amounts.vat
      • Removed encryptedInformation
      • Removed internalKernelStatus
      • Removed terminalResponse
      • Removed unmaskedPan
      • Renamed spdhResponseCode to actionCode
    • Refund response:
      • Removed encryptedInformation
      • Removed internalKernelStatus
      • Removed terminalResponse
      • Renamed spdhResponseCode to actionCode
    • Capture response:
      • Removed cardTotals.payments.amounts.surcharge
      • Removed cardTotals.payments.amounts.vat
      • Removed internalKernelStatus
      • Removed terminalResponse
      • Renamed spdhResponseCode to actionCode
    • ReversalResponse:
      • Removed receiptNumber
      • Removed spdhResponseCode
      • Removed transactionId

Branch 1.x link

1.1.0 link

Released 2024-06-11
Terminal version: WL samport pos-1.0.22 (formerly bambora_pos)

  • Added support for multi user.
  • Added ongoing batch number in DeviceInformation endpoint.
  • Added better description for response code 404.
  • Fixed an issue when the terminal tried to parse JSON strings with empty objects.
  • The terminal now handles invalid characters in custom data without errors.

1.0.0 link

Released 2023-06-26
Terminal version: bambora_pos-1.0.19

  • Initial release