question

rknoesel avatar image
rknoesel asked

What are use cases for /prizes/claim and /prizes/fulfill?

In a typical game (e.g. top 10 players are awarded some in game currency), what does it mean to claim a prize vs fulfill a prize? The Game API Workflows documentation mentions claiming, but not fulfilling a prize.

api
10 |5000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

1 Answer

Levon@Amazon avatar image
Levon@Amazon answered

Hi rknoesel,

Claiming a prize essentially means that the game has surfaced information related to the prize to the player, and the player has looked at the prize and possibly accepted it (clicked a link to get the prize for example). Fulfilling the prize indicates that all necessary activities after clicking the link have been completed.

In case of in-game prizes there is neither much difference nor lag between the two steps, so we encourage the developer to call claim followed by fulfil after the digital item has been delivered to the player.

In case of physical prizes shipped by Amazon however, developer calls the claim API after the redemption link has been shown (or navigated to) to the player. When we detect on our end that the customer has done the step necessary on their end (such as logged on to their Amazon account and put in the shipping address where the prize is to be shipped to) to complete the redemption process, then we call the fulfil ourselves as the developer won’t have visibility to our back end.

For this reason we allow developers to call both claim and fulfil for in-game rewards, but only claim for physical rewards (and we call fulfil when all steps for redemption are complete). Hope this helps.

10 |5000

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.