Using the Custom Shipping Rate Service

The Custom Shipping Rate Service enables you to provide shipping rates to Recharge during checkout and recurring orders. You can dynamically calculate rates directly from your shipping providers or from your own custom set-up by providing a custom callback URL that Recharge will call 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 be using the advanced shipping rates (Recharge zones, rates, and integrations) in your Shipping settings in Recharge.
• This feature requires the use of API and custom code. Implementation cannot be performed or supported by Recharge as per the design and integration policy. If you require assistance from a developer, please visit the Recharge Agency Partner Directory.

Review specifications

To use the Custom Shipping Rate Service with Recharge, you will need middleware that can return and receive payloads that follow the guidelines in Setup custom shipping rate service. 

Enable custom shipping rates

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

1. Click Apps in the merchant portal and select Marketplace from the drop-down.
   

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.