NOMA Sync Docs

Appearance

Settings Page

Purpose ​

The Settings page centralizes configuration and tools: LGL environment (production vs sandbox), alert recipients, Square default constituent, Mailchimp sync toggle, LGL reference data refresh, and (in dev) testing tools.

LGL Environment ​

  • Switch between Production and Sandbox (or similar). All LGL API calls from the Worker use the selected environment (different API key or base URL per env).
  • API: GET/PATCH /api/settings/lgl-environment.

Alert Recipients ​

  • Who receives failure alerts (e.g. email when a sync fails after retries). Configure a list of email addresses.
  • API: GET/PATCH /api/settings/alert-recipients.

Square Default Constituent ​

  • For Square orders with no customer, the Worker assigns the gift to a default constituent (e.g. “Noma Shop”). Here you set that constituent’s email, first name, last name. The Worker finds or creates this constituent in LGL and attaches such orders to it.
  • API: GET/PATCH /api/settings/square-default-constituent.

Mailchimp Sync Enabled ​

  • Toggle to enable or disable Mailchimp webhook processing / LGL updates. When disabled, Mailchimp webhooks may be acknowledged but no LGL updates.
  • API: GET/PATCH /api/settings/mailchimp-sync-enabled.

LGL Reference Data Refresh ​

  • Button to refresh LGL reference data (funds, campaigns, gift types, payment types, etc.) from the LGL API. After refresh, dropdowns in Mappings and elsewhere show the latest data.
  • API: POST /api/settings/lgl-reference-refresh (or similar).

Test Connections ​

  • Test buttons (e.g. LGL, Givebutter, Square) that call the Worker’s GET /api/test-connections (or per-integration health check) to verify credentials and connectivity. Useful after changing secrets or debugging.

Dev / Testing Tools (Development Only) ​

In development, the Settings page may expose:

  • Poll now – Trigger the polling job immediately (POST /api/poll-now or /api/dev/poll-now).
  • Simulate donation – Send a test Givebutter-like payload to trigger a sync (POST /api/dev/simulate-donation or /api/simulate-donation).
  • Inject webhook – POST /api/inject-webhook with a body to simulate a webhook.
  • Retry all / Reset test data – Optional endpoints for testing (see API reference).

These are typically disabled or hidden in production.

Who Can Edit ​

Admin and Super Admin. Viewer may see Settings but not change values.