The Bet Brothers
HomeNewsLinkedIn
  • The Bet Brothers APIS
    • ๐ŸงฉCore Concepts
    • ๐Ÿ”API Flow
  • OPERATOR API
    • ๐Ÿ”—Operator Integration Service
    • ๐Ÿ”‘Protocol API
      • Create api-token
      • Revoke api-token
  • ๐Ÿš€Game Launcher API
    • Get Game Providers
    • Get Games
    • Launch Game in Demo Mode
    • Launch game in Real Mode
  • ๐Ÿ’ฐWallet API
    • Balance
    • Bet
    • Win
    • Refund
    • Rollback Win
  • โšกFree Spin API
    • Add Free Spin
    • Cancel Free Spin
  • ๐ŸŽฎGame Insights
    • Get Game Bet Levels
    • Get Round Info
  • ๐Ÿ“–Addendum
    • TBB Error Codes
    • Wallet Error Response
  • SUPPLIER API
    • ๐Ÿ”—Supplier Integration Service
    • ๐Ÿ”‘Supplier Protocol API
    • ๐Ÿš€Game Launcher API
      • Launch Game in Demo Mode
      • Launch Game in Real Mode
  • ๐ŸŽฒGame Events
    • Balance
    • Bet
    • Win
    • Refund
  • ๐Ÿ“–Addendum
    • TBB Error Codes
Powered by GitBook
On this page
  1. Wallet API

Refund

PreviousWinNextRollback Win

Last updated 10 days ago

๐Ÿ’ฐ
post

Processes a refund request for a specific transaction. The balance and transaction values follow ISO 4217 currency subunit conventions.

Header parameters
X-REQUEST-SIGNstringRequired

HMAC-SHA256 signature of the raw request body using the shared password.

Body
amountintegerRequired

Amount in subunits.

is_mobilebooleanRequired

True if the request is from a mobile device.

currency_codestringRequired

Identifier of currency (ISO 4217).

player_idstringRequired

Unique identifier of the player.

actionstring ยท enumRequired

Must be set to "refund".

Possible values:
Responses
200
Refund processed successfully.
application/json
406
Previous transaction not found.
application/json
post
POST /operator/wallet HTTP/1.1
Host: 
X-REQUEST-SIGN: text
Content-Type: application/json
Accept: */*
Content-Length: 314

{
  "amount": 10,
  "is_mobile": false,
  "currency_code": "EUR",
  "player_id": "6",
  "action": "refund",
  "payload": {
    "reference": "MadMonkey",
    "session_token": "c9cbb3d5-439f-acf6-9415ea68b20a",
    "provider_transfer_data": {
      "round_id": "864238",
      "transaction_id": "95303151",
      "refunded_transaction_id": "95303151",
      "table_reference": "c9cbb3d5"
    }
  }
}
{
  "transaction_id": "563214566",
  "balance": 54636,
  "currency_code": "EUR"
}