This article guides users through the process of renewing the VPP token in Citrix Endpoint Management and XenMobile. The workflow remains consistent for both on-premises and cloud platforms.

Instructions

1. Log in to Apple Business Manager (ABM).

2. Navigate to “Preferences” > “Payments and Billing” > “Apps and Books” > “Server Tokens.”

3. Download the renewed VPP token.

4. Open the downloaded file in a text editor (e.g., Notepad)

*The VPP token text file should not contain any headers. If 'Content' headers are present, the wrong token was generated.  Go back to step 2 and ensure the "VPP" token is downloaded.

5. Log in to your Citrix Endpoint Management or XenMobile console.

6. Go to “Settings” > “Volume Purchase.”

7. Edit the VPP Token entry.

8. Paste the token content into the “Company Token” field.

*Ensure no extra characters or spaces otherwise, you will receive a warning.

9. Re-enter username and password.

10. Click 'Save" for the token window.

11. Click the second "Save" below the configuration page.

Known error:

"Error: The entered company token is not valid, please enter a new one."

If you encounter this error message, follow these steps to troubleshoot:

1. Review VPP Token Content:

   • Double-check the VPP token content you pasted in the “Company Token” field.
   • Ensure there are no extra spaces, special characters, or typos.
   • The token should match exactly what you obtained from Apple Business Manager.
   • The VPP token text file should not contain any headers. If 'Content' headers are present, the wrong token was generated. 

2. Retry Entering the Token:

   • If there is an issue, delete the existing content in the “Company Token” field.
   • Paste the VPP token again, ensuring the points above.

3. Save Changes Again:

   • Click the second “Save” button once more to save the corrected token.

4. Test the Token:

   • Enroll a test device or push an app to verify that the renewed VPP token is now valid.
   • Monitor any installations or updates to confirm successful communication with the VPP service.