Use the Custom Shipping Rate Service to provide shipping rates to Recharge during checkout and recurring orders from your preferred shipping carrier. Dynamically calculate rates directly from your shipping providers or create a custom set-up using a custom callback URL that Recharge calls to get rates.

This guide provides the steps to implement the Custom Shipping Rate Service app on your Recharge store.

Before you start

• You must use the advanced shipping rates (Recharge zones, rates, and integrations) in your Shipping settings in Recharge to implement the Custom Shipping Rate Service.
• This feature requires the use of API and custom code. Recharge cannot implement or support this setup as per the design and integration policy. If you require further assistance, work with a third-party developer.

Review specifications

Middleware that can return and receive payloads that follow the guidelines in Setup Custom Shipping Rate Service is required to use this feature. 

Enable custom shipping rates

Add the integration through your merchant portal and implement your Custom Shipping Rate Service URL.

1. Click Tools & apps in the merchant portal and select App marketplace from the dropdown.
   

2. Select Get under Custom Shipping Rate Service.
   
   

3. Fill in the URL and Header fields.

   1. Custom Shipping Rate Service URL (required) - This is the https URL of your custom shipping rate service endpoint. 

   2. Custom Headers (optional) - Add any headers that your service requires. 
   3. Secret Key (optional) - Enter your secret key, if your service requires this. 
4. Click Save once finished.

Use custom shipping service in a shipping zone

1. Click Settings in the merchant portal and select Shipping. 

2. Under Shipping Setup, select Use Recharge Zones, Rates and Integrations (Advanced), and follow the prompts. Once complete, proceed to the next step.
   

3. Click Manage Zones and add a rate to an existing zone (or create a new zone if necessary).

4. In the add rate modal, select Use a third-party app to calculate rates then choose Custom Shipping Rate Service.

5. Click Save.