# Wallet API
The Wallet API is called by the Supplier. The Supplier sends wallet transactions to Hub88, which are processed and then send forwards to the Operators.
### Request consistency
**Wallet API** requests have to be idempotent. All requests contain a `request_uuid` field. Hub88 will ensure that requests with the same `request_uuid` are not processed twice, while the response will be the same for all duplicate requests, excluding the `/supplier/generic/v2/user/balance` call.
***
## Wallet API Reference - Supplier API
***
### Get a user's balance
***
{% hint style="info" %}
**Requires an active session**
This endpoint requires a valid, active session token. The session is activated only after the Supplier returns a successful [`/game/url`](https://docs.hub88.io/developer-docs/games-api#get-a-game-url) response to Hub88.
If `/user/balance` is called before `/game/url` has returned successfully, Hub88 will respond with `RS_ERROR_INVALID_TOKEN`. Make sure your integration calls this endpoint only after the game URL has been returned and the player has been redirected to the game.
See the [Real gameplay flow](https://docs.hub88.io/developer-docs/supplier-api-reference/supplier-api-overview#real-gameplay) for the expected sequence.
{% endhint %}
## POST /supplier/generic/v2/user/balance
> The endpoint should be called when a user's balance is needed by the Supplier. Hub88 will return user's current balance. Game identifier is provided to help Hub88 with user's activity statistics.
```json
{"openapi":"3.1.1","info":{"title":"Hub88","version":"2.0"},"tags":[{"name":"Wallet API","description":"Hub88 is expected to provide API for Game Provider's calls. API will process the described requests from Game Provider."}],"paths":{"/supplier/generic/v2/user/balance":{"post":{"tags":["Wallet API"],"summary":"","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response"}}}}},"parameters":[{"schema":{"type":"string"},"required":true,"name":"X-Hub88-Signature","in":"header","description":"RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided `operator_id`."}],"operationId":"/supplier/generic/v2/user/balance","description":"The endpoint should be called when a user's balance is needed by the Supplier. Hub88 will return user's current balance. Game identifier is provided to help Hub88 with user's activity statistics.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["game_code","token","request_uuid"],"properties":{"supplier_user":{"$ref":"#/components/schemas/supplier_user"},"token":{"type":"string","description":"The game session token that was passed within `/game/url` endpoint request."},"request_uuid":{"$ref":"#/components/schemas/request_uuid"},"game_code":{"$ref":"#/components/schemas/game_code"}}}}},"required":true,"description":""}}}},"components":{"schemas":{"Response":{"type":"object","title":"Response","required":["user","status","request_uuid"],"properties":{"user":{"$ref":"#/components/schemas/user"},"status":{"$ref":"#/components/schemas/status"},"request_uuid":{"$ref":"#/components/schemas/request_uuid"},"currency":{"$ref":"#/components/schemas/currency"},"balance":{"$ref":"#/components/schemas/money_amount"}},"description":"Wallet API response"},"user":{"type":"string","description":"The unique user ID in the Hub88's system. In case of DEMO gameplay, this parameter may be omitted."},"status":{"type":"string","enum":["RS_OK","RS_ERROR_UNKNOWN","RS_ERROR_INVALID_PARTNER","RS_ERROR_INVALID_TOKEN","RS_ERROR_INVALID_GAMERS_ERROR_WRONG_CURRENCY","RS_ERROR_NOT_ENOUGH_MONEY","RS_ERROR_USER_DISABLED","RS_ERROR_INVALID_SIGNATURE","RS_ERROR_TOKEN_EXPIRED","RS_ERROR_WRONG_SYNTAX","RS_ERROR_WRONG_TYPES","RS_ERROR_DUPLICATE_TRANSACTION","RS_ERROR_TRANSACTION_DOES_NOT_EXIST","RS_ERROR_LIMIT_REACHED"],"description":"The response status."},"request_uuid":{"type":"string","description":"A standard 16-byte unique user identifier. The ID can be used as network layer action. An ID of an action that is generated for each game Supplier's call to Hub88. It's Used to sync Hub88 and game Supplier's sides for debugging purposes. Hub88 has to respond with the same request_uuid as the one that was received in request."},"currency":{"type":"string","enum":["BSD","TTD","ZMW","BMD","USD","BYR","UGX","HKD","MGA","GIP","UZS","MKD","PTS","mLTC","EGP","AWG","CZK","ILS","MZN","TND","XPF","SOS","DOP","RUB","KRW","BTN","KGS","BAM","AOA","SOC","AMS","BND","RSD","FKP","PEN","EOS","GHS","JPY","TRY","SBD","UAH","LTL","FJD","GNF","MDL","AFN","ZAR","MOP","TJS","BOB","JMD","QAR","IRR","SYP","XXX","NAD","MYR","CUP","NOK","BGN","KPW","MNT","NZD","uETH","SGD","PYG","OMR","DZD","EUR","TMT","MMK","PTQ","ANG","TZS","CRC","VES","ETB","THB","ZWD","LYD","CHF","MVR","KES","CVE","LSL","KMF","SZL","KYD","BRL","AED","WST","YER","ALL","TRX","HUF","GTQ","uBTC","IDR","MWK","CUC","DKK","TWD","XCD","BBD","LRD","KZT","JOD","BYN","BIF","PLN","SDG","VUV","SEK","BDT","HNL","BWP","VND","ISK","SLL","BHD","HTG","USDT","ADA","MUR","ERN","uLTC","LKR","COP","GEL","AUD","GBP","CAD","PHP","PAB","DJF","GMD","PKR","NIO","AMD","RWF","RON","NGN","TOP","UYU","AZN","SRD","KWD","PGK","CDF","SAR","IQD","XRP","SCR","mETH","MAD","GYD","INR","LBP","ARS","MXN","CLP","BNB","CNY","KHR","LAK","HRK","BZD","SSP","XOF","X5T","MRO","NPR","mBTC"],"description":"The ISO 4217 currency code. The following list contains all currencies supported by the Hub88 system. Note that native game play support with these currencies may vary per Provider. "},"money_amount":{"type":"integer","description":"The amount of money is displayed in integers **(Int64)**. To convert real float value to integer Hub88 multiplys it by 100000. Example: `$3.56` must be represented as `356000`"},"supplier_user":{"type":"string","description":"The user ID in the Supplier's system. If the Supplier renames Hub88's user IDs in any way(prefixes, etc.), the Supplier should send changed user IDs in this field to inform Hub88 about the renaming."},"game_code":{"type":"string","description":"The unique game identifier in Provider's system in the form of a string. `game_code` can be obtained from the `/game/list` endpoint and is a required parameter."}}}}
```
***
### Update a user's balance based on transaction bet
***
## POST /supplier/generic/v2/transaction/bet
> The endpoint should be called when the user places a bet (debit). Hub88 decrease users balance by \`amount\` and respond with the updated user balance.\
> Each bet has a \`transaction\_uuid\` which is a unique identifier for this transaction. Before altering the user's balance, Hub88 has to check that the transaction with such \`transaction\_uuid\` hasn't been processed previously. \
> Retry Policy: In case of a network failure (HTTP 502, timeout, nxdomain, etc.) or unsuccessful status (excluding \`RS\_ERROR\_NOT\_ENOUGH\_MONEY\` and \`RS\_ERROR\_LIMIT\_REACHED\`), the Supplier should roll back the transaction.
```json
{"openapi":"3.1.1","info":{"title":"Hub88","version":"2.0"},"tags":[{"name":"Wallet API","description":"Hub88 is expected to provide API for Game Provider's calls. API will process the described requests from Game Provider."}],"paths":{"/supplier/generic/v2/transaction/bet":{"post":{"tags":["Wallet API"],"summary":"","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response"}}}}},"parameters":[{"schema":{"type":"string"},"required":true,"name":"X-Hub88-Signature","in":"header","description":"RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided `operator_id`."}],"operationId":"/supplier/generic/v2/transaction/bet","description":"The endpoint should be called when the user places a bet (debit). Hub88 decrease users balance by `amount` and respond with the updated user balance.\n Each bet has a `transaction_uuid` which is a unique identifier for this transaction. Before altering the user's balance, Hub88 has to check that the transaction with such `transaction_uuid` hasn't been processed previously. \n Retry Policy: In case of a network failure (HTTP 502, timeout, nxdomain, etc.) or unsuccessful status (excluding `RS_ERROR_NOT_ENOUGH_MONEY` and `RS_ERROR_LIMIT_REACHED`), the Supplier should roll back the transaction.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["game_code","round_closed","round","currency","amount","token","transaction_uuid","request_uuid"],"properties":{"supplier_user":{"$ref":"#/components/schemas/supplier_user"},"transaction_uuid":{"$ref":"#/components/schemas/transaction_uuid"},"token":{"type":"string","description":"The game session token that was passed within `/game/url` endpoint request."},"round_closed":{"$ref":"#/components/schemas/round_closed"},"round":{"$ref":"#/components/schemas/round"},"reward_uuid":{"type":"string","description":"The unique identifier for an reward on Hub88 side in standard 16-byte UUID format. `reward_uuid` is required when freespins are issued through the API."},"request_uuid":{"$ref":"#/components/schemas/request_uuid"},"is_free":{"$ref":"#/components/schemas/is_free"},"is_aggregated":{"description":"","$ref":"#/components/schemas/is_aggregated"},"game_code":{"$ref":"#/components/schemas/game_code"},"currency":{"$ref":"#/components/schemas/currency"},"bet":{"$ref":"#/components/schemas/bet"},"amount":{"$ref":"#/components/schemas/money_amount"},"meta":{"$ref":"#/components/schemas/meta"}}}}},"required":true,"description":""}}}},"components":{"schemas":{"Response":{"type":"object","title":"Response","required":["user","status","request_uuid"],"properties":{"user":{"$ref":"#/components/schemas/user"},"status":{"$ref":"#/components/schemas/status"},"request_uuid":{"$ref":"#/components/schemas/request_uuid"},"currency":{"$ref":"#/components/schemas/currency"},"balance":{"$ref":"#/components/schemas/money_amount"}},"description":"Wallet API response"},"user":{"type":"string","description":"The unique user ID in the Hub88's system. In case of DEMO gameplay, this parameter may be omitted."},"status":{"type":"string","enum":["RS_OK","RS_ERROR_UNKNOWN","RS_ERROR_INVALID_PARTNER","RS_ERROR_INVALID_TOKEN","RS_ERROR_INVALID_GAMERS_ERROR_WRONG_CURRENCY","RS_ERROR_NOT_ENOUGH_MONEY","RS_ERROR_USER_DISABLED","RS_ERROR_INVALID_SIGNATURE","RS_ERROR_TOKEN_EXPIRED","RS_ERROR_WRONG_SYNTAX","RS_ERROR_WRONG_TYPES","RS_ERROR_DUPLICATE_TRANSACTION","RS_ERROR_TRANSACTION_DOES_NOT_EXIST","RS_ERROR_LIMIT_REACHED"],"description":"The response status."},"request_uuid":{"type":"string","description":"A standard 16-byte unique user identifier. The ID can be used as network layer action. An ID of an action that is generated for each game Supplier's call to Hub88. It's Used to sync Hub88 and game Supplier's sides for debugging purposes. Hub88 has to respond with the same request_uuid as the one that was received in request."},"currency":{"type":"string","enum":["BSD","TTD","ZMW","BMD","USD","BYR","UGX","HKD","MGA","GIP","UZS","MKD","PTS","mLTC","EGP","AWG","CZK","ILS","MZN","TND","XPF","SOS","DOP","RUB","KRW","BTN","KGS","BAM","AOA","SOC","AMS","BND","RSD","FKP","PEN","EOS","GHS","JPY","TRY","SBD","UAH","LTL","FJD","GNF","MDL","AFN","ZAR","MOP","TJS","BOB","JMD","QAR","IRR","SYP","XXX","NAD","MYR","CUP","NOK","BGN","KPW","MNT","NZD","uETH","SGD","PYG","OMR","DZD","EUR","TMT","MMK","PTQ","ANG","TZS","CRC","VES","ETB","THB","ZWD","LYD","CHF","MVR","KES","CVE","LSL","KMF","SZL","KYD","BRL","AED","WST","YER","ALL","TRX","HUF","GTQ","uBTC","IDR","MWK","CUC","DKK","TWD","XCD","BBD","LRD","KZT","JOD","BYN","BIF","PLN","SDG","VUV","SEK","BDT","HNL","BWP","VND","ISK","SLL","BHD","HTG","USDT","ADA","MUR","ERN","uLTC","LKR","COP","GEL","AUD","GBP","CAD","PHP","PAB","DJF","GMD","PKR","NIO","AMD","RWF","RON","NGN","TOP","UYU","AZN","SRD","KWD","PGK","CDF","SAR","IQD","XRP","SCR","mETH","MAD","GYD","INR","LBP","ARS","MXN","CLP","BNB","CNY","KHR","LAK","HRK","BZD","SSP","XOF","X5T","MRO","NPR","mBTC"],"description":"The ISO 4217 currency code. The following list contains all currencies supported by the Hub88 system. Note that native game play support with these currencies may vary per Provider. "},"money_amount":{"type":"integer","description":"The amount of money is displayed in integers **(Int64)**. To convert real float value to integer Hub88 multiplys it by 100000. Example: `$3.56` must be represented as `356000`"},"supplier_user":{"type":"string","description":"The user ID in the Supplier's system. If the Supplier renames Hub88's user IDs in any way(prefixes, etc.), the Supplier should send changed user IDs in this field to inform Hub88 about the renaming."},"transaction_uuid":{"type":"string","description":"The unique transaction identifier. An ID of business logic action (transaction) that needs to be stored on both sides for at least 4 months (for reconciliation purposes). Hub88 has to respond on each `transaction_uuid`. An action with same `transaction_uuid` must not be processed more than once."},"round_closed":{"type":["boolean","null"],"description":"Denotes when the round is closed."},"round":{"nullable":false,"type":"string","description":"The game round ID used to relate all bets and wins made in one round. All transactions related to the same round have the same value in this field. The ID is not unique through whole system. The value depends on Supplier's RGS logic, as it is created from game + user + round combination, resulting in uniqueness."},"is_free":{"type":["boolean","null"],"description":"The flag which indicates that the transaction is tied to a reward issued via Hub88’s Freebets API and if promo transaction contributes to GGR calculation or not. Set to `true` when the transaction is the result of a previously created reward and does not contribute to GGR calculation. When `false`, the transaction is not connected to a Hub88 Freebets API (e.g. the transaction is a regular gameplay or supplier-managed promotions), and contributes to GGR calculation."},"is_aggregated":{"type":["boolean","null"],"description":"The flag which shows that related freebet transactions identified in the field `reward_uuid` have been aggregated into one single transaction. For example, a player was rewarded ten (10) freespins, but the Supplier sends one single transaction request with field `is_aggregated` set to true."},"game_code":{"type":"string","description":"The unique game identifier in Provider's system in the form of a string. `game_code` can be obtained from the `/game/list` endpoint and is a required parameter."},"bet":{"type":["string","null"],"description":"The field for metadata related to transaction, such as type of bet, value, time, etc. Differs from game to game. Not relevant for transaction processing procedure but could be useful for statistics or activity backtracking."},"meta":{"type":["object","null"],"description":"The transaction metadata, enriches the transaction payload for processing. In cases where `is_supplier_promo: true`, in `meta` object `meta.supplier_promo_info.promo_reference` string should be included. It's an optional promotion reference identifier provided by the supplier, used for tracking, audit, or reconciliation of supplier-managed promotions."}}}}
```
***
### Update a user's balance based on transaction win
***
## POST /supplier/generic/v2/transaction/win
> The endpoint should be called when the user wins (credit). Hub88 will increase the user's balance by \`amount\` and respond with the updated user balance. \`reference\_transaction\_uuid\` shows which bet this win is related to.\
> Each win has a \`transaction\_uuid\` which is a unique identifier for this transaction. Before altering user's balance, Hub88 will check that the win hasn't been processed previously. \
> Retry Policy: In case of a network failure (HTTP 502, timeout, nxdomain, etc.) or unsuccessful status, the Supplier must retry the transaction.
```json
{"openapi":"3.1.1","info":{"title":"Hub88","version":"2.0"},"tags":[{"name":"Wallet API","description":"Hub88 is expected to provide API for Game Provider's calls. API will process the described requests from Game Provider."}],"paths":{"/supplier/generic/v2/transaction/win":{"post":{"tags":["Wallet API"],"summary":"","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response"}}}}},"parameters":[{"schema":{"type":"string"},"required":true,"name":"X-Hub88-Signature","in":"header","description":"RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided `operator_id`."}],"operationId":"/supplier/generic/v2/transaction/win","description":"The endpoint should be called when the user wins (credit). Hub88 will increase the user's balance by `amount` and respond with the updated user balance. `reference_transaction_uuid` shows which bet this win is related to.\n Each win has a `transaction_uuid` which is a unique identifier for this transaction. Before altering user's balance, Hub88 will check that the win hasn't been processed previously. \n Retry Policy: In case of a network failure (HTTP 502, timeout, nxdomain, etc.) or unsuccessful status, the Supplier must retry the transaction.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["game_code","round_closed","round","currency","amount","token","reference_transaction_uuid","transaction_uuid","request_uuid"],"properties":{"supplier_user":{"$ref":"#/components/schemas/supplier_user"},"transaction_uuid":{"$ref":"#/components/schemas/transaction_uuid"},"token":{"type":"string","description":"The game session token that was passed within `/game/url` endpoint request."},"round_closed":{"$ref":"#/components/schemas/round_closed"},"round":{"$ref":"#/components/schemas/round"},"reward_uuid":{"type":"string","description":"The unique identifier for an reward on Hub88 side in standard 16-byte UUID format. `reward_uuid` is required when freespins are issued through the API."},"request_uuid":{"$ref":"#/components/schemas/request_uuid"},"reference_transaction_uuid":{"$ref":"#/components/schemas/reference_transaction_uuid"},"is_free":{"$ref":"#/components/schemas/is_free"},"is_aggregated":{"description":"","$ref":"#/components/schemas/is_aggregated"},"is_supplier_promo":{"type":"boolean","description":"Indicates whether the game Supplier has granted a promotion either on their own side or through Hub88 Freebets API.\n \n If `true`, the transaction should be treated as a promotion (i.e. `is_supplier_promo: true` ).\n \n If `false`, the transaction should be treated either as a normal transaction or as a transaction from a reward. The `is_free` flag dictates the behaviour in combination with `is_supplier_promo` as follows:\n \n `is_free: false` | `is_supplier_promo: true` Transaction related to a promotion on the Supplier's side, and will contribute to GGR. \n \n `is_free: true` | `is_supplier_promo: true` Transaction related to a promotion on the Supplier's side, and it won’t contribute into GGR. In this case, Hub88 does not require a reference to the original bet. For these transactions: `amount` should be set to zero for a Bet, and `amount` must be a positive number for a Win.\n \n `is_free: true` | `is_supplier_promo: false` Transaction related to a previous Reward issued via Hub88’s Freebets API.\n \n `is_free: false` | `is_supplier_promo: false` (or null, or omitted) Transaction related to a normal gameplay."},"game_code":{"$ref":"#/components/schemas/game_code"},"currency":{"$ref":"#/components/schemas/currency"},"bet":{"$ref":"#/components/schemas/bet"},"amount":{"$ref":"#/components/schemas/money_amount"},"meta":{"$ref":"#/components/schemas/meta"}}}}},"required":true,"description":""}}}},"components":{"schemas":{"Response":{"type":"object","title":"Response","required":["user","status","request_uuid"],"properties":{"user":{"$ref":"#/components/schemas/user"},"status":{"$ref":"#/components/schemas/status"},"request_uuid":{"$ref":"#/components/schemas/request_uuid"},"currency":{"$ref":"#/components/schemas/currency"},"balance":{"$ref":"#/components/schemas/money_amount"}},"description":"Wallet API response"},"user":{"type":"string","description":"The unique user ID in the Hub88's system. In case of DEMO gameplay, this parameter may be omitted."},"status":{"type":"string","enum":["RS_OK","RS_ERROR_UNKNOWN","RS_ERROR_INVALID_PARTNER","RS_ERROR_INVALID_TOKEN","RS_ERROR_INVALID_GAMERS_ERROR_WRONG_CURRENCY","RS_ERROR_NOT_ENOUGH_MONEY","RS_ERROR_USER_DISABLED","RS_ERROR_INVALID_SIGNATURE","RS_ERROR_TOKEN_EXPIRED","RS_ERROR_WRONG_SYNTAX","RS_ERROR_WRONG_TYPES","RS_ERROR_DUPLICATE_TRANSACTION","RS_ERROR_TRANSACTION_DOES_NOT_EXIST","RS_ERROR_LIMIT_REACHED"],"description":"The response status."},"request_uuid":{"type":"string","description":"A standard 16-byte unique user identifier. The ID can be used as network layer action. An ID of an action that is generated for each game Supplier's call to Hub88. It's Used to sync Hub88 and game Supplier's sides for debugging purposes. Hub88 has to respond with the same request_uuid as the one that was received in request."},"currency":{"type":"string","enum":["BSD","TTD","ZMW","BMD","USD","BYR","UGX","HKD","MGA","GIP","UZS","MKD","PTS","mLTC","EGP","AWG","CZK","ILS","MZN","TND","XPF","SOS","DOP","RUB","KRW","BTN","KGS","BAM","AOA","SOC","AMS","BND","RSD","FKP","PEN","EOS","GHS","JPY","TRY","SBD","UAH","LTL","FJD","GNF","MDL","AFN","ZAR","MOP","TJS","BOB","JMD","QAR","IRR","SYP","XXX","NAD","MYR","CUP","NOK","BGN","KPW","MNT","NZD","uETH","SGD","PYG","OMR","DZD","EUR","TMT","MMK","PTQ","ANG","TZS","CRC","VES","ETB","THB","ZWD","LYD","CHF","MVR","KES","CVE","LSL","KMF","SZL","KYD","BRL","AED","WST","YER","ALL","TRX","HUF","GTQ","uBTC","IDR","MWK","CUC","DKK","TWD","XCD","BBD","LRD","KZT","JOD","BYN","BIF","PLN","SDG","VUV","SEK","BDT","HNL","BWP","VND","ISK","SLL","BHD","HTG","USDT","ADA","MUR","ERN","uLTC","LKR","COP","GEL","AUD","GBP","CAD","PHP","PAB","DJF","GMD","PKR","NIO","AMD","RWF","RON","NGN","TOP","UYU","AZN","SRD","KWD","PGK","CDF","SAR","IQD","XRP","SCR","mETH","MAD","GYD","INR","LBP","ARS","MXN","CLP","BNB","CNY","KHR","LAK","HRK","BZD","SSP","XOF","X5T","MRO","NPR","mBTC"],"description":"The ISO 4217 currency code. The following list contains all currencies supported by the Hub88 system. Note that native game play support with these currencies may vary per Provider. "},"money_amount":{"type":"integer","description":"The amount of money is displayed in integers **(Int64)**. To convert real float value to integer Hub88 multiplys it by 100000. Example: `$3.56` must be represented as `356000`"},"supplier_user":{"type":"string","description":"The user ID in the Supplier's system. If the Supplier renames Hub88's user IDs in any way(prefixes, etc.), the Supplier should send changed user IDs in this field to inform Hub88 about the renaming."},"transaction_uuid":{"type":"string","description":"The unique transaction identifier. An ID of business logic action (transaction) that needs to be stored on both sides for at least 4 months (for reconciliation purposes). Hub88 has to respond on each `transaction_uuid`. An action with same `transaction_uuid` must not be processed more than once."},"round_closed":{"type":["boolean","null"],"description":"Denotes when the round is closed."},"round":{"nullable":false,"type":"string","description":"The game round ID used to relate all bets and wins made in one round. All transactions related to the same round have the same value in this field. The ID is not unique through whole system. The value depends on Supplier's RGS logic, as it is created from game + user + round combination, resulting in uniqueness."},"reference_transaction_uuid":{"type":"string","description":"The unique identifier of the transaction which is referenced. In case of a rollback, this field will contain the transaction_uuid of the transaction which needs to be rolled back. In case of win, there will be transaction_uuid of the bet to which the win is related to."},"is_free":{"type":["boolean","null"],"description":"The flag which indicates that the transaction is tied to a reward issued via Hub88’s Freebets API and if promo transaction contributes to GGR calculation or not. Set to `true` when the transaction is the result of a previously created reward and does not contribute to GGR calculation. When `false`, the transaction is not connected to a Hub88 Freebets API (e.g. the transaction is a regular gameplay or supplier-managed promotions), and contributes to GGR calculation."},"is_aggregated":{"type":["boolean","null"],"description":"The flag which shows that related freebet transactions identified in the field `reward_uuid` have been aggregated into one single transaction. For example, a player was rewarded ten (10) freespins, but the Supplier sends one single transaction request with field `is_aggregated` set to true."},"game_code":{"type":"string","description":"The unique game identifier in Provider's system in the form of a string. `game_code` can be obtained from the `/game/list` endpoint and is a required parameter."},"bet":{"type":["string","null"],"description":"The field for metadata related to transaction, such as type of bet, value, time, etc. Differs from game to game. Not relevant for transaction processing procedure but could be useful for statistics or activity backtracking."},"meta":{"type":["object","null"],"description":"The transaction metadata, enriches the transaction payload for processing. In cases where `is_supplier_promo: true`, in `meta` object `meta.supplier_promo_info.promo_reference` string should be included. It's an optional promotion reference identifier provided by the supplier, used for tracking, audit, or reconciliation of supplier-managed promotions."}}}}
```
***
### Update a user's balance based on transaction rollback
***
## POST /supplier/generic/v2/transaction/rollback
> The endpoint should be called when the Supplier receives any status other than \`RS\_OK\`,\`RS\_ERROR\_LIMIT\_REACHED\` , \`RS\_ERROR\_NOT\_ENOUGH\_MONEY\`. Hub88 will then find the referenced transaction, roll back its effects and return the users new balance.\
> Retry Policy: In case of a network failure (HTTP 502, timeout, nxdomain, etc.) or unsuccessful status, the Supplier should retry the transaction.
```json
{"openapi":"3.1.1","info":{"title":"Hub88","version":"2.0"},"tags":[{"name":"Wallet API","description":"Hub88 is expected to provide API for Game Provider's calls. API will process the described requests from Game Provider."}],"paths":{"/supplier/generic/v2/transaction/rollback":{"post":{"tags":["Wallet API"],"summary":"","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response"}}}}},"parameters":[{"schema":{"type":"string"},"required":true,"name":"X-Hub88-Signature","in":"header","description":"RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided `operator_id`."}],"operationId":"/supplier/generic/v2/transaction/rollback","description":"The endpoint should be called when the Supplier receives any status other than `RS_OK`,`RS_ERROR_LIMIT_REACHED` , `RS_ERROR_NOT_ENOUGH_MONEY`. Hub88 will then find the referenced transaction, roll back its effects and return the users new balance.\n Retry Policy: In case of a network failure (HTTP 502, timeout, nxdomain, etc.) or unsuccessful status, the Supplier should retry the transaction.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["game_code","token","reference_transaction_uuid","transaction_uuid","request_uuid"],"properties":{"supplier_user":{"$ref":"#/components/schemas/supplier_user"},"transaction_uuid":{"$ref":"#/components/schemas/transaction_uuid"},"token":{"type":"string","description":"The game session token that was passed within `/game/url` endpoint request."},"round_closed":{"$ref":"#/components/schemas/round_closed"},"round":{"$ref":"#/components/schemas/round"},"request_uuid":{"$ref":"#/components/schemas/request_uuid"},"reference_transaction_uuid":{"$ref":"#/components/schemas/reference_transaction_uuid"},"game_code":{"$ref":"#/components/schemas/game_code"},"meta":{"$ref":"#/components/schemas/meta"}}}}},"required":true,"description":""}}}},"components":{"schemas":{"Response":{"type":"object","title":"Response","required":["user","status","request_uuid"],"properties":{"user":{"$ref":"#/components/schemas/user"},"status":{"$ref":"#/components/schemas/status"},"request_uuid":{"$ref":"#/components/schemas/request_uuid"},"currency":{"$ref":"#/components/schemas/currency"},"balance":{"$ref":"#/components/schemas/money_amount"}},"description":"Wallet API response"},"user":{"type":"string","description":"The unique user ID in the Hub88's system. In case of DEMO gameplay, this parameter may be omitted."},"status":{"type":"string","enum":["RS_OK","RS_ERROR_UNKNOWN","RS_ERROR_INVALID_PARTNER","RS_ERROR_INVALID_TOKEN","RS_ERROR_INVALID_GAMERS_ERROR_WRONG_CURRENCY","RS_ERROR_NOT_ENOUGH_MONEY","RS_ERROR_USER_DISABLED","RS_ERROR_INVALID_SIGNATURE","RS_ERROR_TOKEN_EXPIRED","RS_ERROR_WRONG_SYNTAX","RS_ERROR_WRONG_TYPES","RS_ERROR_DUPLICATE_TRANSACTION","RS_ERROR_TRANSACTION_DOES_NOT_EXIST","RS_ERROR_LIMIT_REACHED"],"description":"The response status."},"request_uuid":{"type":"string","description":"A standard 16-byte unique user identifier. The ID can be used as network layer action. An ID of an action that is generated for each game Supplier's call to Hub88. It's Used to sync Hub88 and game Supplier's sides for debugging purposes. Hub88 has to respond with the same request_uuid as the one that was received in request."},"currency":{"type":"string","enum":["BSD","TTD","ZMW","BMD","USD","BYR","UGX","HKD","MGA","GIP","UZS","MKD","PTS","mLTC","EGP","AWG","CZK","ILS","MZN","TND","XPF","SOS","DOP","RUB","KRW","BTN","KGS","BAM","AOA","SOC","AMS","BND","RSD","FKP","PEN","EOS","GHS","JPY","TRY","SBD","UAH","LTL","FJD","GNF","MDL","AFN","ZAR","MOP","TJS","BOB","JMD","QAR","IRR","SYP","XXX","NAD","MYR","CUP","NOK","BGN","KPW","MNT","NZD","uETH","SGD","PYG","OMR","DZD","EUR","TMT","MMK","PTQ","ANG","TZS","CRC","VES","ETB","THB","ZWD","LYD","CHF","MVR","KES","CVE","LSL","KMF","SZL","KYD","BRL","AED","WST","YER","ALL","TRX","HUF","GTQ","uBTC","IDR","MWK","CUC","DKK","TWD","XCD","BBD","LRD","KZT","JOD","BYN","BIF","PLN","SDG","VUV","SEK","BDT","HNL","BWP","VND","ISK","SLL","BHD","HTG","USDT","ADA","MUR","ERN","uLTC","LKR","COP","GEL","AUD","GBP","CAD","PHP","PAB","DJF","GMD","PKR","NIO","AMD","RWF","RON","NGN","TOP","UYU","AZN","SRD","KWD","PGK","CDF","SAR","IQD","XRP","SCR","mETH","MAD","GYD","INR","LBP","ARS","MXN","CLP","BNB","CNY","KHR","LAK","HRK","BZD","SSP","XOF","X5T","MRO","NPR","mBTC"],"description":"The ISO 4217 currency code. The following list contains all currencies supported by the Hub88 system. Note that native game play support with these currencies may vary per Provider. "},"money_amount":{"type":"integer","description":"The amount of money is displayed in integers **(Int64)**. To convert real float value to integer Hub88 multiplys it by 100000. Example: `$3.56` must be represented as `356000`"},"supplier_user":{"type":"string","description":"The user ID in the Supplier's system. If the Supplier renames Hub88's user IDs in any way(prefixes, etc.), the Supplier should send changed user IDs in this field to inform Hub88 about the renaming."},"transaction_uuid":{"type":"string","description":"The unique transaction identifier. An ID of business logic action (transaction) that needs to be stored on both sides for at least 4 months (for reconciliation purposes). Hub88 has to respond on each `transaction_uuid`. An action with same `transaction_uuid` must not be processed more than once."},"round_closed":{"type":["boolean","null"],"description":"Denotes when the round is closed."},"round":{"nullable":false,"type":"string","description":"The game round ID used to relate all bets and wins made in one round. All transactions related to the same round have the same value in this field. The ID is not unique through whole system. The value depends on Supplier's RGS logic, as it is created from game + user + round combination, resulting in uniqueness."},"reference_transaction_uuid":{"type":"string","description":"The unique identifier of the transaction which is referenced. In case of a rollback, this field will contain the transaction_uuid of the transaction which needs to be rolled back. In case of win, there will be transaction_uuid of the bet to which the win is related to."},"game_code":{"type":"string","description":"The unique game identifier in Provider's system in the form of a string. `game_code` can be obtained from the `/game/list` endpoint and is a required parameter."},"meta":{"type":["object","null"],"description":"The transaction metadata, enriches the transaction payload for processing. In cases where `is_supplier_promo: true`, in `meta` object `meta.supplier_promo_info.promo_reference` string should be included. It's an optional promotion reference identifier provided by the supplier, used for tracking, audit, or reconciliation of supplier-managed promotions."}}}}
```