User Verify Request Example & Responses

User Verify Request

Example Format: JSON-RPC

// {
    "id": "6164695159717629913",
    "jsonrpc": "2.0",
    "method": "verify",
    "params": [
        {
            "isForTest": 1,
            "serviceProvider": "Coda",
            "purchaseOrigin": "TH",
            "user": {
                "userId": "111111",
                "zoneId": "101"
            },
            "signature": "4646fbd3363ab452f40187f8744cd321f71968ed01cdc19c416203832cddd76e"
        }
    ]
}

Parameter	Type	Description
id	String	A unique ID identifying the API call.
jsonrpc	String	Fixed to “2.0” by json-rpc standard.
method	String	Fixed to “verify”
params.serviceProvider	String	Payment service provider name, default value is “Coda”, but partner can decide the value.
params.isForTest	Integer	A flag to indicate whether this order is for sandbox test or real order. If isForTest=1, this order is a sandbox test order; otherwise if isForTest=0, this order is a real order.
params.signature	String	Generated based on the content of the message. See section on Signature Generation.
params.user.userId	String	The user ID/player ID of the customer account in the partner's system.
params.user.zoneId	String	The zone ID/server ID of the customer account in the partner's system. If zoneId is not required, the default value is “”.
params.purchaseOrigin	String	Note: purchaseOrigin is a 2 country code ISO standard. This will be the region where the user of codashop did the purchase from. https://www.iban.com/country-codes

User Verify Request Responses

User Verify Response describes the response to a verify request by the partner. See below for examples of Valid and Invalid User Verify responses.

Valid User Verify Response

Example 1: Validate/Verify the user profile Format: JSON-RPC

// 
{
  "id": "6164695159717629913",
  "jsonrpc": "2.0",
  "result": {
    "username": "Randy",
    "originCountry": "ID",
  }
}

Example 2:

If the Publisher wants to send metadata to showcase personalized SKU list based on the in-game user information

//
{
  "id": "6164695159717629913",
  "jsonrpc": "2.0",
  "result": {
    "username": "Randy",
    "metadata": {
      "originCountry": "ID",
      "inGameLevel": "Gold Level"
      "roleInfo": "Warrior"
      
    },"personalisedSkus": [
      {
        "skuId": "100_diamonds_coda",
        "description": "100 Diamonds",
        "details": {
          "category": "vip-cash",
          "price": 1.25,
          "currency": "USD",
          "imageUrl": "https: //cdn1.partner.com/S/content/common/images/denom-image/BGMI/100x100/60_bgmi_uc.png"
        }
      },
      {
        "skuId": "1000_diamonds_coda",
        "description": "100 Diamonds",
        "details": {
          "category": "growth",
          "price": 150000,
          "currency": "IDR",
          "imageUrl": "https: //cdn1.partner.com/S/content/common/images/denom-image/BGMI/100x100/60_bgmi_uc.png"
        }
      }
    ]
  }
}

Parameter	Description
id	The id of the message this response is associated with.
jsonrpc	Fixed to “2.0” by json-rpc standard.
result	An Object representing success.
result.username	Player username, nickname, or other identifier that can be used to let the customer confirm they are topping up the intended account. For example, a unique player id may be “123456789”, and their username (not necessarily unique) may be “Terminator123”.
result.metadata	Publisher can use this field to add details such as user’s country of origin, in-game level, list of character or roleInfo of that user etc. (Optional)
result.personalisedSkus	The list of SKUs available to the user. (Optional)
result.personalisedSkus.skuId	SkuId (Optional)
result.personalisedSkus.description	Name of the SkuId (Optional)
result.personalisedSkus.details	The Object that holds sku’s details (Optional)
result.personalisedSkus.details.category	Category or the Sub-type of the SKU (Optional)
result.personalisedSkus.details.price	Price that needs to be send in API to the publishers (Optional)
result.personalisedSkus.details.currency	Currency that needs to be sent in API to the publishers during top-up (Optional)
result.personalisedSkus.metadata.imageUrl	Image source for a specific SKU in Partner’s CDN (optional)

Invalid User Verify Response

Format: JSON-RPC

// 
{
    "id": "6164695159717629913",
    "jsonrpc": "2.0",
    "error": {
        "code": -100,
        "message": "Invalid user ID"
    }
}

Parameter	Description
id	The ID of the message this response is associated with.
jsonrpc	Fixed to “2.0” by json-rpc standard.
error.code	A code representing the error.
error.message	A message explaining the error.

For any queries related to integration, reach out to the Partnership Support Team.