magentoMagento 2

The Magento 2 Webhook Extension for parcelLab enables fast and simple integration.

circle-check

Installation and Setup Guide

triangle-exclamation

To install the Magento 2 Webhook extension:

  1. Run the following command in Magento 2 root folder:

composer require parcellab/magento-2-webhook
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
  1. After successful installation and deploy log in to your Admin Backend of Magento, navigate to System > parcelLab Webhook > Configuration.

    In this screen, you will have to enter your parcelLab API credentials.

  2. Generate a new parcelLab API Token with write access in the parcelLab Portal.

  3. Enter the newly generated parcelLab API Token together with your parcelLab User ID.

    When entering your credentials:

    • Use your parcelLab User ID, not an email address.

    • Use the plain API token value from parcelLab. Do not use an encoded or encrypted token.

    • In the same screen, set Enabled to Yes. This setting is separate from the event configuration and must also be enabled.

    • Save the configuration and flush the Magento cache before testing.

circle-exclamation
  1. Navigate to System > parcelLab Webhook > Manage Events.

    You will find the two required events already pre-configured.

  2. If you have entered your parcelLab credentials earlier and set the plugin configuration to Enabled = Yes, activate the events.

  3. After saving any configuration or event changes, flush the Magento cache and place a new test order to confirm the webhook is sent successfully.

🎉 Your integration is complete! 🎉

FAQs

chevron-rightCan I add more events?hashtag

Due to the tailored use of this extension, the number of events is limited. For more flexible webhooks please use the fork source Magento 2 Webhook by Mageplazaarrow-up-right.

chevron-rightI received the error Mageplaza_Core has been already definedhashtag

You can resolve it by following the solution herearrow-up-right.

chevron-rightMy site is down, what should I do?hashtag

You can resolve it by following this guidearrow-up-right.

chevron-rightWhere do I find transfer logs?hashtag

Navigate to System > parcelLab Webhook > Transfer Logs.

image

The transfer logs will display a list of recent transfers and you can view the details for each entry by selecting View in the Action column.

image

When requesting support, please share both the Response as well as the Request Body.

image
chevron-rightThe events are enabled, but parcelLab is not receiving the webhook or the request body is blankhashtag

Check the following in Magento:

  • In System > parcelLab Webhook > Configuration, set Enabled to Yes.

  • Enter your parcelLab User ID and make sure it is not replaced with an email address.

  • Use the plain API token value from parcelLab, not an encoded or encrypted token.

  • Flush the Magento cache after saving configuration changes.

If Enabled is set to No, the events can still appear active in Manage Events, but the webhook payload will not be sent to parcelLab.

chevron-rightI am unsure whether I have Magento 2 Webhook by Mageplaza installed, how can I check?hashtag

Run php bin/magento module:status and check whether Mageplaza_Webhook is listed.

If it is listed, please do not install this extension and follow our Setup Guide with Mageplaza Webhookarrow-up-right instead.

chevron-rightIf I already have Magento 2 Webhook by Mageplaza installed, how can I integrate with parcelLab?hashtag

The easiest way is to follow our Setup Guide with Mageplaza Webhookarrow-up-right for this extension, which will take you less than 15 minutes to complete.

Credit

circle-info

This extension is a fork of the Magento 2 Webhook by Mageplazaarrow-up-right published under MIT license on Githubarrow-up-right (see fork source). This fork simplifies your setup for integration with parcelLab by providing appropriate defaults.

It also uses the following packages:

Last updated

Was this helpful?