After a customer exits the checkout flow, Banked redirects them to the redirect_url provided when creating the payin. This URL handles all outcomes by default. If you also provide a nonsuccess_redirect_url, Banked will redirect failed and cancelled payments there instead, reserving redirect_url exclusively for successful payments.
Banked appends the following parameters to the redirect URL to provide context on the payment, customer action and resulting payment status:
| Parameters | Description |
|---|---|
banked-checkout-result | See Banked Checkout Result |
payment_result | See Payment Result |
payment_id | See Payment ID |
If you are using our Embedded Checkout, you can override these default redirects with callback functions. See Embedded Handle Checkout Redirect
Redirect URL Parameters Definitions
banked-checkout-result
Indicates the result of the customer's checkout experience:
| banked-checkout-result | Scenario |
|---|---|
success | Appears when redirected to the redirect_url. Indicates the customer successfully completed the checkout with the payment successfully processed to a sent state. |
pending | Appears when redirected to the redirect_url. Indicates the customer successfully completed the checkout but the payment is still in pending state and currently being processed. Do not release any goods until you have received a sent payment webhook. |
failure | Indicates the customer attempted to complete a checkout but the payment attempt failed and cannot be retried. Redirects to nonsuccess_redirect_url if set, otherwise redirect_url. |
user-cancelled | Indicates the customer opted to cancel the payment. Redirects to nonsuccess_redirect_url if set, otherwise redirect_url. |
payment_result
payment_result parameter refers to the Payin Status.
payment_result | Description |
|---|---|
awaiting_provider | A Banked payment link has been generated, but the user has not selected a provider. |
awaiting_payment_consent | The user has selected a provider and in the process of authorizing the payment within their banking application |
initiated | The bank has received the transaction request. |
pending | The user's bank has accepted the payment and is processing it. Pending status may be skipped for some payments. |
sent | The payment has been sent. The money has left the user's account and cannot be recalled. |
failed | The payment has failed. |
payment_id
payment_id is the UUID associated with the payin. See Payins API documentation for details.
Redirect Guidance
Below is a set of best practices when handling customer redirects:
1. Success Event
The user will be redirected to the redirect_url once they have successfully authorized a payment. It is important that you do not release any goods until you have received a sent webhook notification for a payment. As such, make sure your success page displays the following information:
- Order Details: Details about the order, such as the payment amount.
- Next Steps Information: Information about the next steps. For example, in case the payment is in a
pendingstate, the payment is being processed and an order confirmation will be sent to the user. - Branding Presence: Ensure that the user is aware they are back on your website.
2. Error Event
The user will be redirected to the nonsuccess_redirect_url if set, otherwise redirect_url, when the bank has rejected the attempt or the user has cancelled. This redirection serves as an opportunity to guide the user through alternative actions:
- Clear Next Steps: Offer alternative payment methods or the option to revisit their basket and attempt checkout again.
- Error Handling Guidance: Provide support resources or contact information for users encountering payment difficulties.
Default Error URL
If you do not specify a redirect_url or nonsuccess_redirect_url when creating a payin, Banked provides a default error URL. This URL redirects customers to a fallback page designed to offer alternative actions when a payment cannot be completed. The page provides two actions:
- Pay a Different Way:
- Informs the customer to close the window and return to the merchant's platform to select a different payment option.
- Suggests contacting the merchant for assistance via email or phone, with placeholders {support email} and {support tel} for customization.
- Try Pay By Bank Again:
- Provides a breakdown of attempting the Pay by Bank Checkout again.
While Banked offers a default, we recommend you specify a redirect_url when creating a payin to align the user experience with your branding and customer journey.