Skip to content
StampyWalletDocs
MCP and AI / Tools without an account / creer_commerce

creer_commerce

No accountWrites (confirm)

Creates the business on StampyWallet with the designed card (same parameters as concevoir_carte), and returns a personal link to take ownership of it: the person clicks, signs in with their email, and finds everything ready (card, QR code to print, free trial). The logo (logo_url) and the photo of each reward (paliers[].image_url), given by their https address, are placed on the card. No account needed. Call first with confirmer=false to show the summary, then with confirmer=true once the person has said yes.

Parameters

nomstring, ≤ 80 charactersrequired
Business name, printed at the top of the card.
metierenumoptional
Type of business. Picks a suitable style, stamp and starting reward when they are not given. "autre": beauty salons, nails, florists, hairdressers, grocery stores…

Values : cafe boulangerie restaurant autre

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

paliers[].image_urlstring, ≤ 2000 charactersoptional
Photo of the reward, by its https address (PNG, JPEG or WebP, 5 MB at most, at least 64 px per side). Cut out when possible, it replaces the icon on the card: in gray before it is earned, in color after. Drawn in paliers and points modes.
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

formeenumoptional
The card design, in one word (replaces forme_points and forme_paliers). Points and paliers modes: medailles (a gauge and a large 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, each visit moves the marker forward), anneau (a round gauge around the next reward). Tampons and paliers modes: the stamp layout, grille (default), libre (scattered), objets (large shaded objects, ideal with a photo), cercles. In paliers mode, a layout keeps the stamps and places each reward in place of the stamp at its threshold. One of the five shapes with no mode given switches the card to paliers mode.

Values : medailles vitrine remplissage chemin anneau grille libre objets cercles

encrestringoptional
Card text color, in hexadecimal (default: chosen to stay readable on the background).
accentstringoptional
Accent color: stamps added, gauges, labels, in hexadecimal (default: taken from the collection).
logo_urlstring, ≤ 2000 charactersoptional
Business logo, by its https address (PNG, JPEG or WebP, 5 MB at most): its Instagram profile picture works fine. Cut out when possible, placed at the top of the card; with no couleur, palette, encre or accent given, the card takes the logo's colors.
panier_moyennumber, 0.5…10000optional
Average spend per customer, in euros (used for the dashboard estimates).
langueenumoptional
Language of the returned texts. By default, the business's language.

Values : fr en es

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

With confirmer: false, the summary of what will be created. With confirmer: true, the business is created and the response carries a personal link: by following it, the person signs in with their email and finds their card, their QR code and their free trial.

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?