Docs tafs app
Connection profiles and Did this happen?
A profile describes an app the tafs app connected: what each operation does, where its amount is, and how KIFF can tell it happened. For whoever approves a connection, and for builders reading the API. KIFF writes the words you approve for it, and applies it only with your phone’s signature.
The words are KIFF’s
POST /v1/profiles/words takes a profile (kiff.profile.v1) and answers KIFF’s words for it
(kiff.words.v1), such as “Refund a payment: moves money through Stripe.” The app shows them as
they are. A profile never changes what a Card limits. With ?v=2, it answers kiff.words.v2: the
same words, without lines about KIFF’s own checks, such as a vendor it checks daily. An approval
of either version counts.
What KIFF holds to
- A Card’s room comes back only when nothing happened is established. A status code alone is never proof.
- A lost answer stays counted, and for a money call KIFF asks you Did this happen?
- Amounts are exact. More decimals than the unit takes is refused, never rounded.
- What the app says back is checked. On a difference, the operation is paused until you resume
it (
POST /v1/connections/{name}/resume). - New money operations start on probation: you confirm the first three calls’ outcomes.
Apps connected by API key: a refused, failed or unknown call stays counted, and an unknown one is never sent again.
Did this happen?
GET /v1/me/did-this-happen lists the money calls KIFF can’t prove, each with the taf, action, app,
amount, what it acted on, when, why, and a link to the app’s record when there is one.
Answer with POST /v1/me/did-this-happen/{proposal} {"answer": "yes" | "no" | "not_sure"}, signed
on the phone (Device signatures):
- Yes keeps the call counted.
- No gives the Card its room back, with Face ID. Nothing is reversed at the app.
- Not sure keeps it with you for a day and opens Coach on it.
The first Yes or No stands.
See also: Connect apps.