Remember a card on an account
remember_cardAdds- What it does
- Adds a new record and leaves what you had alone. Safe to retry: the same call twice changes nothing more.
- Permission
- Transactions, change
transactions:write
What your assistant is told
Remember that a card pays from one of the user's accounts, so the next receipt or card payment resolves without asking. Pass the card's last 4 digits (last4), the name the wallet shows (label), or both — at least one. ONLY four digits: a full card number is refused and must never be sent anywhere in Budget. Ask the user before calling this; it is the follow-up to an "unknown" or "ambiguous" resolve_payment_account, not something to do on a hunch. The same 4 digits may sit on two accounts (two banks can both end 4821) — resolution then asks instead of guessing; a card NAME may not repeat (card_label_taken). Pass idempotencyKey (a UUID you mint) so a retry remembers it once. forget_card undoes a wrong link.
Parameters
accounttext, requiredAccount id, alias or IBAN, fromlist_accounts— the account this card pays from.last4text, optionalThe card's last 4 digits, e.g. "4821". Exactly 4 — never the full number.labeltext, optionalThe card's name as the wallet shows it, e.g. "ING Debit". Max 60 characters.idempotencyKeyid, optionalA UUID you mint for this call; replaying it remembers the card once.