external_bet

Goal: Place an external selection as customer_external on event ext:match:39999 and receive accepted.

Use Selection.newExtSelectionBuilder().setEvent("ext:match:39999").setOutcome("ext-pre:22017:s00").setExpSettleTime(...).setOdds(...). Wire type "external".

How to build the request (Java SDK)

1

Create the end customer

Use EndCustomer customer_external.

2

Add the external selection

Use a top-level external selection (not UF) with event ext:match:39999.

3

Set the stake and send the ticket

Use a cash stake and 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.selection.UfSelection;
import com.sportradar.mbs.sdk.entities.stake.Stake;
import java.math.BigDecimal;

TicketRequest request = TicketRequest.newBuilder()
    .setTicketId("tid-ext")
    .setContext(TicketContext.newBuilder()
        .setLimitId(123L)
        .setChannel(Channel.newMobileChannelBuilder()
            .setLang("en")
            .setIp("127.0.0.1")
            .setDeviceId("deviceId123")
            .build())
        .setEndCustomer(EndCustomer.newBuilder().setId("customer_external").build())
        .build())
    .setBets(Bet.newBuilder()
        .setBetId("bet-1")
        .setSelections(Selection.newExtSelectionBuilder()
            .setEvent("ext:match:39999")
            .setOutcome("ext-pre:22017:s00")
            .setExpSettleTime(1999999999999L)
            .setOdds(Odds.newDecimalOddsBuilder().setValue(new BigDecimal("1.10")).build())
            .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-ext",
    "context": {
      "limitId": 123,
      "channel": {
        "type": "mobile",
        "lang": "en",
        "ip": "127.0.0.1",
        "deviceId": "deviceId123"
      },
      "endCustomer": { "id": "customer_external" }
    },
    "bets": [{
      "betId": "bet-1",
      "selections": [{
        "type": "external",
        "event": "ext:match:39999",
        "outcome": "ext-pre:22017:s00",
        "expSettleTime": 1999999999999,
        "odds": { "type": "decimal", "value": "1.10" }
      }],
      "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_external"	Mandatory (sandbox)	string	No (routing)
content.bets[].selections[].type	"external"	Mandatory	string	No (routing)
content.bets[].selections[].event	"ext:match:39999"	Mandatory	string	No (routing)
content.bets[].selections[].outcome	"ext-pre:22017:s00"	Mandatory	string	No (echoed)
content.bets[].selections[].expSettleTime	1999999999999	Mandatory	integer	Yes
content.bets[].selections[].odds	decimal object	Mandatory	object	No
content.bets[].stake[].type	"cash"	Mandatory	string	No (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-ext",
    "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_external,oddsFormat=decimal,selection=external]",
        "selection": {
          "type": "external",
          "event": "ext:match:39999",
          "outcome": "ext-pre:22017:s00",
          "expSettleTime": 1999999999999,
          "odds": { "type": "decimal", "value": "1.10" }
        }
      }]
    }]
  }
}

Common mistakes

Mistake	Result
Using sr:match:… UF instead of external	Wrong scenario
Wrong external event id	Route mismatch

See also: Error responses in the parent manual.