TransferWallet API

TransferWallet API is an optional API for implementing Transfer Wallet logic, which is available by request. The API provides a way for the Operator to deposit money to the player's account, withdraw money from the player's account and get the player's balance. Availability of TransferWallet API is per request.

---

TransferWallet API Reference

---

Withdraw money from user's wallet

---

post

Withdraw money from the user's wallet.

Header parameters

X-Hub88-SignaturestringRequired

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.

Body

application/json

userstringRequired

transaction_uuidstringRequired

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). Operator has to respond on each transaction_uuid. An action with same transaction_uuid shouldn't be processed more than once.

Example: 16d2dcfe-b89e-11e7-854a-58404eea6d16

sub_partner_idstringRequired

ID of Operator's sub-partner (brand, whitelabel, site, etc.) which uses same integration and credentials as an Operator. Used for detailed reporting and integration type switching. Sites under the same Operator can use different integration types: TransferWallet or SeamlessWallet. A single site (sub_partner_id) can NOT have both kinds of integration at the same time.

Example: my-casino-id

request_uuidstringRequired

An ID of an action that is generated for each of our calls to the Operator, used to sync Hub88 and Operator sides for debugging purposes, displayed in standard 16-byte UUID format. The Operator has to respond with the same request_uuid as the one received in request.

Example: 583c985f-fee6-4c0e-bbf5-308aad6265af

productstringOptional

Name of the Game Provider.

Example: OneTouch

operator_idintegerRequired

Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.

Example: 1

currencystring · enumRequired

The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:

amountintegerRequired

The amount of money displayed in integer (Int64) format. To convert real float value to integer, it is multiplied by 100000. Example: $3.56 is represented as 356000

Example: 100500

Responses

200

OK

application/json

Wallet API response

userstring · min: 3Required

The unique user ID in the Operator’s system. In case of DEMO gameplay, this parameter may be omitted.

Example: john12345

statusstring · enumRequired

Response status

Example: RS_OKPossible values:

request_uuidstringRequired

An ID of an action that is generated for each of our calls to the Operator, used to sync Hub88 and Operator sides for debugging purposes, displayed in standard 16-byte UUID format. The Operator has to respond with the same request_uuid as the one received in request.

Example: 583c985f-fee6-4c0e-bbf5-308aad6265af

currencystring · enumOptional

The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:

balanceintegerOptional

The amount of money displayed in integer (Int64) format. To convert real float value to integer, it is multiplied by 100000. Example: $3.56 is represented as 356000

Example: 100500

post

/operator/generic/v2/transfer_wallet/withdraw

HTTPcURLJavaScriptPython

POST /operator/generic/v2/transfer_wallet/withdraw HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 229

{
  "user": "text",
  "transaction_uuid": "16d2dcfe-b89e-11e7-854a-58404eea6d16",
  "sub_partner_id": "my-casino-id",
  "request_uuid": "583c985f-fee6-4c0e-bbf5-308aad6265af",
  "product": "OneTouch",
  "operator_id": 1,
  "currency": "EUR",
  "amount": 100500
}

200

OK

{
  "user": "Jimm123",
  "status": "RS_OK",
  "request_uuid": "583c985f-fee6-4c0e-bbf5-308aad6265af",
  "currency": "USD",
  "balance": 100500
}

---

Deposit money to user's wallet

---

post

Add and deposit money to the user's wallet.

Header parameters

X-Hub88-SignaturestringRequired

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.

Body

application/json

userstringRequired

transaction_uuidstringRequired

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). Operator has to respond on each transaction_uuid. An action with same transaction_uuid shouldn't be processed more than once.

Example: 16d2dcfe-b89e-11e7-854a-58404eea6d16

sub_partner_idstringRequired

ID of Operator's sub-partner (brand, whitelabel, site, etc.) which uses same integration and credentials as an Operator. Used for detailed reporting and integration type switching. Sites under the same Operator can use different integration types: TransferWallet or SeamlessWallet. A single site (sub_partner_id) can NOT have both kinds of integration at the same time.

Example: my-casino-id

request_uuidstringRequired

An ID of an action that is generated for each of our calls to the Operator, used to sync Hub88 and Operator sides for debugging purposes, displayed in standard 16-byte UUID format. The Operator has to respond with the same request_uuid as the one received in request.

Example: 583c985f-fee6-4c0e-bbf5-308aad6265af

productstringOptional

Name of the Game Provider.

Example: OneTouch

operator_idintegerRequired

Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.

Example: 1

currencystring · enumRequired

The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:

amountintegerRequired

