...
| id | Info |
|---|
...
Department
...
IT
...
Purpose
...
Configure the System Events Available
...
Estimated Time
...
5 min
...
In the system is possible to notify certain events to a channel. If you don’t have added any notification channels, please check out this document How to create a notification channel
...
In the menu, go to Integrations.
Click on Configuration in the System Notifications card.
You will see a list of 8 10 notification events.
Order completed: It gets triggered when a successful order is closed. In admin, quote or shop sells it happens in a successful purchase. In funnels, it happens when a user reaches the thank you page or after 30 minutes after the first purchase in a funnel page (this is to avoid the scenario when a customer purchases but never goes to the thank you page).
Contact created: Is called when in these situations:
When a lead is created through the admin, shop, or funnel page.
When a reactivation (we receive again the information for a contact already created
) for a lead/customer occurs in the
shop or a funnel page.
Shipping tracking info updated: It happens when we updated the update an order's tracking information of an order.
Product conflicts: Called when a product conflict occurs (a customer who purchased a digital product that he already has).
Transaction declined: When a purchase transaction gets rejected in the system. Because this is at the transaction level (in funnels, an order can have many transactions if upsells are involved), this event could be triggered many times inside a funnel purchase. For example, the cart page sale was approved, but all the next upsells were declined due to insufficient funds.
Refund applied: When a refund/void occurs.
Subscription canceled: When a subscription gets canceled.
Customer created: When a lead makes his first successful purchase in the system. Right now, it only works with postback channels.
Approved transaction: When a purchase transaction succeeds in the system. Because this is at the transaction level (in funnels, an order can have many transactions if upsells are involved), this event could be triggered many times inside a funnel purchase. For example, the cart page sale was approved, and all of the next upsells were also purchased.
Survey completed: When a survey is finished. Right now, it only works with postback channels.
If the event you want to use is disabled, enable it by toggling the switch on its right. On the contrary, if currently enabled, click over the event name.
You will see a list of the current channels added to this event (the list will be empty if no channels were attached previously).
Click on the bottom right button to attach a channel.
You will see a form with these fields:
Channel: You can select one of your channels created before. If don't you have anynone, click on the Add button on the right, if . If you need to add a new channel, please read this document first How to create a notification channel
Sources: We have 3 sources: Admin, Shop, and Funnel. Every contact, order, and subscription is related to one of these 3. You can specify if you want to notify only if the event happened on some specific sources.
Click on save and you will to see that the channel was successfully linked to the event.
If you click on the 3 vertical dots on the right, you will see two options available:
Edit: Here, you are able to can update the sources.
Delete: You can remove the channel to being notified of this event.
Postback notes
Retry
We automatically retry automatically a postback request a maximum of 3 times if we get any of these HTTP codes:
...
If a request failed the 3 times, you can could make a manual retry only for these events through the Orders UI in the admin:
Order completed.
Approved transaction.
Transaction declined.
Refund applied.
Keep in mind that we We have a timeout of 30 seconds when dealing with these requests, so if your endpoint takes more than that time to respond, we will mark the operation as failed, and we will not retry it automatically, if it won’t be retried automatically. If you need the data again, you would need to make a manual retry (that will still have the limitation of 30 seconds).
In order to To avoid problems with the timeout, we recommend you not perform heavy operations in your endpoint, get only the data, and dispatch a background job to execute your needed processes.
Payloads
Here we will show you some examples of payloads that you can receive when notifying postback channels.
| Info |
|---|
This is only a reference, in some values that are objects you could receive null. For example, admin orders don’t have a funnel, you would receive a null value on the funnel key. If you need to access an object property in your end validate that such prop is not null first. |
Best Result
Your channel will be added/updated/removed successfully.
Worst Result
The application will throw an Error and you will need to check if the data is not corrupted.
...
. |
...