BETCORE Aggregator
Provider IntegrationCasino IntegrationFeed Integration
Provider IntegrationCasino IntegrationFeed Integration
Visit Betcore website
Follow Betcore on Instagram
Follow Betcore on LinkedIn
Follow Betcore on Youtube
  1. Bets
  • PLEASE READ: Getting Started
  • Integrate BETCORE Games
    • Integrate BETCORE Games
    • WebFrame Connection
    • Promotional campaigns
    • Freebets
    • BETCORE API
      • Authentication
        • Token
          POST
        • Verify
          POST
        • Jwks
          GET
      • Payments
        • Accept
          POST
      • Rollbacks
        • Make
          POST
        • Accept
          POST
      • Cashback
        • Accept
          POST
    • PROMO API
      • Signing of server requests
      • FreeBets
        • Campaign/Create
          POST
        • Issue
          POST
        • Cancel
          POST
    • PARTNER API
      • Users
        • Auth
          POST
        • Data
          POST
      • Payments
        • Info
          POST
        • Make
          POST
        • Make-list
          POST
        • Close
          POST
      • Cashback
        • Make
          POST
  • Integrate YOUR Games
    • Integrate as Games Provider
    • PARTNER API
      • Games
        • Games
          GET
        • Launch
          POST
    • BETCORE API
      • Get Balance
        • Balance
          GET
      • Bets
        • PayIn
          POST
        • PayOut
          POST
        • PayInOut
          POST
        • Refund
          POST
  • Feed Integration
    • Feed Integration
    • REST API
      • Authorization
        • Token
          POST
      • Games
        • List
          GET
        • Info
          GET
        • Translations
          GET
      • Jackpot
        • Accumulated
          GET
    • Websocket
      • SubOnWholeGamesInfo
  1. Bets

PayOut

POST
/v1/sessions/{{sessionId}}/bets/pay-out

Overview#

The PayOut endpoint is used to process the payout transaction once the outcome of a bet is determined. This endpoint communicates the result of a game round by registering the winnings (or confirming a loss) for a placed bet. By doing so, it finalizes the bet lifecycle and updates the user’s balance accordingly.
The PayOut method allows to:
Process Bet Outcomes: Once the game round is completed, and the outcome (win/loss) is determined, this endpoint is used to process the payout.
Update User Balance: The response from the endpoint includes the updated account balance after the win is credited or a confirmed loss is acknowledged.
Link Transactions: The method uses a unique bet identifier (betId) that ties together the cash flow transactions (starting from bet placement via PayIn/PayInOut through to the eventual payout), ensuring traceability and consistency within one betting event.
CAUTION
If taxes apply, the winAmount parameter value must be the gross amount (before tax deduction).

Security and Authentication#

The PayOut endpoint, like other API requests within this integration, requires strict authentication to ensure that only authorized parties can interact with it. This is achieved through the use of mandatory HTTP headers. Please see the required headers below in the Header Params section.
📌
Signature of the request shall be calculated using HMAC-SHA256 algorithm and sent in "X-Sign" header of the request.
Please see How to calculate the X-Sign value.

Path Parameters#

ParameterTypeRequiredDescription
sessionIdstringYesGame Session id.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '/v1/sessions/{{sessionId}}/bets/pay-out' \
--header 'X-Counterparty-Id: 933a215f-a9e6-4f88-9d91-52a87cd50499' \
--header 'X-Timestamp: 1719766120806' \
--header 'X-Request-Id: 5a0679b6e5fa48f6892c777b0fa92392' \
--header 'X-Sign: c4d62f77cdfaadb6690b3bcbe5a0ca9ef1e5bf41d746d361a1269558eeb7ccd1' \
--header 'Content-Type: application/json' \
--data '{
    "betId": "62",
    "sessionId": "28",
    "winAmount": 207.4,
    "winOdd": 73948603.55065814,
    "taxAmount": 545.85,
    "maxPossibleWinAmount": 564.69,
    "maxPossibleWinTaxAmount": 556.05
}'
Response Response Example
200 - Successful response
{
  "transactionId": "389",
  "balance": 1588.5,
  "_responseCode": 1,
}
Previous
PayIn
Next
PayInOut
Built with