Lotto Service Interface Release Notes

Version 2.0.0 - 02 March 2022

Breaking Changes

  • Added validation to the following fields:
    • ErrorDetail.id
      • Added validation to ensure this is a value v4 UUID.
      • This field previously had no validation.
    • ErrorDetail.originalId
      • Added validation to ensure this is a value v4 UUID.
      • This field previously had no validation.
    • ErrorDetail.errorMessage
      • Added validation to restrict the characters that can appear in an error message, to a handful of special characters, uppercase and lowercase alpha characters, and numeric characters.
      • This field previously only had validation to ensure that the maximum length is 20 characters.
    • Wager.drawId
      • Added validation to ensure this field is a maximum of 50 characters, and a handful of special characters, uppercase and lowercase alpha characters, and numeric characters.
    • Wager.duration
      • Added validation to ensure this field has a minimum value of 0 (zero).
    • Wager.barcode
      • Added validation to ensure this field is a maximum of 50 characters, and a handful of special characters, uppercase and lowercase alpha characters, and numeric characters.
    • Wager.serialNumber
      • Added validation to ensure this field is a maximum of 50 characters, and a handful of special characters, uppercase and lowercase alpha characters, and numeric characters.
    • Wager.groupMemberId
      • Added validation to ensure this field is a maximum of 50 characters, and a handful of special characters, uppercase and lowercase alpha characters, and numeric characters.
    • Wager.groupId
      • Added validation to ensure this field is a maximum of 50 characters, and a handful of special characters, uppercase and lowercase alpha characters, and numeric characters.

New Features

  • Added a new resource, GET /games/rules . This operation is used for retrieving the rules for each Lotto game.
  • Added a new operation to the Wagers resource, GET /wagers . This operation is used to lookup a wager, given the serial number of the successful wager.
  • Added the following values to ErrorDetail.ErrorType :
    • TIME_LIMIT_EXCEEDED
    • DO_NOT_HONOR
    • SYSTEM_MALFUNCTION
    • TRANSACTION_DECLINED
    • INVALID_ACCOUNT
    • LIMIT_EXCEEDED
    • INSUFFICIENT_FUNDS
  • Added a new field, revision to the Wager model. This field is used to pass the current revision version of the game being played.
  • Added paymentMethods to the WagerRequest and WageResponse models. This is to facilitate being able to place a wager, and tender for the wager in the same request.
Copyright © Electrum Payments (Pty) Ltd. 2019-2022. All right reserved.