The amount of money displayed in integer (Int64) format. To convert real float value to integer, it is multiplied by 100000. Example: $3.56 is represented as 356000

Example: 100500

Responses

200

OK

application/json

Wallet API response

userstring · min: 3Required

The unique user ID in the Operator’s system. In case of DEMO gameplay, this parameter may be omitted.

Example: john12345

statusstring · enumRequired

Response status

Example: RS_OKPossible values:

request_uuidstringRequired

An ID of an action that is generated for each of our calls to the Operator, used to sync Hub88 and Operator sides for debugging purposes, displayed in standard 16-byte UUID format. The Operator has to respond with the same request_uuid as the one received in request.

Example: 583c985f-fee6-4c0e-bbf5-308aad6265af

currencystring · enumOptional

The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:

balanceintegerOptional

The amount of money displayed in integer (Int64) format. To convert real float value to integer, it is multiplied by 100000. Example: $3.56 is represented as 356000

Example: 100500

post

/operator/generic/v2/transfer_wallet/deposit

HTTPcURLJavaScriptPython

POST /operator/generic/v2/transfer_wallet/deposit HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 229

{
  "user": "text",
  "transaction_uuid": "16d2dcfe-b89e-11e7-854a-58404eea6d16",
  "sub_partner_id": "my-casino-id",
  "request_uuid": "583c985f-fee6-4c0e-bbf5-308aad6265af",
  "product": "OneTouch",
  "operator_id": 1,
  "currency": "EUR",
  "amount": 100500
}

200

OK

{
  "user": "Jimm123",
  "status": "RS_OK",
  "request_uuid": "583c985f-fee6-4c0e-bbf5-308aad6265af",
  "currency": "USD",
  "balance": 100500
}

---

Create a wallet

---

post

Create a wallet. A TransferWallet can be either a Universal type or a Product type. Universal Wallet means that the user will have only one wallet for all Providers/Suppliers. Product Wallet means that the User will have several wallets, one per each product (Provider/Supplier).

Header parameters

X-Hub88-SignaturestringRequired

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.

Body

application/json

userstringRequired

sub_partner_idstringRequired

ID of Operator's sub-partner (brand, whitelabel, site, etc.) which uses same integration and credentials as an Operator. Used for detailed reporting and integration type switching. Sites under the same Operator can use different integration types: TransferWallet or SeamlessWallet. A single site (sub_partner_id) can NOT have both kinds of integration at the same time.

Example: my-casino-id

request_uuidstringRequired

An ID of an action that is generated for each of our calls to the Operator, used to sync Hub88 and Operator sides for debugging purposes, displayed in standard 16-byte UUID format. The Operator has to respond with the same request_uuid as the one received in request.

Example: 583c985f-fee6-4c0e-bbf5-308aad6265af

productstringOptional

Name of the Game Provider.

Example: OneTouch

operator_idintegerRequired

Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.

Example: 1

currencystring · enumRequired

The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:

Responses

200

OK

application/json

Wallet API response

userstring · min: 3Required

The unique user ID in the Operator’s system. In case of DEMO gameplay, this parameter may be omitted.

Example: john12345

statusstring · enumRequired

Response status

Example: RS_OKPossible values:

request_uuidstringRequired

An ID of an action that is generated for each of our calls to the Operator, used to sync Hub88 and Operator sides for debugging purposes, displayed in standard 16-byte UUID format. The Operator has to respond with the same request_uuid as the one received in request.

Example: 583c985f-fee6-4c0e-bbf5-308aad6265af

currencystring · enumOptional

The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:

balanceintegerOptional

The amount of money displayed in integer (Int64) format. To convert real float value to integer, it is multiplied by 100000. Example: $3.56 is represented as 356000

Example: 100500

post

/operator/generic/v2/transfer_wallet/create_wallet

HTTPcURLJavaScriptPython

POST /operator/generic/v2/transfer_wallet/create_wallet HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "user": "text",
  "sub_partner_id": "my-casino-id",
  "request_uuid": "583c985f-fee6-4c0e-bbf5-308aad6265af",
  "product": "OneTouch",
  "operator_id": 1,
  "currency": "EUR"
}

200

OK

{
  "user": "Jimm123",
  "status": "RS_OK",
  "request_uuid": "583c985f-fee6-4c0e-bbf5-308aad6265af",
  "currency": "USD",
  "balance": 100500
}

---

Get wallet status

---

post

The endpoint to check the status of the TransferWallet transactions(deposit/withdraw). If a transaction doesn't exist in the Hub88 system a RS_ERROR_TRANSACTION_DOES_NOT_EXIST status will be returned.

