- How to use the thirdweb Checkout plugin - Install the thirdweb Checkout plugin in your Bubble app.
- Drag the thirdweb Checkout element onto your page.
- Configure the required fields in the element properties:
Chain ID (e.g. 8453 for Base)
Amount
Seller wallet address
(Optional) Add product title, description, image, or token address.

- Handling payments
This plugin does not automatically change your app’s data.
Use Bubble workflows to react to payment results:

- When thirdweb Checkout payment_success → run actions such as redirecting the user, unlocking content, or marking an order as paid.
- When thirdweb Checkout payment_failed → show an error message or allow the user to retry.

The exposed state error_message can be used to display the failure reason.