Guide
Testing and Troubleshooting
Troubleshoot Test Connection, serial activation, customer login, validation, offline grace, credential rotation, and common developer mistakes.
SoundSync
Common integration problems
Each entry points to a concrete fix.
| Symptom | Likely cause | How to confirm | Corrective action |
|---|---|---|---|
| Test Connection fails with INVALID_APP_ID | Using Product ID or old ss_prod value as App ID. | Compare appId to generated product credential config. | Use current ss_prod_* App ID. |
| Only bearer auth sent to licensing endpoint | Plugin key sent without App ID and plugin secret. | Inspect request headers. | Send x-ss-app-id, x-ss-plugin-key, x-ss-plugin-secret. |
| Activation never unlocks after email verification | Client omitted final /activate after verified claim-status. | Look for missing claim_activation_token request. | Call /activate with claim_activation_token. |
| Validation locks while offline | No valid cache or grace expired. | Inspect cache schema and graceExpiresAt. | Require online activation/validation. |
| Customer-login fails repeatedly | Password wrong or customer lacks entitlement. | Check response code and entitlement status. | Keep password out of cache and show account/support path. |
| Credential rotation broke package | Generated config still has old key/secret. | Run Test Connection against package values. | Regenerate package or update config. |
| Audio glitches during licensing | Network request made on audio thread. | Inspect call stack/thread use. | Move HTTP to worker/message-safe async layer. |
SoundSync
Troubleshooting pages
Use focused pages for detailed recovery steps.
Connection Verification Failures
Missing, wrong, revoked, inactive, or product-mismatched credentials.
Activation Failures
Serial not found, product mismatch, identity required, activation limits, subscription states.
Claim and Email Verification
Claims waiting on verification, expired tokens, email delivery, final activation omitted.
Validation and Offline Grace
Corrupt cache, missing token, deactivated device, network unavailable, grace expired.
Credential Rotation and Revocation
Rotated/revoked credentials and old package configuration.