If you are a web developer and are looking for more information about orders or other items on your website, you may want to consider creating webhooks for use with the API that has been created by Art Storefronts. If you are unsure of what webhooks are or what an API is used for, we strongly recommend you do not attempt to use this article. Instead, we suggest you reach out to a qualified web developer who can create and implementing webhooks for use with the API.
If you want to learn how to receive order callbacks via the ASF API, please follow the directions below.
- Log in to your Art Storefronts Control Panel and in the Jump To Menu, click on the option labeled Integrations. This will take us to the section where we can the necessary webhooks.
- You’ll be taken to a new page with two options. You will need to find the option labeled Webhooks and click on that tab. This is going to allow us to get to the page where we can implement the webhooks created by our respective developers.
- Once you’re on the new tab, there’s a box that says Webhook URL. This is the box where you will need to enter the webhook that was created by your developers.
Please Note: Art Storefronts will not assist you in creating this webhook. We are only here to provide you with the API. Anything further than showing you where to enter in the webhook falls outside of the scope of support offered by our Technical Support department. If you have issues we will IMMEDIATELY refer you back to your web developer.
- After you’ve entered the Webhook into the box you need to be sure that you click on the button labeled Save. DO NOT CLICK THE BACK BUTTON. If you click anything other than Save, all your work will be lost.
- After you click Save, the webhook will be added to the page. You’ll see an item labeled Show Failed. This section will show you anything that was returned as failed. This information will be something for you to provide to your web developers.
Please Note: ASF will not help you decipher these items. This falls outside of the scope of support.
- Edit is the next button you will see. You can click on this if you need to make changes to your Webhook.
- Delete is the final button on the page. If you need to delete a specific webhook, this is what you will want to click on.
- From here, you will want to check and make sure that your webhooks are functioning on order. In the Jump To Menu, select the option labeled Orders.
- You’ll be taken to the Orders page where you will need to click on the order number of the Order you want to look at. We’ll be using the order 1002.
- You’re going to be taken to the Order page proper. You need to scroll down to the section labeled API Events. This is where information about the callback is going to be listed. The first item is Sent At. This will tell you when the callback was sent.
- The second item is Result. This is going to show a number. Generally, these numbers are errors that will enlighten you as to whether or not the webhook failed. You’ll need to discuss these with your web developer.
- Success is the next section. This will simply tell you whether or not the callback worked properly. It will say either True or False.
- Callback URL will show you the webhook you created and implemented.
- The last section is labeled Payload and there is a button labeled View. You will need to click on this button if you wish to review the Payload.
- The Payload will pop up in a new window and provide everything that you need. If there is something missing, please e-mail firstname.lastname@example.org and they can put in a request to have items added if they are necessary and makes sense.