category image

I am a user

Push API

Push API error messages

This article explains what the various Push API error messages mean.


If Paazl fails to send a status update message, it will email you one of two types of error notification: a message that something went wrong on the Paazl side (a server-side error), or a message that something went wrong on your side (a client-side error).


Note


You will need to configure Paazl with the email address to send the notifications to. Configuring the Push API describes how to do this.


Paazl errors


If something goes wrong on the Paazl side, you will receive a notification containing a Paazl exception.


Exception_Error_Notification.png



Contact Paazl Customer Support if you receive such a message.


Webshop errors


Note


You have to return an HTTP 200 status code if a Push request is successful. If your server returns anything other than a HTTP 200 status code it will assume that the Push request concerned has failed. It will send you an error message and its retry-policy will kick in.


A common mistake is to not send any response at all, or, for example when order creation fails in your webshop, to pass an internal webshop error back to Paazl's Push API. Please make sure you return an HTTP 200 status code if Paazl has successfully sent you an update, regardless of what your webshop does with that update.


Error message


If something goes wrong on your side, you will receive an email notification containing the HTML status code that your server returns.


Error_Notification_-_HTML.png



Configuring the Push API describes where you can specify the email address you want the notifications sent to.


Retry policy


If something goes wrong on your side, Paazl will make seven attempts to resend the status update message over a period of 24 hours. The interval between the attempts increases exponentially as shown in the table below.


Note


If Paazl has not been able to successfully send messages for 24 hours, the messages concerned will be lost.


RetryInterval (h, min, s)Interval (ms)
11s1,000
26.46s6,460
341.8s41,731
44.5min269,586
529min1,741,526
63h 12s11,250,261
720h 14min72,676,684

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article