How to Set Up Shipping & Tax Endpoints
Use the Merchant API to handle shipping and tax information for your orders. This is required for multi-step checkout.
How to Use the Shipping & Tax APIs
Reach out to your CSM to have split shipping and tax enabled for your merchant account.
Shipping API
- Implement the Shipping API endpoint on your server.
- Respond to Bolt’s
order.shipping
POST request from your Merchant API.
- Verify the authenticity of the request by confirming that it originated from Bolt.
Tax API
The Tax API endpoint is called after a shopper has chosen a shipping option.
- Implement the Tax API endpoint on your server.
- Respond to Bolt’s
order.tax
POST request from your Merchant API.
- Verify the authenticity of the request by confirming that it originated from Bolt.
Shipping & Tax API
The combined Shipping & Tax endpoint will eventually be deprecated. Bolt recommends using the new, decoupled endpoints for Shipping and Tax.
- Implement the shipping_and_tax Merchant API on your server.
- Respond to Bolt’s
order.shipping_and_tax
POST request from your Merchant API.
- Verify the authenticity of the request by confirming that it originated from Bolt.
Test the Endpoint
Use the following steps to test your Shipping and Tax API implementation:
- Navigate to your store.
- Open Bolt Checkout, enter an address, then continue to Shipping.
- Bolt should hit your
/shipping_and_tax
endpoint.
- The shipping and tax options from your response should appear in the Bolt Checkout modal.
- Try all shipping options.
- Ensure that the price of shipping and tax on the cart updates accurately.
Errors & Troubleshooting
To respond with specific errors in merchant api responses visit error codes documentation.