#312 — Facade API to execute transactions
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=8735-34516&t=RIaI1tbHfTsvpeox-4 for UI requirements. Note that out of scope:
- support of Twill Customers, Payment Methods, Billing Addresses (will be implemented in https://github.com/Twill-AI/facade/issues/320)
- 3DS protection
- any interactions with BD and firing notifications
- Plans, Subscriptions, Payment Links
We need to call PayEngine’s /api/payment/ API-s:
- Credit Card Authorization
- Void Credit Authorization
- Credit Card Capture
- Credit Card Sale
- ACH Sale
- Refund
- Credit
Also we need to support idempotency from the client via “request-key” header to API-s listed above.
AC:
- Facade is able to call PayEngine API.
- Facade provides POST API (or multiple API-s) wrapping list of PayEngine API-s above. Required arguments (including value for “request-key” header) are received from the client (caller, UI) in request body. Response is proxied from PayEngine
Notes
Add implementation notes, blockers, and context here
Related
Add wikilinks to related people, meetings, or other tickets