Credit Card Pre-Authorization

FS -> AA/AF (submitting order payments fro pre-authorization)

After successfully passing the fraud screening, the order payments are automatically submitted for pre-authorization. The submission for authorization is done by handler "OF_SubmitForPreAuth" and only for credit card payments. Payments of other types are not submitted. The authorization can take long time – up to several minutes – therefore the handler "OF_SubmitForPreAuth" registers event "PreAuth Request" and returns immediately. The order status is set to AA (awaiting authorization), while the event is processed asynchronously on the background.

I6 -> AA/AF (submitting order payments for pre-authorization)

Processing of manually approved orders (status I6) is identical to processing of automatically approved orders (status FS).

AA -> AC/CA (checking if pre-authorization is successful)

When the asynchronous handler of the event "PreAuth Request" receives response from the payment gateway, it registers e-transaction and triggers the next transition of the order flow AA -> AC/CA. The transition executes handler "OF_IsCardPreAuthSucceeded" which verifies the e-transaction. If the authorization is successful, the order is assigned the status AC (authorization complete). Otherwise, the order gets status CA (continues attempts). In this case, the system performs necessary retry attempts (WT status) and if they fail, the operator must decide what should be done with the order (AF status) – it can be resubmitted, cancelled or marked as fraudulent.

AF -> AA/AF (resubmitting order payment for pre-authorization)

If the order failed the pre-authorization, the operator can re-submit it for pre-authorization. The transition handling is identical to handling of FS -> AA transition, except for user has to do it manually from CP.

AF -> FR/AF (adding order parameters in black lists)

The operator can mark the order as fraudulent if it fails the pre-authorization. The handler "OF_PlaceParametersIntoBlackList" is used to add order parameters to the fraud screening black lists so that in future such orders are marked as suspected without submission to payment gateway.

AF -> CL/AF (canceling pre-authorization)

The operator can cancel the order if it fails the pre-authorization.

AC -> WA/I7 (verifying if manual approval is required for order)

After successful authorization, the order is automatically verified whether manual approval is required. The actions performed during this transition are same as in fraud screening except that fraud screening rules. The handler "OF_IsManualApproveRequired" called by this transition performs same actions as in fraud screening except that it used only fraud screening rules marked "Used For Manual Approval". This is the first of two transitions where the expected handler result is negative (manual approval is not required). The handler returns negative response if the order gets less fraud points than the threshold. The assigned order status I7 indicates that the order can be processed further. If the handler returns positive response (the accumulated fraud points are greater than the threshold and the order requires manual approval), the order is assigned with status WA (waiting for approval) and the operator must decide what should be done with the order – it can be approved, cancelled or marked as fraudulent.

WA -> I7/WA (manually approving the order)

If the order is marked as requiring manual approval, the operator can approve it by clicking Approve Order in CP. The order is then forwarded to next step.

WA -> FR/WA (marking order as fraudulent, putting its details in blacklists)

If the order is marked as requiring manual approval, the operator can disqualify it as fraudulent by clicking Mark As Fraud in CP. The handler "OF_PlaceParametersIntoBlackList" is used to add order parameters to the fraud screening black lists so that in future such orders are marked as suspected automatically.

WA -> CL/WA (canceling order)

If the order is marked as requiring manual approval, the operator can cancel it by clicking Cancel Order in CP. This would end the order processing.

CloudBlue, an Ingram Micro business, uses cookies to improve the usability of our site. By continuing to use this site and/or logging in you are accepting the use of these cookies. For more information, visit our Privacy Policy.