Lotto Service Interface Release Notes

v3.0.2 - 03 September 2024

• Fixed DAILY_LOTTO_PLUS gameName (previously incorrectly referenced as DAILY_LOTTO_PLUS1 ).
• Added DAILY_LOTTO_PLUS_PLUS1 add-on game that was missing.

v3.0.1 - 13 March 2024

• Fixed tenders field in the WagerRequest model to have null as the default value rather than an empty list. This ensures that JSON serialisation results in expected behaviour.

v3.0.0 (Deprecated) - 05 March 2024

Deprecated, use v3.0.2.

Breaking Changes

• Removed SUPA_DRAW from gameName enum in Wager .

New Features

• Added securityCode to Wager model.
• Added LOTTO658 , LOTTO658_PLUS1 , LOTTO658_PLUS2 and DAILY_LOTTO_PLUS1 to the gameName enum in Wager .

v2.1.0 - 29 September 2022

• Added a list of tenders to WagerRequest .

v2.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.