Developer Console
Sign In
Sign In
Developer Console

Tips & Troubleshooting

Pull Integrations

Tips

  • This approach is a pull model rather than a notification-based model. A game needs to periodically poll for entitlement data, and it can do so only when the gaming device is connected to the internet.
  • Consider informing a user actively—in the game, by using a pop-up message or an in-game inbox—about a confirmation of the content claims made or of new items acquired outside the game. Keeping these communications clear is a good way to maintain high customer satisfaction with the process and to limit costly customer service interactions.
  • When processing the actions in the list of goods, send a response for each item as soon as the action is completed; avoid batching all actions into a single response after they have been processed. This approach limits the potential for data loss due to computer or network issues.
  • Consider the user experience flow carefully. How would a customer, particularly a new player, expect this to work? Check for new goods at reasonable points in the game flow, particularly at startup, resume from pause, return to the top-most window in the window Z order, or maximize/restore from a minimized window.
  • If errors occur as you attempt to authenticate a user, follow this process:
    1. Retry: Retrying the operation should be the first action you take upon receiving an error communicated with Amazon.
    2. Refresh: It is possible the user's access token has expired. Try refreshing it.
    3. Relink: If you are still experiencing errors, delete the user's account-linking information on your side, and prompt the user to relink to the Amazon account.

Troubleshooting

  1. A GetEntitlements API call failed with a "Not all permissions are authorized" error.
    Make sure your Login with Amazon integration requested both scopes required to call this API: games::prime and profile.

  2. A "Token invalid" error occurred during an attempt to refresh the access token.
    Make sure you are correctly handling and storing the refresh token that you received from the authorization endpoint.

For help with other issues, reach out to your Prime Gaming contact.