GivebearSetup and Pairing
Prepare the organization, pair the kiosk, and verify that the device is ready for donors.
Pairing connects a physical kiosk to a Givebear organization. Do not treat pairing as the first step. The organization should be payment-ready and have at least one real fund before a device is placed in front of donors.
Before pairing
Confirm:
- Stripe Connect onboarding is complete.
- Givebear plan readiness is complete.
- At least one fund is published.
- The device has internet access.
- Staff know which organization the device belongs to.
- A dashboard admin is available to complete device setup.
Pair the device
The exact screen labels can vary by release, but the workflow is:
Open the kiosk app on the device.
Start the pairing flow and obtain the pairing code or pairing prompt.
Open the dashboard device area for the correct organization.
Complete the pairing from the dashboard.
Name the device in a way staff will recognize, such as Lobby Kiosk or Ramadan Hall Kiosk.
Wait for the kiosk to sync organization data.
Confirm visible funds, branding, and payment readiness before donor use.
After pairing
Run a readiness check:
- The device appears in the dashboard.
- The kiosk shows the correct organization.
- The expected funds are visible.
- The app is not showing stale branding.
- The Terminal reader is connected if required.
- Staff can explain what to do if the internet drops.
Pairing mistakes to avoid
- Pairing to the wrong organization.
- Testing with an unpublished or unclear fund.
- Leaving the device name generic.
- Assuming sync is instant in a poor network location.
- Giving volunteers dashboard admin access when they only need kiosk operating instructions.