Skip to content

Latest commit

 

History

History
78 lines (47 loc) · 3.07 KB

README.md

File metadata and controls

78 lines (47 loc) · 3.07 KB

@particular./sync-moltin-to-shippo

npm version semantic-release code style: prettier CircleCI dependency status: david

Create Shippo shipment and send label when an order is paid/captured in Moltin

Asynchronous microservice that is triggered by moltin webhooks to create a Shippo shipment.

Built with Micro! 🤩

🛠 Setup

Both a moltin and Shippo account are needed for this to function.

Create a .env at the project root with the following credentials:

MOLTIN_CLIENT_ID=
MOLTIN_CLIENT_SECRET=
MOLTIN_WEBHOOK_SECRET=
AMAZON_ACCESS_KEY_ID=
AMAZON_SECRET_ACCESS_KEY=
AMAZON_REGION=
EMAIL_FROM=
SHIPPO_PRIVATE_KEY=

Find your MOLTIN_CLIENT_ID and MOLTIN_CLIENT_SECRET inside of your moltin Dashboard's API keys.

MOLTIN_WEBHOOK_SECRET can be anything you want.

📦 Package

Run the following command to build the app

yarn install

Start the development server

yarn dev

The server will typically start on PORT 3000, if not, make a note for the next step.

Start ngrok (change ngrok port below from 3000 if yarn dev deployed locally on different port above)

ngrok http 3000

Make a note of the https ngrok URL provided.

⛽️ Usage

Next head over to the moltin Webhook Settings area, add a new integration (Settings > Integrations and click Create).

Enter any name and description for your Integration. Moltin recommends you prefix the name with DEVELOPMENT: for any testing.

Next, enter the ngrok URL from above and MOLTIN_WEBHOOK_SECRET that you saved inside .env.

URL and Secret Key

Now finally you'll want to configure what Moltin Observables will cause this webhook to be invoked. In this example we want to monitor the Order observable and select the Paid/Captured box.

Observes selection

Click Save to register your new Webhook with Moltin.

🚀 Deploy

You can easily deploy this function to now.

Contact Adam Grohs @ Particular. for any questions.