Connect Your Square Account with CF7 Apps

The Square app allows you to accept payments directly through your Contact Form 7 forms using Square Checkout.

Before using the Square app, make sure CF7 Apps and CF7 Apps Pro are installed and activated on your WordPress website.

The Square payment gateway is available as a Pro feature.

The Square app provides:

• Global Settings – Connect your Square account and configure the environment and business location.
• Individual Form Settings – Enable Square for a specific Contact Form 7 form and configure its payment details.

Configure Square Payment Gateway Settings

To configure Square globally:

• Navigate to Contact → CF7 Apps → Dashboard.
• Locate Square under Payment Gateways.
• Click the Settings icon.

Square Global Settings

Setting	Description
Enable Square Integration	Enable or disable Square payments globally. Individual forms cannot use Square until you enable this setting.
Environment Mode	Select Live Mode for real payments or Test Mode to test payments through Square Sandbox.
Default Currency	View the currency synchronized from your connected Square account.
Location	Select the Square business location that should process the payments.
Square Connection	Connect or disconnect your Square account for the selected environment.
Save Settings	Save your Square configuration.

Notice: Square maintains separate connections, currencies, and locations for Test Mode and Live Mode. Connecting Square in one environment does not connect it in the other environment.

Test Square Payments

Test Mode uses Square Sandbox so you can test your Contact Form 7 payment flow without charging a real card.

To configure Square Test Mode:

1. Select Test Mode under Environment Mode.
2. Review the Test Mode Activated notice.
3. Click Connect to Square.
4. Authorize CF7 Apps using your Square Sandbox account.
5. Select a Sandbox Location.
6. Click Save Settings.

Use Square Sandbox test cards to test the payment process.

Square Sandbox transactions do not appear in CF7 Apps Payment Logs. CF7 Apps records only live Square payments in Entries → Payment Logs.

When you are ready to accept real payments, click here to switch to Live Mode in the notice or select Live Mode manually.

Process Live Square Payments

Live Mode allows your website to process real payments through your Square account.

Connect Square in Live Mode

To connect Square in Live Mode:

• Enable Square Integration.
• Select Live Mode under Environment Mode.
• Click Connect to Square.
• Square opens its authorization page.
• Sign in to your Square account.
• Click Allow to authorize CF7 Apps.
• Return to the CF7 Apps settings page.
• Confirm that the Square account connected message appears.
• Confirm the Default Currency is synchronized from your Square account.
• Select the Location that should receive payments.
• Click Save Settings.

After you connect Square:

• The Connect to Square button changes to Disconnect.
• CF7 Apps synchronizes the default currency from your Square account.
• You can select the business location that should process payments.
• You can click Disconnect to remove the stored connection.

Use the Visit Square Dashboard link to manage your Square account, locations, and payments.

Notice: You must select a Location before Square Checkout can start. If you do not select a location, the form submits normally without redirecting the visitor to Square.

Enable Square for a Contact Form 7 Form

After configuring the global Square settings, enable Square for the forms that should accept payments.

To configure Square for an individual form:

1. Navigate to Contact → Contact Forms.
2. Open an existing form or create a new one.
3. Scroll to the CF7 Apps settings panel.
4. Open Square under Payment Gateways.
5. Enable Square Integration.
6. Configure the payment settings.
7. Click Save Settings.

Notice: Only one payment gateway can be active on a form at a time. If Stripe or PayPal is already active, CF7 Apps displays a notice. When you enable Square and save the form, Square becomes the active payment gateway for that form.

Configure Square Payment Settings

Configure the information that CF7 Apps uses to create the Square payment.

Setting	Description
Customer Email Field	Select the form tag containing the customer’s email address, such as [your-email]. CF7 Apps pre-fills this email on the Square Checkout page and uses it to associate the payment with the form entry.
Default Currency	View the currency synchronized from your connected Square account.
Amount Field	Enter a fixed amount, such as 25, or use a form field tag such as [amount] to determine the payment amount dynamically.
Quantity Field	Enter a fixed quantity or use a form field tag such as [quantity].
Product Name Field	Enter a fixed product name or use a form field tag such as [product-name]. Square displays the product name during checkout.
Product Description Field	Enter a fixed description or use a form field tag such as [product-desc]. Square displays the description as a note during checkout.

Configure Square Redirect and Checkout Settings

Configure the URLs and checkout button behavior for the Square payment process.

Customers complete their payment securely on Square and then return to your website, where CF7 Apps confirms the payment result.

Setting	Description
Success URL	Specify the page where Square redirects the customer after a successful payment.
Failure URL	Specify the page where Square redirects the customer when the payment is canceled or fails.
Submit Button Type	Select the checkout button label: Pay, Donate, Book, or Auto (no override).

Make sure your Contact Form 7 form contains every field referenced in the Square settings. For example, add an email field such as [email* your-email] and a valid amount field.

If the customer email or payment amount is missing or invalid, CF7 Apps does not start the Square checkout process.

Notice: CF7 Apps does not charge or deduct any platform fee from Square payments; Square applies its own processing fees based on the payment type, location, and applicable pricing.

Process a Square Contact Form 7 Payment

After you enable Square for a form, CF7 Apps follows this payment flow:

• The visitor completes and submits the Contact Form 7 form.
• Contact Form 7 validates the submission.
• CF7 Apps reads the customer’s email, amount, quantity, and product details from the form.
• CF7 Apps creates a Square Payment Link for the selected location and environment.
• CF7 Apps redirects the visitor to the secure Square Checkout page.
• The customer completes the payment on Square.
• Square redirects the customer to the configured Success URL.
• CF7 Apps verifies the payment status with Square.
• CF7 Apps records the transaction in Payment Logs.

Notice: When you enable a payment gateway for a form, the payment redirect takes priority over the normal Redirection flow.

Need Help?

If you have questions about configuring Square payments with Contact Form 7, open a support request.

You can also suggest new features and improvements for CF7 Apps.