Unipiazza
Loyalty & ReferralRun an Italian customer loyalty programme with the Unipiazza Partner API, registering customers and recording receipts so points accrue. Agents award credit off the transaction rather than a manual entry.
What This Integration Enables
Unipiazza runs Italian loyalty programmes for businesses whose customers are standing in front of them. The unit of earning is a receipt, not a click. That single fact separates it from every referral and giveaway platform you might line it up against. It also introduces a problem those platforms do not have. The same purchase can be submitted twice, and a coin balance that is wrong is wrong in front of a person at a counter who can see it on their pass.
The connector covers the whole programme. Agents register customers into the scheme with their wallet pass and marketing consent, look them up by email or ID, and page through the customer base with filtering by list, shop or scope. They read a customer's full activity history of receipts, point movements and promos, and pull the birthdays falling in a given window. On the transaction side they record receipts so coins accrue, delete receipts to reverse them when a purchase is refunded, and issue promos that redeem coins against a product from the catalogue. They also build the audience side of the programme: dynamic segments and manual lists, membership updates, and a view of the marketing and WhatsApp campaigns already scheduled against them.
One implementation detail is worth stating plainly because it decides whether your flow is safe. Create Receipt deduplicates on shop, amount, customer and the generated timestamp. Omit the timestamp and it defaults to the current time, which means a retry after a network blip becomes a second distinct receipt and the customer gets credited twice. Always send it.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Purchase to coins, with the duplicate check first
An order closes in Shopify or at the till. The agent resolves the shopper with Find User, reads Get User History for the same shop, amount and timestamp combination, and only then calls Create Receipt with the generated timestamp attached so the retry path is safe. The coins land on the customer's pass before they have left the counter. If the history already shows that combination, the agent does not create a second receipt and does not silently discard the order either. It flags it for the shop manager with both records side by side.
Redemption at the counter
A customer wants to claim a reward. The agent calls Get Products to read the catalogue and each item's coin cost, Get User to read their current balance, and confirms the customer can afford the item. Create Promo issues the reward and redeems the coins in one move. The staff member hands over the product. The balance on the pass updates, and the promo appears in the customer's history where the next person to serve them can see it.
Birthdays and campaign audiences built from real behaviour
Get Birthdays runs on a daily schedule and returns the customers whose birthday falls in the window, and the agent issues each one a promo as an annual touchpoint. Separately, the agent uses Get Users with list and shop filters to assemble an audience, then Create User List and Update List Members to build a manual group for a WhatsApp campaign. Get Campaigns shows what is already scheduled against those lists, so a customer is not hit by two promotions in the same week.
Human-in-Loop Highlight
Delete Receipt is the call that needs a person, because it takes coins away from a balance a real customer can already see on their pass. A refund, a mis-keyed amount, or a duplicate submitted during a retry all point at the same fix, and that fix is destructive. Reversing a receipt removes the coins it awarded. If the customer has already spent them on a promo, the reversal produces a balance conversation nobody at the counter is equipped to have. So the agent gathers rather than acts. It pulls Get User History for the disputed period, lines up the receipts that share a shop, amount and timestamp, notes any promo issued since, and asks the shop manager: "Two receipts for 48 euro at the Via Roma shop, both timestamped within four seconds of each other on Saturday. The customer redeemed a promo on Sunday costing 300 coins. Reverse the second receipt, or leave both in place?" The manager decides. The agent executes and writes the reason into the record. This is the digital andon cord applied to a shop counter: the agent runs the accrual all day without help, and stops the line only where a wrong answer would take something away from a customer who is standing right there. Everything up to that point stays a human-in-the-loop decision waiting for the one person qualified to make it.
Agent Capabilities
14 actionsCustomers
6- Create User Registers a customer in the loyalty programme, optionally linking their wallet pass and recording marketing consent. Used when someone joins the scheme through your own signup form or at the counter.
- Find User Looks up a loyalty customer by email address and returns their Unipiazza record. Used whenever your own system knows the customer by email and the flow needs their Unipiazza ID.
- Get Users Retrieves loyalty customers with paging and optional filtering by list, shop or scope. Used to export the customer base or to segment it for a campaign.
- Get User Retrieves a single customer by ID with their profile, points balance and programme details. Used to inspect someone before awarding points or issuing a promo.
- Get User History Retrieves a customer's activity history, showing the receipts, point movements and promos recorded against them. Used to answer a balance query at the counter, and as the duplicate check before a receipt is created.
- Get Birthdays Retrieves customers whose birthday falls in the requested window. Used on a schedule to drive an annual loyalty touchpoint without maintaining a separate calendar.
Receipts and Promos
3- Create Receipt Records a purchase against a customer so loyalty coins accrue. Always send the generated timestamp: Unipiazza deduplicates on shop, amount, customer and that timestamp, and omitting it defaults to the current time, which makes retries unsafe.
- Delete Receipt Deletes a recorded receipt, reversing the loyalty coins it awarded. Used when a purchase is refunded or a receipt was captured in error, and always behind a human decision because it removes coins from a live balance.
- Create Promo Issues a promotional reward to a customer, redeeming coins against one of your products. Used at the counter when a customer claims a loyalty reward.
Lists and Campaigns
4- Get User Lists Retrieves the customer lists on the account, both dynamic segments and manually curated groups, with their filters and status. Used to find a list before targeting a campaign at it.
- Create User List Creates a customer list, either a dynamic segment driven by filters or a manual group you populate yourself. Used to build an audience for a marketing or WhatsApp campaign.
- Update List Members Adds, removes or replaces the customers in a manual list. Replace sets the exact membership in one call, while Add and Remove adjust it incrementally.
- Get Campaigns Retrieves the marketing and WhatsApp campaigns configured on the account with their status, audience filter and target lists. Used to check what is already scheduled before adding another campaign against the same customers.
Catalogue
1- Get Products Retrieves the products customers can redeem with their loyalty coins, including each one's coin cost and imagery. Used to find the product ID a promo needs, and to show a customer what their balance is close to reaching.
Frequently Asked Questions
What can FlowRunner do with Unipiazza?
FlowRunner agents can run Create User, Find User, and Get Users in Unipiazza, plus 11 more actions.
Does connecting Unipiazza to FlowRunner require OAuth?
No. Unipiazza connects to FlowRunner with an API key, no OAuth flow required.
Can Unipiazza trigger a FlowRunner workflow automatically?
Unipiazza doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with Unipiazza
$100 in credits. No card required. Connect in minutes.