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
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
post
POST /operator/generic/v2/transfer_wallet/withdraw HTTP/1.1
Host: 
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
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
post
POST /operator/generic/v2/transfer_wallet/deposit HTTP/1.1
Host: 
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
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
post
POST /operator/generic/v2/transfer_wallet/create_wallet HTTP/1.1
Host: 
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
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
post
POST /operator/generic/v2/transfer_wallet/check_transfer HTTP/1.1
Host: 
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
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
post
POST /operator/generic/v2/transfer_wallet/balance HTTP/1.1
Host: 
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
}

Last updated

Was this helpful?