Skip to main content
Once the integration is connected in Marketplace with the Access Token, the Store ID, the VAT, and the Currency, the Payphone node becomes available in your workspace to use inside your Canvas flows.

​
Add the node to the Canvas

1

Locate the integration in Marketplace

In the left side panel of Brain Studio, open the Marketplace folder.If the integration is correctly connected, you will see Payphone listed as an available provider.
Payphone visible in the Marketplace folder inside the Brain Studio side panel
2

Drag the node to the Canvas

Drag Payphone from the side panel into your flow in the Canvas.When you drop it, the node block will be created with its available outputs.
3

Open the configuration panel

Select the node in the Canvas to open its configuration panel on the right side.From there you can complete the inputs and review the available outputs.
Side configuration panel of the Payphone node showing all available fields

​
Configure the node

​
Save result as
string
Defines the name of the variable where Brain Studio will store the complete JSON response from the node.
Useful if you want to use the response later (logs, validations, traceability, or flow decisions).
​
Charge mode [one-time payment by default]
string
default:"payment"
Defines the charge mode.For this integration, the default value is payment.
​
Environment
string
required
Defines the environment in which the charge will be executed.Available values: DEV, PROD
The value configured here must match the environment selected in the application inside Payphone Developer.If you configure DEV in the node but the application is in production, or vice versa, the flow may fail or produce inconsistent results.
​
Payment button expiration [minutes]
number
Defines how long the payment button remains valid from the moment it is sent to the user.Available values: 10, 20, 30, 60
​
Payment reason
string
required
Descriptive text for the charge.Examples:
  • order number
  • product or service name
  • internal payment reference
​
Taxable amount
number
required
Enter the amount to charge that is subject to taxes.Accepts numeric values in dollars, including decimals when applicable.
​
Tax-exempt amount
number
required
Enter the amount to charge that is exempt from taxes.Accepts numeric values in dollars, including decimals when applicable.
​
Payment metadata
string
Additional information for traceability or internal reference.
You can use this field to correlate the payment with an order, a quote, or a reconciliation operation.
​
Customize payment button text
boolean
default:"false"
If you select Yes, additional fields are enabled to customize the message that accompanies the payment button.Fields enabled when activated:
  • Header (required)
  • Body (required)
  • Footer (required)
When this option is active, you can fully modify the message the user will see before opening the checkout.
​
Header
string
Title of the message that accompanies the payment button.
​
Body
string
Main text of the message that accompanies the payment button.

​
Important considerations

If you configure the node in DEV, the application in Payphone Developer must also be in Test.If you configure the node in PROD, the application in Payphone Developer must be in Production.
When a payment is initially pending, the agent informs the user of that status through the corresponding message.If Payphone later updates the result, the flow continues through the corresponding final output:
  • Successful Payment
  • Failed Payment
The pending state is not exposed as an independent output of the node.