Credit

/credit

The Credit API enables the HPGames platform to deposit money to the player’s wallet through the merchant’s site. This financial transaction will be done when a bet is in its final state, Win or Lose. In case the player lost the bet, credit will be called with a deposit amount of 0.

4.6.1 Credit Request

Parameter Name	Data Type	Description	Required/Optional
merchantId	String	Merchant ID	Required
timestamp	long	Time representation in UNIX milliseconds format.	Required
betId	UUID	Unique HPGames bet id	Required
transactionId	UUID	Unique HPGames transaction id	Required
amount	decimal	Amount to be credited to the player’s wallet	Required
currency	String	The currency of bet amount, Currency code (ISO 4217)	Required
created	DateTime	Bet creation datetime (ISO format in UTC timezone with 6 digits of precision)	Required
gameId	int	Unique HPGames game id	Required
type	Enum	Request type [REGULAR, REWARD, JACKPOT]	Required
playerId	String	Merchant’s unique identification for each player	Required
hash	String	String to Encode: merchantId + betId + amount + transactionId + timestamp HMAC SHA256 Code Snippet	Required
rewardId	UUID	Reward Id assigned to player	Optional
rewardType	String	Reward type. Values : [FREE_BET]	Optional
authToken	String	Game session id	Required
jackpotId	UUID	Jackpot id	Optional

Request example:

{
  "merchantId": "21385394-6dda-4171-a003-02fa4a975643",
  "timestamp": 1643727556,
  "betId": "2185a9a1-1497-41bd-937d-cbce3fae8961",
  "transactionId": "1185a9a1-1497-41bd-937d-cbce3fae8961",
  "amount": 10,
  "currency": "EUR",
  "created": "2022-08-30T21:00:00.000000000Z",
  "gameId": 200100,
  "playerId": "d02b5979-6d2a-4830-80e2-bf3fa608a2f2",
  "hash": "0c8aec01f0caa85dd913be756fb8f2fd",
  "rewardId": "b5e10b6b-4d88-475c-9496-a461052a8448",
  "type": "REWARD",
  "rewardType": "FREE_BET",
  "authToken": "b5e10b6b-4d88-475c-9496-a461052a8448",
  "jackpotId": "019a4f98-5f3c-7189-b6e3-a555a3595e2c"
}

Credit Response

Parameter Name	Data Type	Description	Required/Optional
errorCode	int	Error code, default 0	Optional
errorText	String	Error message	Optional
balance	decimal	Player’s wallet balance	Required
currency	String	The currency of player’s balance, Currency code (ISO 4217)	Required
transactionId	UUID	Unique HPGames transaction id	Required. Should be returned in both success and error cases.
accountTransactionId	String	Merchant’s transaction id	Required

Response example:

{
  "errorCode": 0,
  "errorText": "",
  "balance": 1000.5,
  "currency": "EUR",
  "transactionId": "1185a9a1-1497-41bd-937d-cbce3fae8961",
  "accountTransactionId": "fbd0d754-6264-474f-9175-22ddc92c4061"
}

4.7 Bulk Credit

/bulkCredit

Hash is calculated for each credit request separately.

4.7.1 Bulk Credit Request

Parameter Name	Data Type	Description	Required/Optional
creditRequests	List<CreditRequest>	List of Credit Requests described in link	Required

Request example:

{
  "creditRequests": [
    {
      "timestamp": 1643727556,
      "betId": "2185a9a1-1497-41bd-937d-cbce3fae8961",
      "transactionId": "1185a9a1-1497-41bd-937d-cbce3fae8961",
      "amount": 10,
      "currency": "EUR",
      "created": "2022-08-30T21:00:00.000000000Z",
      "gameId": 200100,
      "playerId": "d02b5979-6d2a-4830-80e2-bf3fa608a2f2",
      "hash": "0c8aec01f0caa85dd913be756fb8f2fd",
      "rewardId": "b5e10b6b-4d88-475c-9496-a461052a8448",
      "type": "REWARD",
      "rewardType": "FREE_BET",
      "authToken": "b5e10b6b-4d88-475c-9496-a461052a8448",
      "jackpotId": "019a4f98-5f3c-7189-b6e3-a555a3595e2c"
    }
  ]
}

4.7.2 Bulk Credit Response

Parameter Name	Data Type	Description	Required/Optional
creditResponses	List<CreditResponse>	List of Credit Responses described in link	Required

Response example:

{
  "creditResponses": [
    {
      "errorCode": 0,
      "errorText": "",
      "balance": 1000.5,
      "currency": "EUR",
      "accountTransactionId": "fbd0d754-6264-474f-9175-22ddc92c4061"
    }
  ]
}