UPCS Logo
    My Account

    Troubleshooting — Help Center

    Fixes for common errors and problems.

    Troubleshooting

    Fix UPCS Error 401 session_expiredThe 401 session_expired error means the short-lived embed session token has run out. Create a fresh session and reload the map to fix it.Fix UPCS Error 401 Invalid or Inactive API Key (key_inactive)A 401 Invalid or inactive API key error (or key_inactive on a running map) means your UPCS API key is disabled or expired. Find out how to check the key in the partner panel and restore or replace it.Fix UPCS Error 403 partner_requiredThe 403 partner_required error means the API key is not linked to a partner account. See how to set up a partner account and use its keys.Fix UPCS Error 403 origin_not_allowedThe 403 origin_not_allowed error means your website address is not registered in your partner account. Add the exact https origin under Allowed origins.Fix a Missing or Invalid UPCS x-api-keyA 401 response about the API key means the x-api-key header is missing or the key is wrong. Check the header name, the value and your server code.Fix UPCS Error: IP Address Not Allowed for KeyA 403 saying the IP address is not allowed means your server's IP does not match the key's restriction. Learn how to find the IP and correct the key.Fix UPCS Error 422 unsupported_locationThe 422 unsupported_location error means the chosen point is outside the 25 countries UPCS supports. Check the country and the coordinates.Fix UPCS 422 Validation ErrorsA 422 validation error means a value such as origin, lat or lng is invalid. See how to correct each field and resend the request.Fix UPCS Error 429 rate_limitedThe 429 rate_limited error means your API key has used its hourly request allowance. Learn how to reduce calls and recover quickly.UPCS Lookup Returns 404 for a CodeA 404 from the UPCS lookup means the code was not found. Check the code for typos, the format and the endpoint, then try the lookup again.UPCS Embedded Map Not ShowingIf the UPCS embedded map is blank or missing, work through the session token, allowed origin, script and container checks in this order.WordPress UPCS Test API Connection FailsIf Test API Connection fails in the UPCS WordPress plugin, check the API key, key status, allowed origin and your server's outgoing connection.WooCommerce Checkout Map Not ShowingIf the UPCS map is missing at WooCommerce checkout, verify the plugin, API key, WooCommerce status and caching, or use the [upcs_map] shortcode.PrestaShop UPCS Map Not Visible or Not LinkedFix a hidden UPCS map in PrestaShop or a location missing from orders by checking the API key, display position and Link location to order.OpenCart UPCS Module Won't Install or ShowIf the UPCS OpenCart extension will not install or the map does not appear, check the version, installer, module status and Checkout layout.UPCS Code Points to the Wrong PlaceWhen a UPCS code or map shows a different place than you expected, check for typos, swapped coordinates and the size of the 3 m grid cell.