How to Integrate Your Form with PagSeguro

PagSeguro is a leading online payment solution for individuals and businesses in Brazil. With Jotform’s PagSeguro Integration, you can easily connect your forms and start accepting secure card payments online.

Jotform’s PagSeguro payment forms let you sell products or services, collect donations, or charge for bookings—all in Brazilian real (BRL). Just create your form, connect your PagSeguro account, and publish it. Once it’s live, you can start collecting payments from anyone, with payouts sent directly to your PagSeguro account.

Adding and Setting Up the PagSeguro Payment Field

Whether you’re creating a new form or updating an existing one, adding and setting up the PagSeguro payment field takes no time at all. Here’s what you’ll do:

1. In Form Builder, click on Add Element on the left side of the page.

2. Now, in the Form Elements menu, under the Payments tab, search for PagSeguro and click on it. Or, just drag and drop it to where you want it to be on your form.

3. Next, in the PagSeguro Integration window that opens on the right side of the page, enter the E-mail and Token from your PagSeguro account in the Gateway Credentials section. If you’re not sure how to get those, check out PagSeguro’s Documentation on Production environment authentication token to learn where to find them.

4. Then, in the Payment Type Dropdown menu, select what you’d like the payment to be processed for:
   • Sell Products — This is selected by default. Use this to sell physical or digital goods at a fixed price, allowing customers to make a one-time purchase.
   • User-Defined Amount — This lets customers enter the amount they want to pay. It’s useful for tipping, custom amount pricing, or flexible payments.
   • Collect Donations — Select this to accept voluntary contributions, commonly used for fundraising, nonprofit support, or charitable causes.

5. Once everything is set for the Sell Products payment type, click on Continue to start creating products for your payment field. For the User Defined Amount and Collect Donations payment types, just click on Save at the bottom.

When setting up your products, you might also want to check out these helpful guides:

• Setting Up Your First Order Form
• How to Add Options to Payment Forms
• How to Add Coupon Code to Payment Forms
• How to Add Tax to Your Payment Form
• How to Add Shipping Cost to Payment Forms
• How to Generate an Invoice for Your Payment Form
• How to Enable and Manage Product Stocks in Payment Fields

For the User Defined Amount and Collect Donations payment types, you can enter a description that’ll appear under the payment box on your form. You can also provide a suggested amount and set it as minimum or get the price from a Form Calculation widget, which is useful when you want to pass a calculated amount to your payment field instead of getting it from users. Need help getting started? See our guide on How to Pass a Calculation to a Payment Field to learn more.

When you expand the Additional Gateway Settings of the PagSeguro Integration section, you’ll see this list of options you can adjust based on the payment type you chose:

• Customer Email Field — This only shows and is set as required when an Email field is present on your form. Select that field from the dropdown to send the email address of your customer to PagSeguro as billing information.
• Users Can Select Multiple Products — This is only available with the Sell Products payment type and is enabled by default. You can toggle this Off if you want customers to select only one (1) product per submission.
• Show Total Price on the Form — This is only available with the Sell Products payment type and is enabled by default. You can toggle this Off if you want to hide the total price of selected products on your form.
• Sandbox Mode — Enables testing transactions without processing real payments. When enabled, you must use your E-mail and Token from your PagSeguro Sandbox account.
• Invoice Number Field — This shows when a Short Text field or Unique ID widget is present on your form. Select one from the dropdown to send a custom invoice number to PagSeguro as billing information.
• Shipping Address Field — This shows when an Address field is present on your form. Select that field from the dropdown to send the shipping address of your customer to PagSeguro as billing information.
• Clickable Image Preview — This is only available with the Sell Products payment type and is enabled by default. You can toggle this Off to prevent customers from enlarging product images.

• Show Decimals on the Form — This is only available with the Sell Products payment type and is enabled by default. You can toggle this Off to hide decimals on both the item prices and total amount.
  • Decimal Separator — When decimals are shown on your payment field, you can select between a period, which is used in English-speaking countries, or a comma, which is used in many European countries.
• Credit Card Label Text — This allows you to change the heading of the Credit Card fields in your Payment field.
• Billing Address — This allows you to change the heading of the Billing Address fields in your Payment field.

Setting Up PagSeguro with Reusable Payment Connections

Reusable Payment Connections lets you set up Payment Processor Integrations like PagSeguro just once, using the same gateway credentials and settings. You can then use them across different assets in your account, such as Forms and Apps.

Whether you’re creating a new form or updating an existing one, adding a Payment field and setting up a PagSeguro Reusable Payment Connection takes no time at all. Here’s how to do it:

1. In Form Builder, click on Add Element on the left side of the page.

2. Now, in the Form Elements menu, under the Payments tab, search for PagSeguro and click on it. Or, just drag and drop it to where you want it to be on your form.

3. Then, in the Payment Properties section that opens on the right side of the page, click on the Plug icon to add a reusable PagSeguro payment connection.

4. Next, in the Add PagSeguro Connection window, click on Test Mode or Live Mode at the top to select which environment you’re adding a payment connection for.
5. Then, in the Connection Name section, enter a name you haven’t used in other reusable payment connections in your account, if there are any.
6. After that, enter the E-mail and Token from your PagSeguro account and click on the blue Connect with PagSeguro button. If you’re not sure how to get those, check out PagSeguro’s Documentation on Production environment authentication token to learn where to find them. And if you’re setting up the payment connection for a Test Mode environment, you can get them from your PagSeguro Sandbox account.

7. Once it is connected successfully, click on Save at the bottom to add the reusable payment connection to your account.

If you have other existing payment connections saved in your account, you can search for the PagSeguro payment connection you’ve just added in the Payment Connections window, click on to select it, and then click on Use at the bottom.

8. Then, in the Payment Properties window on the right side of the page, click on the Payment Type Dropdown menu and select the option you’d like the payment to be processed for:
   • Sell Products — This is selected by default. Use this to sell physical or digital goods at a fixed price, allowing customers to make a one-time purchase.
   • User-Defined Amount — This lets customers enter the amount they want to pay, useful for tipping, custom amount pricing, or flexible payments.
   • Collect Donations — Select this to accept voluntary contributions. It’s commonly used for fundraising, nonprofit support, or charitable causes.

If you have an Email field on your form, you’ll need to click on the Ok, Got It button in the Additional Setup Required pop-up message, first.

In the Payment Properties window, select that field from the Customer Email Field Setting Dropdown to immediately fix the required settings error below. This setup sends your customers’ email addresses to PagSeguro as billing information.

Here are a few more gateway settings you can configure:

• Invoice Number Field — This shows when you’ve got a Short Text field or Unique ID widget on your form. Select one from the Dropdown menu to send a custom invoice number to PagSeguro as billing info.
• Shipping Address Field — This shows when you’ve got an Address field on your form. Select one from the Dropdown menu to send your customer’s shipping address to PagSeguro as billing info.
• Credit Card Label Text — This allows you to change the heading of the Credit Card fields in your Payment field.
• Billing Address — This allows you to change the heading of the Billing Address fields in your Payment field.

Once everything is set, on the right side of the field, and depending on the type of payment you chose in the Payment Properties window above:

• Click on the Shopping Cart icon to set up your Products.
• Click on the Money Token icon to set up User-Defined Amounts.
• Click on the Heart icon to set up Donations.