Error Handling

This topic describes the error handling function available for the Clearpay Button.

Property

The property is ClearpayButton.onError.

This property allows a custom function to be called that handles both client and server-side errors. When an error occurs, the Clearpay window closes and passes the message to the onError callback.

The onError hook returns event information that contains the following:

1
clearpayButton.onError = function(event) {
2
   const { errorCode, errorId, message, httpStatusCode } = event.data;
3
  // handle errors 
4
  // send error logs to backend 
5
  	console.table({ errorCode, errorId, message, httpStatusCode })
6
};

Clearpay Button Error Codes

An error at this point in the checkout flow means the customer has clicked the Clearpay Button. Unfortunately something then occurs and an order token is not created for this transaction. The Clearpay window closes, and sends details to the onError callback. The error codes are in the table below:

Return to the Clearpay Button guide menu