promo_payout_modifier

Goal: Place a payout-modifier selection as customer_promo and receive accepted.

Use Selection.newPayoutModifierSelectionBuilder().setReference("pref-1").setDescription("payout-mod").setSelection(nestedUf). Wire type "payout-modifier".

How to build the request (Java SDK)

1

Create an EndCustomer with customer_promo and use a cash stake

2

Build the nested UF selection for sr:match:15050881

3

Wrap the UF selection with the payout-modifier builder

Set the reference and description as shown above.

4

Send the ticket

Call sendTicket.

Java example

import com.sportradar.mbs.sdk.entities.channel.Channel;
import com.sportradar.mbs.sdk.entities.common.AcceptanceStatus;
import com.sportradar.mbs.sdk.entities.common.Bet;
import com.sportradar.mbs.sdk.entities.common.EndCustomer;
import com.sportradar.mbs.sdk.entities.common.TicketContext;
import com.sportradar.mbs.sdk.entities.odds.Odds;
import com.sportradar.mbs.sdk.entities.request.TicketRequest;
import com.sportradar.mbs.sdk.entities.response.TicketResponse;
import com.sportradar.mbs.sdk.entities.selection.Selection;
import com.sportradar.mbs.sdk.entities.stake.Stake;
import java.math.BigDecimal;

Selection uf = Selection.newUfSelectionBuilder()
    .setProductId("3").setEventId("sr:match:15050881")
    .setMarketId("m1").setOutcomeId("o1")
    .setOdds(Odds.newDecimalOddsBuilder().setValue(new BigDecimal("2.0")).build())
    .build();

TicketRequest request = TicketRequest.newBuilder()
    .setTicketId("tid-payout-mod")
    .setContext(TicketContext.newBuilder()
        .setLimitId(123L)
        .setChannel(Channel.newMobileChannelBuilder()
            .setLang("en")
            .setIp("127.0.0.1")
            .setDeviceId("deviceId123")
            .build())
        .setEndCustomer(EndCustomer.newBuilder().setId("customer_promo").build())
        .build())
    .setBets(Bet.newBuilder()
        .setBetId("bet-1")
        .setSelections(Selection.newPayoutModifierSelectionBuilder()
            .setReference("pref-1")
            .setDescription("payout-mod")
            .setSelection(uf)
            .build())
        .setStake(Stake.newCashStakeBuilder().setAmount(new BigDecimal("10")).setCurrency("EUR").build())
        .build())
    .build();
TicketResponse response = mbsSdk.getTicketProtocol().sendTicket(request);
// ACCEPTED

Wire JSON (what the SDK sends)

{
  "operatorId": 9985,
  "correlationId": "corr-1",
  "timestampUtc": 1710000000000,
  "operation": "ticket-placement",
  "version": "3.0",
  "content": {
    "type": "ticket",
    "ticketId": "tid-payout-mod",
    "context": {
      "limitId": 123,
      "channel": {
        "type": "mobile",
        "lang": "en",
        "ip": "127.0.0.1",
        "deviceId": "deviceId123"
      },
      "endCustomer": { "id": "customer_promo" }
    },
    "bets": [{
      "betId": "bet-1",
      "selections": [{
        "type": "payout-modifier",
        "reference": "pref-1",
        "description": "payout-mod",
        "selection": {
            "type": "uf",
            "eventId": "sr:match:15050881",
            "marketId": "m1",
            "outcomeId": "o1",
            "productId": "3",
            "odds": { "type": "decimal", "value": "2.0" }
          }
      }],
      "stake": [{ "type": "cash", "amount": "10", "currency": "EUR" }]
    }]
  }
}

Field name	Value	Mandatory / Optional	Data type	Ignored by sandbox
operatorId	9985	Mandatory	integer	Yes
correlationId	"corr-1"	Mandatory	string	No (echoed in reply)
timestampUtc	1710000000000	Mandatory	integer	Yes
operation	"ticket-placement"	Mandatory	string	No
version	"3.0"	Mandatory	string	No (echoed in reply)
content	(object)	Mandatory	object	No
content.type	"ticket"	Mandatory	string	No
content.context	(object)	Mandatory	object	No
content.context.limitId	123	Mandatory	integer	Yes
content.context.channel	(object)	Mandatory	object	Yes
content.context.channel.type	"mobile"	Mandatory	string	Yes
content.context.channel.lang	"en"	Mandatory	string	Yes
content.context.channel.ip	"127.0.0.1"	Optional	string	Yes
content.context.channel.deviceId	"deviceId123"	Optional	string	Yes
content.context.endCustomer	(object)	Mandatory (sandbox)	object	No
content.context.endCustomer.id	"customer_promo"	Mandatory (sandbox)	string	No (routing)
content.bets[].selections[].type	"payout-modifier"	Mandatory	string	No (routing)
content.bets[].selections[].reference	"pref-1"	Mandatory (demo)	string	No (echoed)
content.bets[].selections[].description	"payout-mod"	Optional	string	No (echoed)
content.bets[].selections[].selection	nested UF	Mandatory	object	No (event routing)

endCustomer / endCustomer.id are optional in the Ticket 3.0 schema but mandatory for this sandbox scenario (routing). Ignored by sandbox means the field is not used for routing and not used when building the reply (schema-only for the WebSocket / Ticket 3.0 envelope).

Expected response

Java getter	Expected value
getStatus()	AcceptanceStatus.ACCEPTED
getCode()	0
getMessage()	"accepted" (sandbox)

{
  "correlationId": "corr-1",
  "timestampUtc": 1710000001000,
  "operation": "ticket-placement",
  "version": "3.0",
  "content": {
    "type": "ticket-reply",
    "ticketId": "tid-payout-mod",
    "status": "accepted",
    "code": 0,
    "message": "accepted",
    "signature": "sandbox-signature",
    "betDetails": [{
      "betId": "bet-1",
      "code": 0,
      "message": "accepted",
      "selectionDetails": [{
        "code": 0,
        "message": "accepted [sandbox=customer=customer_promo,selection=payout-modifier]",
        "selection": {
          "type": "payout-modifier",
          "reference": "pref-1",
          "description": "payout-mod",
          "selection": {
            "type": "uf",
            "eventId": "sr:match:15050881",
            "marketId": "m1",
            "outcomeId": "o1",
            "productId": "3",
            "odds": { "type": "decimal", "value": "2.0" }
          }
        }
      }]
    }]
  }
}

Common mistakes

Mistake	Result
Missing nested UF / wrong event	Route mismatch
Wrong customer	Not promo family

See also: Error responses in the parent manual.