Skip to main content

Wallet

Your exisitng wallet implementation can be used to authorise funds for wagering and receive payout information (via a simple REST API).

Wallet endpoint / security​

We'll call your supplied getHeaders function to receive a JWT token. Supply the URL of your REST API in the aud claim. We supply this token in the authorisation heard when we call your API to allow you to validate the request.

Debit Funds​

Before selling the bet we'll call your endpoint to request funds:

PUT debitFunds/{betdirector-transaction-id}

Request body: 
{
    amount: 1000,
    wagerData: {
    
    }
}

Response:
{
    amount: 1000,
    betDirectorTransactionId: '1-234-5678',
    walletTransactionId: '1234-5678'
}

Confirm​

Once we've verified we have the necessary funds we'll attempt to sell the bet. If the bet is successfully sold in the betting system we'll confirm the transaction has been completed:

PUT confirm/{wallet-transaction-id}

Request body: 
{
    betDirectorTransactionId: '1-234-5678',
    amount: 1000
}

Refund Funds​

If there's a problem selling the bet, we'll call let you know to refund the transaction:

PUT refundFunds/{wallet-transaction-id}

Request body: 
{
    betDirectorTransactionId: '1-234-5678',
    reasonCode: 'BettingOff',
    reasonString: 'Betting is closed'
}

Payout​

When the race is official and we know how much the ticket paid, we'll call to let you know the ticket liability:

PUT settle/{wallet-transaction-id}

Request body:
{
    betDirectorTransactionId: '1-234-5678',
    winnings: 2590,
    refunds: 100
}

Cancelation​

In case you need to cancel a wager, we host an API you can call:

PUT cancel

Request body:
{
    ticketId: '1-234-5678'
}