Why Does the Cargo Courier Not Appear in the API Response or Checkout Page?

The Cargo courier is a delivery service for large or heavy items, typically over 10 kg. If the cargo courier option does not appear on the Website checkout page, it could be due to various factors, including minimum weight limits, shipping zone settings, API integration, or restrictions from the courier itself. This article will explain the main causes and solutions to address them.

1. Order Weight Does Not Meet the Minimum for Cargo Shipping

Cause:

Cargo couriers usually have a minimum weight limit, so if the order is too light, the cargo service will not appear at Shopify checkout.

Solution:

• Make sure the total order weight meets the minimum limit for the available cargo service.
• If the items are lighter, use regular shipping services or add a weight adjustment option in the checkout system.

2. Cargo Courier Option Not Enabled on Website or Biteship

Cause:

If the cargo courier service is not enabled in Shopify settings or Biteship API, this option will not appear at checkout.

Solution:

• For Biteship API:
  • Log in to Biteship Dashboard → Shipping → Courier Settings.
  • Ensure the Cargo service is enabled.
• For Shopify:
  • Log in to Shopify Admin → Settings → Shipping and Delivery.
  • Make sure Cargo Courier is included among the available shipping methods.
• If using app-based rates, ensure the cargo courier rates have been added to the appropriate shipping zones.

3. Shipping Location Not Supported by Cargo Courier

Cause:

Cargo services are usually only available for shipments between certain cities or provinces. If the destination address is outside the coverage area, the shipping option will not appear.

Solution:

• Use Biteship API Check Coverage to verify if the address can be reached by the cargo courier.
• If the customer is outside the cargo service area, use alternative shipping options, such as regular expeditions or third-party trucking.

4. Package Dimensions Exceed Maximum Capacity of Cargo Courier

Cause:

Some cargo services have maximum dimension limits for shipments. If the package exceeds these limits, the service will not be available at checkout.

Solution:

• Make sure product dimensions are correctly accounted for in Shopify Admin → Products.
• For complete service terms, see here.
• If the item dimensions are too large, contact the relevant courier to find alternative solutions, such as trucking delivery.

5. Biteship API Rate Limit Exceeded

Cause:

If there are too many API requests in a short time, Shopify or Biteship may limit the API response, causing the cargo courier option not to appear.

Solution:

• Use caching or webhooks to avoid excessive API polling.
• Wait a moment and try again.
• Make sure you do not exceed the Biteship API rate limit (e.g., 1000 requests per minute in production).

6. API Response Error or Synchronization Failure

Cause:

If there is a disruption in communication between Shopify and the Biteship API, the cargo courier service may not appear.

Solution:

• Check the API response logs in the Biteship Dashboard or use Postman to manually test the API response.
• If you receive a 500 (Internal Server Error) or 429 (Too Many Requests) error, try again after some time.
• Contact support@biteship.com if the problem persists.

Conclusion

If the cargo courier service does not appear on the Shopify checkout page, check the following factors:

✅ Check if the item weight meets the cargo courier minimum limit
✅ Ensure the cargo courier service is enabled in the API and Shopify
✅ Verify if the shipping address is within the cargo service coverage
✅ Make sure the package dimensions do not exceed cargo courier limits
✅ Ensure the shipping distance does not exceed the maximum limit
✅ Make sure the API does not exceed the rate limit
✅ Check shipping zones in Shopify

If you continue to experience issues, please contact support@biteship.com for further assistance.