Header parameters

X-Hub88-SignaturestringRequired

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.

Body

application/json

userstringRequired

transaction_uuidstringRequired

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). Operator has to respond on each transaction_uuid. An action with same transaction_uuid shouldn't be processed more than once.

Example: 16d2dcfe-b89e-11e7-854a-58404eea6d16

sub_partner_idstringRequired

ID of Operator's sub-partner (brand, whitelabel, site, etc.) which uses same integration and credentials as an Operator. Used for detailed reporting and integration type switching. Sites under the same Operator can use different integration types: TransferWallet or SeamlessWallet. A single site (sub_partner_id) can NOT have both kinds of integration at the same time.

Example: my-casino-id

request_uuidstringRequired

An ID of an action that is generated for each of our calls to the Operator, used to sync Hub88 and Operator sides for debugging purposes, displayed in standard 16-byte UUID format. The Operator has to respond with the same request_uuid as the one received in request.

Example: 583c985f-fee6-4c0e-bbf5-308aad6265af

productstringOptional

Name of the Game Provider.

Example: OneTouch

operator_idintegerRequired

Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.

Example: 1

currencystring · enumRequired

The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:

Responses

200

OK

application/json

statusstring · enumRequired

Response status

Example: RS_OKPossible values:

post

/operator/generic/v2/transfer_wallet/check_transfer

HTTPcURLJavaScriptPython

POST /operator/generic/v2/transfer_wallet/check_transfer HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "user": "text",
  "transaction_uuid": "16d2dcfe-b89e-11e7-854a-58404eea6d16",
  "sub_partner_id": "my-casino-id",
  "request_uuid": "583c985f-fee6-4c0e-bbf5-308aad6265af",
  "product": "OneTouch",
  "operator_id": 1,
  "currency": "EUR"
}

200

OK

{
  "transaction": {
    "user": "john12345",
    "type": "CTT_WITHDRAW",
    "transaction_uuid": "c3da3b5a-cd7f-4957-86cb-993f56f81f26",
    "status": "CTS_SUCCESS",
    "cuurency": "USD",
    "balance": 0,
    "amount": 1000000
  },
  "status": "RS_OK"
}

---

Get wallet balance

---

post

Get a user's wallet balance.

Header parameters

X-Hub88-SignaturestringRequired

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.

Body

application/json

userstringRequired

sub_partner_idstringRequired

ID of Operator's sub-partner (brand, whitelabel, site, etc.) which uses same integration and credentials as an Operator. Used for detailed reporting and integration type switching. Sites under the same Operator can use different integration types: TransferWallet or SeamlessWallet. A single site (sub_partner_id) can NOT have both kinds of integration at the same time.

Example: my-casino-id

request_uuidstringRequired

An ID of an action that is generated for each of our calls to the Operator, used to sync Hub88 and Operator sides for debugging purposes, displayed in standard 16-byte UUID format. The Operator has to respond with the same request_uuid as the one received in request.

Example: 583c985f-fee6-4c0e-bbf5-308aad6265af

productstringOptional

Name of the Game Provider.

Example: OneTouch

operator_idintegerRequired

Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.

Example: 1

currencystring · enumRequired

The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:

Responses

200

OK

application/json

Wallet API response

userstring · min: 3Required

The unique user ID in the Operator’s system. In case of DEMO gameplay, this parameter may be omitted.

Example: john12345

statusstring · enumRequired

Response status

Example: RS_OKPossible values:

request_uuidstringRequired

An ID of an action that is generated for each of our calls to the Operator, used to sync Hub88 and Operator sides for debugging purposes, displayed in standard 16-byte UUID format. The Operator has to respond with the same request_uuid as the one received in request.

Example: 583c985f-fee6-4c0e-bbf5-308aad6265af

currencystring · enumOptional

The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:

balanceintegerOptional

The amount of money displayed in integer (Int64) format. To convert real float value to integer, it is multiplied by 100000. Example: $3.56 is represented as 356000

Example: 100500

post

/operator/generic/v2/transfer_wallet/balance

HTTPcURLJavaScriptPython

POST /operator/generic/v2/transfer_wallet/balance HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "user": "text",
  "sub_partner_id": "my-casino-id",
  "request_uuid": "583c985f-fee6-4c0e-bbf5-308aad6265af",
  "product": "OneTouch",
  "operator_id": 1,
  "currency": "EUR"
}

200

OK

{
  "user": "Jimm123",
  "status": "RS_OK",
  "request_uuid": "583c985f-fee6-4c0e-bbf5-308aad6265af",
  "currency": "USD",
  "balance": 100500
}