Redeeming VPP/Gift Codes
Description
Redeemable codes provide a way to assign app licenses to Apple IDs when managed Apps and Books/VPP assignment is not available for the app or workflow you need.
This article explains how to review imported VPP or gift-code batches, see which codes are still available, and troubleshoot cases where a code appears to be redeemed but may still be reusable.
Information
After the codes have been added in FileWave Admin from Assistants > Manage VPP Codes, the VPP Codes assistant shows:
- The file the codes were imported from and the app name.
- Each license code in the imported batch.
- How many codes are still available for redemption.
- The date the codes were added to the FileWave Server.
Automatic Assignment
Any available licenses shown here may be redeemed automatically by the user of the device with the following process:
- Associate the Fileset.
- Update Model.
- When the device checks in, the user is prompted to accept the installation with their Apple ID.
- If the user accepts the installation, the code is no longer available for use and the app belongs to that Apple ID.
- The used code disappears from the available VPP Codes list for the uploaded file.
- The code then appears in the redeemed list, including the device used when the code was redeemed.
Apple does not provide visibility into which user accepted the license.
Have codes been used?
In rare cases, a device may show a code as Redeemed Automatically even though the code was not actually redeemed and could be reassigned. If you suspect this, re-import the codes from a CSV. For efficiency, only re-import suspected unused codes when possible.
For VPP codes, downloading the file again from Apple provides a new file with only the unredeemed codes. Gift codes cannot be downloaded again this way.
One clue is a device appearing more than once with different codes. You can try re-adding the first code that was redeemed by that device, based on date, from a new CSV import. If the re-imported code has already been redeemed, the next redemption attempt for that code fails, the code is removed from the list, and FileWave attempts to use the next code in the list.
This can happen when several users use the same device, or when the code was automatically associated but redemption by the user was not completed.
Manual Assignment
You may also choose to let the user manually install the application. In this case:
- Highlight the relevant code or codes.
- Choose Redeem.
- The code now appears in the redeemed window. This does not automatically prompt the user.
- Send the code to the user so they can redeem it themselves.
Codes that were marked for manual redemption but have not actually been redeemed may be pulled back into the pool of unredeemed licenses so they can be automatically associated instead.
Warning
If a code was provided to a previous user, for example by email, and that user did not redeem it, using Unredeem returns the code to FileWave but does not invalidate the copy the original user already has. The first Apple ID to redeem the code owns that app, and the code can no longer be used.