This is the recommended modality to start with. The user receives a link or payment button that opens the Stripe checkout in a WebView inside WhatsApp.
In the left sidebar of Brain Studio, open the Marketplace folder.If the integration is correctly connected, you will see Stripe listed as an available provider.
Stripe in Marketplace (sidebar)
2
Drag the node to the Canvas
Drag Stripe from the sidebar into your flow on the Canvas.When you drop it, the node block will be created with its available outputs.
Stripe tool with available outputs
3
Open the configuration panel
Select the node on the Canvas to open its configuration panel on the right side.Complete the Payment data and Advanced tabs, and review the available outputs on the Canvas node.
Main text of the message that accompanies the payment button.
Footer
Environment
Shows whether Stripe runs in Development or Production.In Development, you will see the message Your integration is in development mode. Move it to production when you are ready. and can start the Go to production flow.
Must match the environment you used to install Stripe (test or production credentials). See Go to production.
Defines how the charge is presented to the user.Available values:WebView payment (native tool), or other experiences enabled in your workspace.
To get started, use WebView payment. Native in-chat experience requires special enablement.
Stripe Connect
Enable this toggle if you installed Stripe via Create a Stripe account (guided registration in Mexico).
If you connected with your own Access Token (existing account), leave this toggle off.
Successful payment
Activated when the provider confirms the transaction was processed successfully.This is the official payment confirmation point within the flow.Usage examples:
Issue invoice
Activate subscription
Release product or service
Update order status in external system
Pending payment
Activated when the provider reports that the transaction is in a pending state.This may depend on the payment method and additional validations.Currently, monitoring the state change from pending to approved requires additional logic (for example, a webhook or subsequent status verification).
Failed payment
Activated when the transaction was rejected or declined.Recommendations:
Inform the user
Allow retry
Reuse the same Stripe node
HTTP Error
Activated when a communication error with the provider occurs (timeout, network, or invalid response).
Error Code
Activated when the provider returns an internal error code during payment creation or processing.
Successful CTA delivery
Activated when the payment button was sent successfully in the conversation.Indicates that the message with the button was displayed successfully in WhatsApp.Can be connected to an AI Agent that assists the user while they decide to complete the payment.Example prompt (reference):
Act as a payment assistant.The user has just received a button to complete their payment.Do not send proactive messages.Only respond if the user asks a question.Help them understand how to complete the payment and resolve related questions.
In addition to Canvas usage via native tools, Stripe exposes a set of advanced tools that can be used in more technical implementations or custom flows.These tools allow you to interact directly with Stripe services from your flow.
Available tools
Create Customer
Creates a new customer record in your Stripe account.Customers can be associated with:
Payment methods
Subscriptions
Invoices
Useful for:
Registering a customer before processing payments
Implementing subscription models
Managing payment history per customer
Create Payment Intent
Creates a PaymentIntent in Stripe.
The amount is sent in cents
(example: 15000 = $150.00)
Returns:
client_secret
payment_intent_id
Useful for:
Initiating a payment from a customer
Custom integrations
Advanced payment cycle control
Query payment status
Gets the current status of a payment by:
PaymentIntent ID
Charge ID
Returns details such as:
Status
Amount
Payment method
Receipt URL
Useful for:
Verifying if a customer completed the payment
Implementing additional validations
Post-transaction queries
List transactions
Lists recent balance transactions in the Stripe account:
Charges
Refunds
Transfers
Payouts
Supports:
Date filter (Unix timestamps)
Pagination
Useful for:
Reviewing recent activity
Accounting reconciliation
Movement audit
Process refund
Processes a full or partial refund of a charge or PaymentIntent.Available options:
