Handling Failed Payments in Stripe

Part 1. Adding Payment Failed Actions rule

1. Log into your web2wave account and open the paywall that contains your Stripe payment form. In the Screens panel on the left, click the popup screen that contains your payment form to open it in the editor.
2. In the Blocks panel, select either of the two blocks that support Payment Failed Actions rule:

• Stripe Checkout Form
• Stripe Wallets Express

3. The Block Properties panel on the right will update to show the selected block's settings. Scroll down in the Block Properties panel until you see the Payment Failed Actions section. Click the + button next to the section header to create your first rule. A rule form labeled #1 appears.

Part 2. Configure the Rule

Each rule has two mandatory fields: Error Codes and Action.

Error Codes

• Click the Error Codes dropdown menu to choose which Stripe error(s) trigger this rule.
• You can select one, multiple, or all available error codes.

Action

Click the Action dropdown to choose between two available options:

• Option A - JavaScript Callback: Runs custom JavaScript code when the error fires. A JavaScript Callback text field appears below the Action dropdown.
• Option B — Open Popup: Opens a different paywall popup screen[cite: 26]. A Popup to Open dropdown appears - select the target screen from the list.

Part 3A. JavaScript Callback - Code Examples

Enter any valid JavaScript in the JavaScript Callback field. The platform validates the code in real time - a red JS error: Unexpected token message appears if there is a syntax error.

Example 1 - Show an error toast

Displays a red notification banner at the top of the payment popup for any payment failure.

function(){
  w2w.showToast('Problem with your payment', 'error');
}

Example 2 - Log an event and redirect

Logs an analytics event and redirects the user to a different URL (e.g., an alternative offer page).

function(){
  w2w.logEvent('Purchase', { value: 90 });
  location.href = 'https://your-redirect-url.com/';
}

Part 3B. Open Popup - Set Up a Dedicated Error Screen

Instead of a JS callback, you can redirect the user to a dedicated error popup. Select Open Popup in the Action dropdown and choose the target screen from the Popup to Open dropdown.

Example 3 - How to build a dedicated error screen

1. Create a new popup screen: In the Screens panel, click + and name it (e.g., popup_3).
2. Add a Title block: Set the content to: Error with your payment.
3. (Optional) Add an Image block: Include an illustration of your choice.
4. Add a Button to Pay block: Label it Try again.
5. Configure the button: In the Block Properties, set On Pay Button Click → Open Popup #popup_2 to send the user back to the payment form.