Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Status

Situation

Thank you page behavior

Webhook behavior

CONFIRMED

The payment authorization was successful

In most of the cases this means successful payment. In some edge cases it might not be the case and eventually the payment will fail (rejected by the bank).

For some businesses it might be OK to take the risk and consider this status as successful if the timing of product/service delivery is crucial and if it is acceptable to deal with the missing payment afterwards.

The risk can be fully mitigated by connecting the destination bank account to Everifin Paygate system. The payments will be paired by our system also against transactions appearing in the bank account.

Please contact us if you want to discuss this in more detail.

Depends on the merchant’s decision.

BOOKED

The payment has been already settled at the payer’s bank.

Information about the successful payment is displayed to customer.

The merchant’s order should be updated to reflect the payment success and further processes related to this fact can be initiated (invoice generation, notification email to customer, shipping process etc.).

FAILED

EXPIRED

The payment was not successful.

Information about the unsuccessful payment should be displayed to customer. Customer should be able to restart only the checkout process with existing shopping cart (so there is no need to start the whole shopping process over).

The merchant’s order should be updated to reflect the unsuccessful payment. Further actions related to this fact could be initiated (e.g. notification email sent to customer containing the link to page of the existing order where the customer could redo the checkout (with different payment method for example).

WITHDRAWN

The merchant withdrew the payment via API call (possible only when the customer has not yet started the authorization process).

The explanation why the payment has been withdrawn by the merchant should be displayed.

The merchant’s system already has the confirmation the withdrawal of the payment has been successful (in the response of the withdraw API call), so probably nothing has to be done anymore by webhook.

PROCESSING_EXPIRED

We are not able to get the payment status from the bank anymore (the grant given by the customer in the bank for us to get the payment status expired). This is rare edge case. Usually when customer leaves the payment authorization process.

Here the merchant has multiple options. The decision might be based on the business specifics (i.e. what goods or services is the merchant selling, if it is crucial to know the payment status instantly or the merchant can endure some delay - e.g. waiting with shipping until receiving of the money is confirmed on the bank account).

We are offering also service of connecting the collection bank account to cover these cases.

Some behavior options:

  • Treat this as unsuccessful payment (and then process potential refund in case the money arrives)

  • Inform the customer the payment is being still checked and she/he will be informed via email (or other channels) once it happensthe payment reaches final status.

Similar to “thank you” page behavior.

PROCESSING

In some edge cases it might happen the bank is processing the payment bit longer and the customer is informed by this fact by Paygate and then redirected back to merchant.

This status describes the fact we are still checking the payment status.

In this case it is also up to the merchant what behavior he chooses (depends on his business and preferences). Some possible options:

  • Inform the customer the payment is being still checked and she/he will be informed via email (or other channels) once it happensthe payment reaches final status.

  • Treat this as unsuccessful payment (and then process potential refund in case the money arrives)

The merchant’s system may update related order to status reflecting the payment is already being processed.

CREATED

SEEN

The payment is only initiated by the merchant system via API (CREATED) or has been seen on paygate web page by customer (SEEN). The payment can be in this statuses if the customer does not start the authorization and goes back in the browser and gets to “thank you” page.

If the customer gets to “thank you” page, merchant could withdraw the payment by calling withdraw endpoint and then let the customer restart the checkout process. If the customer chooses Everifin again, new payment would be initiated by the merchant’s system. After the withdraw of the payment the behavior could continue as in the case of statuses FAILED or EXPIRED.

If the payment is not withdrawn, it will expire in 30 minutes (status EXPIRED).

No action when the payment is moved to SEEN as it indicates the customer visited the Everifin payment page and might continue with authorization.

...