GatherHearth
Find answers, setup guides, and step-by-step help.
Set Up and Use Payments
Connect Square, choose sandbox or production mode, and understand how GatherHearth handles payment deadlines for promoted waitlist spots and the temporary hold used during checkout.
Use GatherHearth payment settings to connect Square, test payments safely, and control how long attendees have to complete payment. You can also manage payment status for individual registrations from the registration details screen.
Before you begin
- You need WordPress administrator access to open the payment settings.
- If you plan to accept live payments, make sure your Square credentials are ready before switching out of testing mode.
Open the payment settings
- In the WordPress admin, go to GatherHearth and open Payment Settings.
- Review the current mode and Square fields before saving any changes.
Connect Square
- Enter your Application ID.
- Enter your Location ID.
- Enter your Access Token.
- Save your changes.
The access token is stored server-side and is not sent to the attendee browser.
Choose sandbox or production mode
GatherHearth supports a testing mode and a live payments mode. Start in Sandbox / Testing until you have completed a test payment. When you are ready to accept real payments, switch to Production / Live Payments and save your settings.
Set payment timing
Two timing controls help you manage paid registrations and waitlist promotions:
- Waitlist Payment Deadline controls how long a promoted attendee has to pay. The default is 48 hours. Enter 0 if you want no expiration.
- Initial Checkout Hold controls how long a new paid registration holds capacity while payment is pending. The default is 15 minutes.
After you save, the dashboard shows the current waitlist payment deadline for quick reference.
What happens during checkout
For paid registrations, GatherHearth places a temporary hold on capacity while payment is pending. This helps prevent overselling while the attendee completes checkout.
What happens for promoted waitlist spots
When a waitlisted attendee is promoted, they receive a payment deadline based on your payment settings. If payment is not completed before that deadline, the registration can expire according to the configured waitlist payment window.
Check payment status for an individual registration
- Go to GatherHearth > Registrations.
- Open the registration you want to review.
- Look in the payment area for the current amount due, status, payment deadline, and any checkout hold information.
If the registration was paid through Square, you can also see the Square payment reference on the registration details screen.
Manage or correct a payment
From the registration details screen, you can mark a registration as paid manually or, when the payment was processed through Square, refund the full payment through Square. Payment actions are available from the registration’s detail view and respect the registration’s current status.
Troubleshooting
- If Square is not configured yet, return to Payment Settings and verify your credentials.
- If you are testing, stay in sandbox until you have successfully completed a test payment.
- If a promoted attendee’s payment window has expired, review the registration record to confirm the deadline and current payment status.
