#310 — Facade API to Search Customers

Repo: Twill-AI/facade State: closed | Status: done Assignee: Unassigned

Created: 2025-03-19 · Updated: 2025-09-15

Description

See https://www.figma.com/design/ZUrZatocX5Vs79IBNqzGke/Twill-UI?node-id=9290-28853&t=RIaI1tbHfTsvpeox-4 for UI requirements and https://github.com/Twill-AI/facade/issues/309 for filter types limitation.

May look like a single POST HTTP REST endpoint with request body containing filters and pagination data. POST and “data in body” because some filters may contain sensitive information.

API is expected to query BD “twill_customer”, “twill_customer_payment” tables for rows data and also “card_token”, “ach_token” tables for joined filters.

Scope:

• Filters by:
  • id (exact string),
  • integrationId (exact string, get from GET /integrations),
  • name (free string),
  • email,
  • paymentMethod (card, ach)

AC:

• Facade provides API for searching customers in BD tables.
• API is covered by unit tests.
• https://twillpayments.atlassian.net/wiki/spaces/TD/pages/7929859/Facade+API is updated.

Notes

Add implementation notes, blockers, and context here

Related

Add wikilinks to related people, meetings, or other tickets