How to set up carrier service in a node.js app

1 0 0

Hi there,


We are a team of developers building an embedded Shopify app that will use the Carrier Service.


We are new to Shopify app development but followed this Shopify node guide and successfully deployed our app in a docker container to Google cloud platform. From there we were able to install it into a test development store.


We have read over the documentation for the Carrier Service API and understand the first step is to create a carrier service.


The documentation is a little bit vague on where to use the node.js code and we aren't sure where to start. Some questions:


- do we create a carrier_services.json file? If so, what directory do we store the file?

- are there any examples we can reference for an embedded node app that contains code for implementing a carrier service?


Thank you for your help!

Replies 2 (2)
Shopify Partner
2 0 1

We used the approach to make an authenticated fetch call from the React app frontend to NodeJS backend when the app starts to get the session id. From there we used the methods provided by Shopify to retreive the session from the id and register the service through the shopify api rest CarrierService.


As we also saw only one carrier service is allowed so we have a simple check, if present with the same name we dont register it again.


React code at component: (this fetch is the authenticatedFetch provided by shopify)

export const registerPriceListService = (fetch) => {
return fetch("/api/carrierService/register", {
method: "GET",
headers: { "Content-Type": "application/json" },
}).then((response) => response.json());
and inside useEffect with [] await the above.

Backend side:
app.get("/api/carrierService/register", async (req, res) => {
try {
const sessionId = await shopify.api.session.getCurrentId({
isOnline: false,
rawRequest: req,
rawResponse: res,
const sessionStorage = new SessionStorage(); // Remember here is your implementation of storage
const session = await sessionStorage.loadSession(sessionId);

if (!session) {
throw new Error("No session present");

const serviceName = "Calculating Prices Provider";
const serviceCallbackUrl = `https://${session?.shop}/api/retrieve-prices`;

const response = await axios.get(
{ headers: { "X-Shopify-Access-Token": `${session.accessToken}` } }

const foundService = response?.data?.carrier_services?.find(
(service) => service?.name === serviceName

// This check here is because error is produced if already an entity exists. Remove this to update fields.
if (!foundService) {
// This assignment of 'id' triggers the update. Use this to change the name or callback_url
// =;
const carrierService = new{ session }); = serviceName;
carrierService.callback_url = serviceCallbackUrl;
carrierService.service_discovery = true;
update: true,
res.status(201).send({ success: true });
} catch (error) {
res.status(204).send({ success: true });
I think thats all on registering the service it self.
Shopify Partner
8 0 2

Shopify system hits my callback url but does not send customer shipping data (zipcode, item weight etc). What I might be missing in my app?


Below is the call back url I registered: