For the complete documentation index, see llms.txt. This page is also available as Markdown.

4-fold Accumulator with Payout-modifier Selections

This is an example of a 4-fold accumulator with two payout-modifier selections referring to different events. The ticket contains only one bet (Bets array length = 1), which further contains four selections (Selections array length = 4).

Two selections are of type "payout-modifier" and contain the reference to be used in the settlement request if any of the selections meet the payout-modifier criteria defined on the client's platform. Other selections are regular UF selections that will be settled according to feed settlement messages.

Ticket Placement Request
{
  "operatorId": 9985,
  "content": {
    "type": "ticket",
    "ticketId": "Ticket_6230",
    "bets": [
      {
        "selections": [
          {
            "type": "uf",
            "productId": "3",
            "eventId": "sr:match:14938771",
            "marketId": "223",
            "outcomeId": "1715",
            "specifiers": "hcp=1.5",
            "odds": {
              "type": "decimal",
              "value": "1.1"
            }
          },
          {
            "type": "payout-modifier",
            "reference": "eSJHupTuWfoLS6ZsKPj2NB43ir4DHZMI",
            "description": "supersub",
            "selection": {
              "type": "uf",
              "productId": "1",
              "eventId": "sr:match:15163591",
              "marketId": "1",
              "outcomeId": "2",
              "specifiers": "hcp=1:0",
              "odds": {
                "type": "decimal",
                "value": "1.48"
              }
            }
          },
          {
            "type": "uf",
            "productId": "3",
            "eventId": "sr:match:15050881",
            "marketId": "1",
            "outcomeId": "2",
            "odds": {
              "type": "decimal",
              "value": "1.32"
            }
          },
          {
            "type": "payout-modifier",
            "reference": "EZ0wq6jxM6WXTvKtkbUFCzooiGcTqABm",
            "description": "2up",
            "selection": {
              "type": "uf",
              "productId": "1",
              "eventId": "sr:match:16470657",
              "marketId": "1",
              "outcomeId": "2",
              "odds": {
                "type": "decimal",
                "value": "7.1"
              }
            }
          }
        ],
        "stake": [
          {
            "type": "cash",
            "currency": "EUR",
            "amount": "50"
          }
        ]
      }
    ],
    "context": {
      "channel": {
        "type": "retail",
        "shopId": "shop_789135"
      },
      "limitId": 1409
    }
  },
  "correlationId": "tesd83nky7sc",
  "timestampUtc": 1678886959000,
  "operation": "ticket-placement",
  "version": "3.0"
}
Ticket Placement Response
{
  "content": {
    "type": "ticket-reply",
    "signature": "hlDfZ5uX5+SftXxb4+M0Mp3sN7v4cZPEfXBdX4T32qw=",
    "status": "accepted",
    "ticketId": "Ticket_6230",
    "code": 0,
    "message": "Transaction processed",
    "betDetails": [
      {
        "selectionDetails": [
          {
            "selection": {
              "type": "uf",
              "productId": "3",
              "eventId": "sr:match:14938771",
              "marketId": "223",
              "outcomeId": "1715",
              "specifiers": "hcp=1.5",
              "odds": {
                "type": "decimal",
                "value": "1.1"
              }
            },
            "code": 0,
            "message": "Transaction processed"
          },
          {
            "selection": {
              "type": "uf",
              "productId": "1",
              "eventId": "sr:match:15163591",
              "marketId": "1",
              "outcomeId": "2",
              "specifiers": "hcp=1:0",
              "odds": {
                "type": "decimal",
                "value": "1.48"
              }
            },
            "code": 0,
            "message": "Transaction processed"
          },
          {
            "selection": {
              "type": "uf",
              "productId": "3",
              "eventId": "sr:match:15050881",
              "marketId": "1",
              "outcomeId": "2",
              "odds": {
                "type": "decimal",
                "value": "1.32"
              }
            },
            "code": 0,
            "message": "Transaction processed"
          },
          {
            "selection": {
              "type": "uf",
              "productId": "1",
              "eventId": "sr:match:16470657",
              "marketId": "1",
              "outcomeId": "2",
              "odds": {
                "type": "decimal",
                "value": "7.1"
              }
            },
            "code": 0,
            "message": "Transaction processed"
          }
        ],
        "code": 0,
        "message": "Transaction processed"
      }
    ],
    "exchangeRate":   [
      {
        "fromCurrency": "EUR",
        "toCurrency": "EUR",
        "rate": "1.00000"
      }
    ]
  },
  "correlationId": "tesd83nky7sc",
  "timestampUtc": 1678886960000,
  "operation": "ticket-placement",
  "version": "3.0"
}

The settlement for selections eligible for payout-modifier is done using the payout-modifier settlement request (below). It contains a reference to the corresponding payout-modifier promotion. When such a message is received, all tickets containing that particular payout-modifier option (tickets are found by matching reference) would be updated to reflect the received settlement. It is important to note that payout-modifier settlement will be applied only if the resulting odds would be more favorable to the punter.

If the ticket is fully settled and the payout-modifier hasn't been received within 12 hours (to be defined) of the ticket settlement, no further early payout "corrections" will be accepted.

Payout modifier can change the result of the underlying selection (result is of type "#/$defs/sel-result"):

Payout Modifier Settlement Request - Result
{
  "operatorId": 9985,
  "content": {
    "type": "payout-modifier-settlement",
    "settlementId": "SETL3134413498778",
    "reference": "eSJHupTuWfoLS6ZsKPj2NB43ir4DHZMI",
    "settlement": {
      "type": "result",
      "result": {
        "type": "win",
        "deadHeatFactor": "0.5"
	      }
	   }
   },
  "timestampUtc": 1678883043000,
  "operation": "payout-modifier-settlement",
  "version": "3.0"
  }
Payout Modifier Settlement Response
{
  "content": {
    "type": "payout-modifier-settlement-reply",
    "settlementId": "SETL3134413498778",
    "signature": "mHFX4dXMq4b3aqnVbgiFL06LlHZTU4pj7Qn8rYnmLgA=",
    "status": "accepted",
    "reference": "eSJHupTuWfoLS6ZsKPj2NB43ir4DHZMI,
    "code": 0,
    "message": "Transaction processed"
  },
  "timestampUtc": 1678883044000,
  "operation": "payout-modifier-settlement",
  "version": "3.0"
}

or the effective odds of the underlying selection (odds are of type "#/$defs/odds-fixed"):

Payout Modifier Settlement Request - Odds
Payout Modifier Settlement Response

Last updated

Was this helpful?