Skip to main content
Oppi Games API

​
Welcome to Oppi Games API

Oppi Games provides a powerful API that allows developers to seamlessly integrate gaming functionality into their applications. Our comprehensive documentation guides you through the entire process, from API key setup to implementation.

​
API Key Setup

To begin using the Oppi Games API, you will need an API key provided by our support team. Please contact our support team, and they will create and share it with you for integration purposes. For security reasons, make sure your API keys are kept confidential and not shared with anyone else.
If your Secret Key is exposed or compromised, immediately contact our support team to have it deactivated and replaced in order to maintain security.

​
Base URL for all API requests

https://s-apis.oppigames.com

​
API Key Restrictions

  • Restrict the usage of your API key to specific IP addresses for enhanced security

​
Understanding API Keys

​
What is Auth Key?

  • The Auth Key is required for all API requests. It acts as a public identifier for your Oppi Games integration.
  • It helps identify and associate the registered operator making the API call.

​
What is Secret Key?

  • The Secret Key is used to generate and verify signature tokens for secure API communication.
  • It acts as a private key and must be kept confidential at all times.
    If your Secret Key is exposed or compromised, immediately inform to deactive it to maintain security.

​
Authentication

​
Generate Signature Token

const signature = crypto
  .createHmac("sha256", secretKey)
  .update(JSON.stringify(data) + '|' + timestamp)
  .digest("hex")

// Payload structure

const data = {
  "playerId": "18865671",
  "playerName": "XYZ_player",
  "balance": 50000000000,
  "gameId": "G1737434469573",
  "currency": "USD",
};
  • Algorithm will be : HMAC SHA256
  • You need to create a signature string using crypto HMAC SHA256 with your project’s secret key.
  • Timestamp should be in UTC format.
If the API request does not include a body, pass an empty string "" as the data when generating the x-signature token.
Datetime should be in GMT format. For signing the JWT, you must use the Secret Key.

​
Status Codes

Status Codes - These are the status codes we have sent. Please make sure to send the same status codes without any mismatch.
KeyDescription
RS_OKSuccess response
RS_ERRORGeneral error status, for cases without a special error code.
RS_ERROR_MISSING_HEADERSMissing headers
RS_ERROR_DUPLICATE_TRANSACTIONThe transaction already exists (duplicate transaction).
RS_ERROR_TRANSACTION_DOES_NOT_EXISTReturned when the bet referenced in win request can’t be found on Operator’s side (bet wasn’t processed or was rolled back).
RS_ERROR_SESSION_REQUIRED_OR_INVALIDMissing or invalid session
RS_ERROR_NOT_ENOUGH_MONEYInsufficient balance, can not place bet
RS_ERROR_LIMIT_REACHEDThe bet request limit is reached for the player
RS_ERROR_IP_RESTRICTIONIP & Domain restricted
RS_ERROR_SIGNATURE_EXPIREDSignature has been expired
RS_ERROR_SIGNATURE_NOT_MATCHSignature does not match
RS_ERROR_INVALID_APIKEYAPI key is invalid
RS_ERROR_INVALID_AMOUNTInvalid amount.
RS_ERROR_INVALID_NUMBERInvalid number.
RS_ERROR_MERCHANT_NOT_ACTIVEMerchant currently not active
RS_ERROR_GAME_INACTIVEGame inactive
RS_ERROR_PLAYER_BLOCKEDA player blocked and can’t play or place any new bets.
RS_ERROR_INCORRECT_DATARequest data type wrong or invalid.
RS_ERROR_FIELD_REQUIRED_OR_INVALIDfield is invalid or missing. Here field content value of it, for example, session Id is invalid or missing.
RS_ERROR_RECORD_NOT_FOUNDRecord does not exist

​
Contact Us

We’re here to help! Feel free to reach out us on [email protected] for the appropriate team of your needs:
  • For questions about sudden drops in API or WebSocket performance.
  • For general inquiries about the API not covered in the documentation.

​
Oppi Games Developers

​
Oppi Games Customer Support

Ready to start? Begin your integration journey today by setting up your API keys and exploring our comprehensive documentation.