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

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)

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)

Common mistakes

Mistake
Result

Missing nested UF / wrong event

Route mismatch

Wrong customer

Not promo family

See also: Error responses in the parent manual.

Was this helpful?