Skip to content
StampyWalletDocs
MCP and AI / Tools with an account / modifier_carte

modifier_carte

With accountWrites (confirm)

Changes one or more settings of the business's loyalty card, in a single call: printed name, style (collection, palette or custom color), stamp, reward rule (tampons/paliers/points mode, thresholds, rewards), stamps given at sign-up, reward expiry, in paliers mode the card shape (forme_paliers: tampons or one of the five shapes), and in points mode the name of the points, the card shape (forme_points), the default value of a visit, shortcuts and points per euro. Only the settings given change; read the card first with voir_carte. Call with confirmer=false (default) to show the before/after, then with confirmer=true after explicit approval. A rule change also applies to cards customers already have. Images (logo, background, image stamp) are changed in the app, Card page.

Parameters

nomstring, ≤ 80 charactersoptional
Business name, printed at the top of the card.
modeenumoptional
tampons: one reward at one threshold (the simplest). paliers: several rewards on the same card (e.g. 5 and 10). points: the business enters a number of points at each visit (varying baskets).

Values : tampons paliers points

recompensestring, ≤ 120 charactersoptional
The reward (tampons mode). Ignored if "paliers" is given.
tamponsinteger, 2…30optional
Number of visits to earn the reward (tampons mode), from 2 to 30.
paliersarray<object>, ≤ 6optional
The rewards and their thresholds (paliers and points modes). From smallest to largest.
paliers[].ainteger, 1…1000000required
Threshold: number of stamps (or points in points mode) to reach this tier.
paliers[].recompensestring, ≤ 120 charactersrequired
What the customer gets, as printed on the card. E.g. "A free coffee".
paliers[].iconeenumoptional
Icon for the tier (default: cadeau).
Values (63)

etincelle eclat goutte main pinceau oeil ciseaux sechoir fleur lotus coeur etoile diamant couronne soleil lune talon robe sac serviette cafe grain the cookie gateau pain part burger glace bol plat verre biere bulles cocktail cerises orange avocat piment oeuf poisson fromage popcorn feuille flamme eclair sourire patte chien chat cadeau haltere velo livre note appareil palette dent parapluie ballon tshirt basket croissant

collectionenumoptional
Card style: original (simple), cafe (thin frame), botanique (italic, foliage), trattoria (scalloped), atelier (modern), pass (like an Apple Wallet pass: large logo, stamps as shaded objects, solid background).

Values : original cafe botanique trattoria atelier pass

paletteinteger, 0…3optional
Palette of the collection: 0, 1 or 2 (each collection offers three; pass offers a fourth, 3). Ignored if "couleur" is given.
couleurstringoptional
Custom background color, in hexadecimal. The ink (text) color is chosen automatically to stay readable.
tamponenumoptional
The mark added at each visit. "rond": the simple dot. Beauty: etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette. Food: cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn. Other: feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket.
Values (64)

rond etincelle eclat goutte main pinceau oeil ciseaux sechoir fleur lotus coeur etoile diamant couronne soleil lune talon robe sac serviette cafe grain the cookie gateau pain part burger glace bol plat verre biere bulles cocktail cerises orange avocat piment oeuf poisson fromage popcorn feuille flamme eclair sourire patte chien chat cadeau haltere velo livre note appareil palette dent parapluie ballon tshirt basket croissant

tampons_bienvenueinteger, 0…5optional
Stamps given when the customer signs up (0 to 5). 1 by default: a card already started makes people want to finish it.
nom_des_pointsstring, ≤ 20 charactersoptional
Points mode: what the points are called ("points", "seeds", "stars"…).
forme_paliersenumoptional
Paliers mode: the card design. tampons (default): stamps in a grid, each reward in place of the stamp at its threshold. Or one of the five points shapes, which then counts stamps: medailles (a gauge and a medal per reward), vitrine (rewards side by side, each with its gauge), remplissage (the next reward shown large, filling with color), chemin (an S-shaped road where each stamp moves the marker forward), anneau (a round gauge around the next reward). Reward photos are uploaded in the app, Card page.

Values : tampons medailles vitrine remplissage chemin anneau

forme_pointsenumoptional
Points mode: the card design. medailles (default): a thick gauge and a large medal per reward. vitrine: rewards side by side, each with a small gauge. remplissage: the next reward shown large, filling with color as it goes. chemin: an S-shaped road, with rewards as steps. anneau: a round gauge around the next reward, with the list next to it. Reward photos are uploaded in the app, Card page.

Values : medailles vitrine remplissage chemin anneau

expiration_recompense_joursinteger, 0…365optional
Days an earned reward stays valid: 0, 30, 60, 90, 180, 365 (0 = never expires).
points_par_defautinteger, 1…100000optional
Points mode: points added by default at each visit (1 to 100,000).
points_raccourcisarray<integer>, ≤ 12optional
Points mode: the values offered with one tap when scanning (up to 6, sorted and deduplicated). E.g. [1, 2, 5, 10].
points_par_euronumber, 0.01…10000optional
Points mode: points per euro spent, a guide shown to the business (e.g. 1 or 0.5).
confirmerbooleanoptional
false (default): only returns a preview of what would be done, without changing anything. true: carries it out. Always show the preview to the person and wait for their approval before calling again with true.

Default : false

Response

A text the assistant reads (content), and the same information as structured data (structuredContent). When a call is refused (a parameter to fix, plan, role), the response has isError: true and a sentence the assistant can rephrase.

Warning : this tool writes. Called with confirmer: false (the default), it only returns a preview, without changing anything. The assistant must show it to you and wait for your approval before calling again with confirmer: true.

Updated

Was this page helpful?