MERCHANT GUIDE · TROUBLESHOOTING

Common errors & fixes

Most CodeOn plugin issues fall into one of five buckets: license, provider credentials, callback/webhook delivery, background jobs, or data mapping. Use the exact message first; it usually points to the right layer.

License and update errors

Message	Meaning	Fix
`License key format invalid`	The key does not match the checksum format.	Copy the key again from the original email or Licenses page. Avoid spaces and hidden characters.
`Unknown license key`	CodeOn has no license with that key.	Check that you are using the key for this plugin and not an order number or invoice number.
`already bound`	The key is attached to another domain.	Release the old domain from the plugin or from codeon.ge, then re-check the key.
`plugin_not_in_license`	The key is valid but belongs to a different CodeOn plugin.	Use the matching plugin key or buy the missing plugin license.
`license_inactive`	The license is expired or revoked.	Renew it from codeon.ge or contact support if it was revoked by mistake.

Payments

Credentials rejected: check Sandbox vs Production mode first. Sandbox credentials almost always fail against the production endpoint, and production credentials fail against sandbox.
Order remains Pending after payment: verify the callback/webhook URL in the bank dashboard, then check WooCommerce → Status → Logs for the plugin log.
Refund declined: confirm the original payment is settled and the gateway supports the refund type. Installment products often support cancellation rather than partial refunds.
Customer returned from bank but order did not update: use the plugin's manual refresh/reconcile button if available. Return redirects are for customer experience; callbacks are the source of truth.

Sync and delivery plugins

Imports stop halfway: check Action Scheduler for failed jobs, then retry the failed batch after fixing the API or mapping error.
Products duplicated: confirm SKUs are stable and unique before the first import. The sync can only adopt products it can match.
Stock looks wrong: check the selected warehouse mode. Aggregate stock and single-warehouse stock can produce very different storefront numbers.
QuickShipper rates missing: verify pickup address, API credentials, and provider visibility. If live rates are unavailable, enable a flat fallback rate so checkout continues.

License and update errors

Message	Meaning	Fix
`License key format invalid`	The key does not match the checksum format.	Copy the key again from the original email or Licenses page. Avoid spaces and hidden characters.
`Unknown license key`	CodeOn has no license with that key.	Check that you are using the key for this plugin and not an order number or invoice number.
`already bound`	The key is attached to another domain.	Release the old domain from the plugin or from codeon.ge, then re-check the key.
`plugin_not_in_license`	The key is valid but belongs to a different CodeOn plugin.	Use the matching plugin key or buy the missing plugin license.
`license_inactive`	The license is expired or revoked.	Renew it from codeon.ge or contact support if it was revoked by mistake.

Payments

Credentials rejected: check Sandbox vs Production mode first. Sandbox credentials almost always fail against the production endpoint, and production credentials fail against sandbox.
Order remains Pending after payment: verify the callback/webhook URL in the bank dashboard, then check WooCommerce → Status → Logs for the plugin log.
Refund declined: confirm the original payment is settled and the gateway supports the refund type. Installment products often support cancellation rather than partial refunds.
Customer returned from bank but order did not update: use the plugin's manual refresh/reconcile button if available. Return redirects are for customer experience; callbacks are the source of truth.

Sync and delivery plugins

Imports stop halfway: check Action Scheduler for failed jobs, then retry the failed batch after fixing the API or mapping error.
Products duplicated: confirm SKUs are stable and unique before the first import. The sync can only adopt products it can match.
Stock looks wrong: check the selected warehouse mode. Aggregate stock and single-warehouse stock can produce very different storefront numbers.
QuickShipper rates missing: verify pickup address, API credentials, and provider visibility. If live rates are unavailable, enable a flat fallback rate so checkout continues.