After shoppers complete the payment on the BoxPay checkout page, they will be redirected to the URL that you specified in the frontendReturnUrl field when creating the checkout session using the Create Checkout Session API.
During redirection, an inquiry token will be appended to the redirectionResult query parameter in the URL provided in frontendReturnUrl field. You can subsequently utilise the Operation Inquiry API to validate the payment status using the provided token. Depending on the returned status, you may take the following actions –
| Status | Recommended Action |
|---|---|
| Approved | The payment is successful. You can display an ‘Order Confirmation / Thank You’ page to your customers. |
| Posted | The payment is in a pending state and may require some time for approval or could potentially fail. In this situation, you can display a “Payment Pending” message, advising customers not to retry and to check back later to avoid potential duplicate payments. You will get the further update about this via webhooks. Additionally, if the payment fails later, you may choose to send them a Payment Link allowing them to retry the payment. |
| Rejected/Failed | The payment was unsuccessful even after multiple retries on the BoxPay checkout page. In this case, you can display a ‘Payment Failed’ page and guide them back to their cart. |
| RequiresAction | The payment was incomplete as customer didn’t perform the required steps like scanning QR, approving collect requeset, providing OTP on bank page etc. |
| TimedOut | The payment was unsuccessful due to timeout at Payment Gateway side. |