Set PayPal Payment properties
On this page
The PayPal Payment field lets you accept payments directly inside your form using PayPal’s own payment buttons.
PayPal decides which buttons each buyer sees, and the field supports dynamic pricing that updates in real-time as users fill out the form.
Add field
To add a PayPal Payment field, in the form builder, select PayPal Payment from Enhanced Features in the left toolbar (in the Web PDF Form and Master Form builders it is under Form only). A form can have only one payment field.
Connect your PayPal account
Before the field can process payments, you need to connect a PayPal business account.
The properties panel provides two separate connection slots:
- Connect with PayPal: used by the published form to accept real payments
- Connect with PayPal (Sandbox): used only by the builder’s preview, for test payments with PayPal sandbox accounts
Click a connect button to open PayPal in a pop-up window, sign in to (or create) your PayPal business account and grant PlatoForms permission. When it is done, the pop-up closes and the slot shows the account name with a green tick, plus a link to remove it: Revoke Connection for the live account, Revoke Test Model Connection for the sandbox account.
The amount settings appear once at least one of the two accounts is connected.
If PayPal reports that the connected account cannot take payments yet, for example because its email address is not confirmed or the account is restricted, a yellow “Attention” warning appears under the account name. Fix it in your PayPal account.
Configure payment amount
The field supports two ways to set the payment amount.
Fixed amount
Select Fixed Amount and enter a number directly. Every submission charges the same price.
Amount from a form field
Select Amount from a form field to link the payment to a dynamic value calculated elsewhere in the form.
- Add a Text Input field (type Short Text) to the form, label it (for example,
pricing), and mark it as Hidden on Form. Its value will be set by form logic to match the intended price. - In the PayPal Payment field properties, set Payment Amount Field to that field (for example,
#5 SingleText - pricing). - Optionally, include
{{pricing}}in the field Label: it will be replaced by the live amount as users interact with the form.
You can combine this with form logic to set the price based on user selections.
IF (product is “Coffee”) THEN (set pricing field) to “2”.
For more details, refer to Set Form Logic.
Currency
| Setting | Description |
|---|---|
| Currency Code | The currency used for the transaction (for example, USD, EUR, JPY). Defaults to USD. |
The panel also has a PayPal Item Description box. It is saved with the field, but it is not sent to PayPal, so buyers do not see it.
The amount must be greater than zero. If it is not (an empty fixed amount, or an empty price field), clicking a PayPal button shows “Please enter an amount greater than zero before paying.” and no payment starts.
Payment buttons
The PayPal Payment field shows PayPal’s payment buttons. PayPal decides which buttons each buyer sees; Pay Later and Venmo are offered where PayPal makes them available.
You do not need to configure each button. When the buyer clicks one, PayPal opens in a pop-up window where they sign in and approve the payment. Back on the form, the field shows “Payment completed”. The payment is taken at that moment, before the form is submitted, and a submission that is already paid is not charged again when it is edited and resubmitted.
Test and go live
Always test the complete payment flow before publishing your form. The builder’s preview (Preview & Design) always uses the sandbox account, and the published form always uses the live account.
| Mode | Used for | PayPal connection |
|---|---|---|
| Sandbox | Testing with fake funds in Preview & Design | Connect with PayPal (Sandbox) |
| Live | Real payments on the published form | Connect with PayPal |
Set up sandbox accounts
PayPal automatically provides two mock accounts for testing. To find them:
-
Go to the PayPal Developer dashboard.
-
Under the Testing Tools menu, select Sandbox Accounts.
-
You will see two pre-created accounts: one with type Business and one with type Personal.
-
Click either account name to view its details, including the email address and password needed for testing.
| Account type | Role |
|---|---|
| Business | Mock merchant: use these credentials to connect the sandbox slot in PlatoForms |
| Personal | Mock buyer: use these credentials to complete a test payment in the preview |
Connect the sandbox account
- In the PayPal Payment field properties, click Connect with PayPal (Sandbox).
- When prompted, enter the credentials of the Business sandbox account.
- Authorize the connection. The slot shows the account name followed by “(Sandbox)” and Revoke Test Model Connection when successfully linked.
Test the payment flow
- Make sure you are logged out of any PayPal session in your browser.
- In the builder, open Preview & Design.
- Fill out the form and select options to trigger the dynamic price.
- Click the PayPal button and log in using the Personal sandbox account credentials.
- Complete the test payment and check that the field shows “Payment completed”. As with every preview, the test submission is not saved.
Do not test on the form’s public link: the published form never uses the sandbox account, so a payment there takes real money. If PayPal blocks the test because the merchant and buyer accounts are signed in in the same browser, sign out of PayPal or use another browser for the preview.
Validation and security
- Payment before submit: The PayPal buttons are ready as soon as the field is shown. The respondent pays in the field, then submits the form; the submission is accepted only if the payment can be confirmed with PayPal. If the respondent submits without paying, the field shows “This field is required.” (the field is required by default).
- Secure processing: The respondent signs in and approves the payment in PayPal’s own window. PlatoForms never sees or stores their PayPal or card details.
Plans
Payment integrations need a paid plan or the free trial. With either you can connect PayPal, live and sandbox. On the free plan payment integrations are not available: the connect button says “Payment integrations need a paid plan or the free trial.”
When the team’s paid plan or free trial ends, the form’s payment connections (Stripe, PayPal and Square) are switched off, so the payment field stops taking payments, in the preview as well. The field then shows “(Please Setup PayPal connection)” after its label. The connections come back on automatically when the team subscribes.
Video tutorial
Learn better visually? Watch the full walkthrough.