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 that will be used in the settlement request if any of the selections meet the payout-modifier criteria as defined on the operator'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": "eSJHupTuWfoLS6ZsKPj2NB43ir4DHZMI",
            "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 (ticket 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 Request - Result

{
  "operatorId": 9985,
  "content": {
    "type": "payout-modifier-settlement",
    "settlementId": "SETL3134413498778",
    "reference": "EZ0wq6jxM6WXTvKtkbUFCzooiGcTqABm",
    "settlement": {
      "type": "result",
      "result" : {
        "type": "win",
        "deadHeatFactor": "0.5"
	  }
	}
  },
  "timestampUtc": 1678883043000,
  "operation": "payout-modifier-settlement",
  "version": "3.0"
}

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

Payout Modifier Request - Odds

{
  "operatorId": 9985,
  "content": {
    "type": "payout-modifier-settlement",
    "settlementId": "SETL3134413498778",
    "reference": "EZ0wq6jxM6WXTvKtkbUFCzooiGcTqABm",
    "settlement": {
      "type": "odds",
      "odds" : {
        "type": "decimal",
        "value": "1.75"
	  }
	}
  },
  "timestampUtc": 1678883043000,
  "operation": "payout-modifier-settlement",
  "version": "3.0"
}

Response is equal in both cases:

Payout Modifier Settlement Response

{
  "content": {
    "type": "payout-modifier-settlement-reply",
    "settlementId": "SETL3134413498778",
    "signature": "mHFX4dXMq4b3aqnVbgiFL06LlHZTU4pj7Qn8rYnmLgA=",
    "status": "accepted",
    "reference": "EZ0wq6jxM6WXTvKtkbUFCzooiGcTqABm",
    "code": 0,
    "message": "Transaction processed"
  },
  "timestampUtc": 1691750043000,
  "operation": "payout-modifier-settlement",
  "version": "3.0"
}