VendorHearth Pro
Find answers, setup guides, and step-by-step help.
Connect and Use Square
Set up Square for payments, use Square when processing vendor application payments, and understand how webhook updates keep payment records in sync.
Use Square to handle application payments and payment authorizations in VendorHearth Pro. Once Square is available for your site, you can process payments through the payment workflow, review Square-linked payment details, and keep payment records current through the Square webhook connection.
Before you begin
- Make sure VendorHearth Pro is installed and active.
- Make sure you can access the plugin’s Settings and Payments areas in WordPress admin.
- Have your Square account and connection details ready.
Set up Square
- In WordPress admin, go to the plugin’s Settings area.
- Open the Square-related settings and enter the information needed to connect your site to Square.
- Save your changes.
After setup, Square can be used as the active payment option where your event’s payment workflow calls for it.
Choose how payments are handled for an event
Events can use either a traditional pay-after-approval flow or a Square authorization flow at application time. When Square authorization is used, the payment can be captured after approval or voided if the application is declined.
- Open the event you want to configure.
- Choose the payment workflow that matches how you want to collect funds for that event.
- Save the event.
This lets you decide whether applicants pay after approval or whether the payment is authorized up front and finalized later.
Process a Square payment
When a payment is submitted through the Square flow, VendorHearth Pro stores the payment against the application and updates the payment record as Square activity changes.
- Open the payment or application record in the admin area.
- Review the payment status and Square reference details.
- If needed, use the available Square payment action to work with the payment from WordPress admin.
After a successful Square payment, the vendor dashboard is refreshed so the latest payment state is shown.
Review Square payment details
You can confirm Square activity from the application details and payment areas. The plugin shows Square-related information such as the payment ID, API status, authorized amount, capture state, and expiration when an authorization is in place.
Use these details when you need to confirm whether a payment has been authorized, captured, voided, or otherwise updated.
Use the webhook connection
VendorHearth Pro includes a Square webhook route so Square can send payment updates back to your site. This helps keep local payment records synchronized when payment status changes in Square.
If payment changes are not appearing as expected, confirm that your Square webhook connection is still pointing to the site’s Square webhook endpoint.
Reconcile or refresh a payment
If a Square payment needs to be checked again, use the Square reconciliation tools available in the admin payment area. These tools are designed to verify Square’s completed status before updating the local payment record.
Good habits for Square payments
- Use the same payment workflow consistently for each event so staff know when payment is expected.
- Review payment details before approving or declining an application that uses Square authorization.
- Check the payment record after a transaction if the vendor dashboard does not show the expected status right away.
Troubleshooting
- If a payment was successful in Square but does not look current in WordPress, revisit the payment record and refresh the Square-linked status.
- If webhook updates are missing, verify the Square webhook connection for the site.
- If a payment was authorized but not captured, confirm whether the application was approved or declined, since that affects how the authorization is finalized.
Related tasks
- Set up event payment deadlines.
- Review payment authorizations for pending applications.
- Process refunds or voids according to your event workflow.
