2 operations. Every schema and example on this page is generated from the platform contract.
Use this when the person asks about their own Membber order: is it ready, when or where to collect it, their order number or code, what they have to collect today or coming up, whether someone else can collect it, their receipt, or their refund. Also when they want to tell the shop they are running late, or to move, change or cancel their order: the card shows the message and only their own tap sends it to the shop. It needs them to connect their Membber once (their app asks them); it then shows only their own orders, as a card. Never ask them for an email or a code. The card shows the answer itself, so add at most a few words and never repeat its times, codes or prices. Nothing is changed, cancelled or refunded here, and nothing is sent without their tap.
What they asked, by their words: "ticket" for is it ready, when or where to collect, or their order number; "today" for anything to collect today or what they have coming; "share" for someone else collecting it; "receipt" for their receipt; "refund" for their refund; "late" when they want to tell the shop they are running late; "change" when they want to move, change or cancel their order (the shop decides: the card offers to ask it).
tickettodaysharereceiptrefundlatechangeThe shop they named: a business_id, handle or name. Leave it out otherwise.
Their order number only when they gave one (from their receipt email, e.g. Q8DV-917645). Never guess it.
late or change only: their words to the shop, short, in their own voice, e.g. "Hi, I'm running about 15 minutes late. Sorry!" or "Can I move my order to Sunday?". Nothing else is added bar their order line.
late or change only: their first name, only when they gave it because the card asked. Never guess it.
change only: the day they want instead, in their words or as YYYY-MM-DD ("Sunday", "Sat 14 Nov", "2026-11-15"). Leave it out otherwise.
tickettodaysharereceiptrefundlatechangefound: the answer. which: more than one shop fits, so ask which (choices). none: no order with this email on Membber, or (today) nothing to collect. not_found: no order of theirs at the shop or with the number named.
foundwhichnonenot_foundOne short line for the person.
The shops to choose between, for which.
today: pickups today. upcoming: none today, these are next.
todayupcomingOne order (ticket, share), or her pickups in time order (today).
ready_to_collectcollection_openupcomingpay_on_collectionawaiting_paymentwindow_passedpaidcollectednot_collectedcancelledrefundedrefund_on_the_waydisputedOne plain sentence for the person.
How far along it is: order in, being made, ready (an everyday order, only when the seller marked it) or collect (a drop order whose collection window has opened). Null once there is nothing to collect.
order_inbeing_madereadycollectA drop order only: true once the shop pressed Started making. Never inferred from anything else, so Being made is lit only on that.
True for a drop order (shoppers' box): its steps are order in, being made (the shop pressed Started making) and collect. A drop order is never "ready".
The shop's public id, for its colour on a card.
The shop's own page on Membber.
YYYY-MM-DD in the shop’s own calendar.
Where to collect: the street address only when the shop publishes it, otherwise its area (the exact place is on the person's order page).
Delivery by post: present only on a posted order, which is never collected (collection is then empty and progress null). No address and no tracking number: those are on the person's order page.
Where the parcel is, as her order page says it.
to_postlatepostedarrivednot_arrivedcame_backYYYY-MM-DD: the shop posts it by this day (her calendar).
YYYY-MM-DD the shop marked it posted; null until then.
Usually arrives between these days.
Posted with no tracking number.
This order, for the card to ask about it again (only ever her own, under her sign-in).
Her shop's card colour.
Her order number, as in her receipt email.
The code she shows at the counter, only once it is hers to show (paid, or a cash order), as her order page decides.
Her order pass can be added to Wallet now.
An everyday order to collect as soon as it is ready (no collection time).
When she placed it (an instant). An order with no collection time is named by this day and time, never "as soon as possible".
Lines left out after the first ones drawn (the total covers them all).
The whole discount on the order (a code, a voucher), as her receipt email shows it.
The booking fee, only when the order carried one.
What a gift card paid, when one did (a way of paying, not a discount).
What she paid: by card when a gift card paid part, else the whole.
True once the money is in. A receipt is only ever drawn for a paid order.
How she paid, in words: "Apple Pay", "Visa", "Cash". Never a card number.
refunded: all of it given back. part_refunded: some of it. on_the_way: it sold out while she paid and the refund is being made. did_not_go_through: a refund her bank refused; the shop pays her another way. none: no refund.
refundedpart_refundedon_the_waydid_not_go_throughnoneThe day it was refunded, when the order holds it. Never guessed.
It went back to her card (so her bank sets when it lands), rather than another way.
late and change only: the message to her shop, for her own tap.
The shop's Membber handle, which the shop question names it by. Null: it cannot be asked here.
True when the card can send it on her tap: a shop that takes questions here, and her first name.
True when only her first name is missing: ask it, then call again with first_name.
Her proved email: the shop replies to it.
Her words, as the card shows them.
Her order as the shop recognises it: her items and her day ("3 × Seeded Rye Loaf, collect Sat 7 Nov, 10am to 12pm"). Never her order number or code.
Exactly what reaches the shop: her words, then her order line (the path carries no order reference).
The shop question's own sentence, shown before her tap and kept as her yes.
change only: the shop's OWN words on changing or cancelling, quoted from its own terms. Null when it has written none.
change only: the day she asked to move it to, on her shop's calendar ("Sunday" read as its date). Null: she named no day.
change only: true when her shop collects on the day she asked, false when it does not, null when not known (no day asked, a drop order, or past the days it takes orders for).
change only: when the day she asked is shut, the next day her shop collects after it. Null otherwise.
change only: her shop's open collection days that week (Monday to Sunday around the day she asked, from today), each with its first and last free time (HH:MM, the shop's clock). Empty for a drop order.
ticket, share, late, change: she has nothing to collect, so the one order shown is her last one (the summary names its day and what became of it).
curl -G "https://www.membber.com/api/v1/shopper/my-order" \
-H "Authorization: Bearer $MEMBBER_TOKEN" \
--data-urlencode "show=ticket"import { createMembberClient } from "@membber/sdk-ts";
const membber = createMembberClient({
getAccessToken: () => process.env.MEMBBER_TOKEN,
});
const { data, error } = await membber.raw.GET("/api/v1/shopper/my-order", {
params: { query: { show: "ticket" } },
});
if (error) {
// Typed error envelope: { error: { code, message, requestId } }
throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);import MembberSwift
let client = MembberClient(
serverURL: MembberClient.productionServerURL,
tokenProvider: { session.accessToken }
)
let response = try await client.api.getMyOrder(
query: .init(show: "ticket")
).ok.body.json
print(response){
"contract_version": "<contract_version>",
"show": "ticket",
"result_status": "found",
"summary": "<summary>",
"shop": {
"business_id": "490799fa-0000-4000-8000-d0c500000049",
"name": "Example name"
},
"choices": [
{
"business_id": "490799fa-0000-4000-8000-d0c500000049",
"name": "Example name"
}
],
"day": "today",
"orders": [
{
"status": "ready_to_collect",
"status_line": "<status_line>",
"progress": "order_in",
"started_making": true,
"drop": true,
"business": {
"id": "00000d1b-0000-4000-8000-d0c500000000",
"name": "Example name",
"url": "https://example.com"
},
"collection": {
"date": "<date>",
"starts_at": "<starts_at>",
"ends_at": "<ends_at>",
"timezone": "Europe/London",
"place": "<place>"
},
"post": {
"status": "to_post",
"post_by_date": "<post_by_date>",
"posted_on": "<posted_on>",
"arrives_from": "<arrives_from>",
"arrives_to": "<arrives_to>",
"without_tracking": true
},
"ref": "<ref>",
"colour": "<colour>",
"logo": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"order_number": "<order_number>",
"collection_code": "EXAMPLE10",
"wallet_ready": true,
"asap": true,
"placed_at": "<placed_at>"
}
],
"receipt": {
"ref": "<ref>",
"business": {
"business_id": "490799fa-0000-4000-8000-d0c500000049",
"name": "Example name"
},
"order_number": "<order_number>",
"placed_on": "<placed_on>",
"lines": [
{
"title": "Morning class",
"quantity": 1,
"line_total": {
"pence": -9007199254740991,
"display": "<display>"
}
}
],
"more_lines": 0,
"discount": {
"code": "EXAMPLE10",
"amount": {
"pence": -9007199254740991,
"display": "<display>"
}
},
"booking_fee": {
"pence": -9007199254740991,
"display": "<display>"
},
"gift_card": {
"pence": -9007199254740991,
"display": "<display>"
},
"total": {
"pence": -9007199254740991,
"display": "<display>"
},
"paid": true,
"refunded": {
"pence": -9007199254740991,
"display": "<display>"
},
"paid_with": "<paid_with>"
},
"refund": {
"ref": "<ref>",
"business": {
"business_id": "490799fa-0000-4000-8000-d0c500000049",
"name": "Example name"
},
"order_number": "<order_number>",
"state": "refunded",
"amount": {
"pence": -9007199254740991,
"display": "<display>"
},
"refunded_on": "<refunded_on>",
"to_card": true
},
"ask": {
"shop_handle": "<shop_handle>",
"can_send": true,
"needs_first_name": true,
"email": "alex@example.com",
"first_name": "Alex",
"note": "Added at the front desk",
"order_line": "<order_line>",
"message": "Added at the front desk",
"consent_text": "<consent_text>",
"change_words": "<change_words>",
"asked_date": "<asked_date>",
"asked_open": true,
"next_open_date": "<next_open_date>",
"open_days": [
{
"date": "<date>",
"from": "<from>",
"until": "<until>"
}
]
},
"last_order": true
}Use this when the person asks what they have at a shop on Membber: their points or stamps, their usual or last order, ordering the same again, or any freebies. It needs them to connect their Membber once (their app asks them); it then shows only their own, as a card. Also when they ask to see all their stamp cards, how to get stamps at a shop, or to put their card in Apple or Google Wallet, and for their drop reminders, what is new at the shops they buy from, how often they have been to a shop, and what Membber shares here about them. Pass what: "stamps_and_orders", show: what they asked for, and the shop when they named one (a business_id, handle or name). The card shows the answer itself, so add at most a few words and never repeat its numbers or items. Nothing is ordered, paid, stamped, redeemed, stopped or changed here.
Always "stamps_and_orders".
The shop they named: a business_id, handle or name. Leave it out for the shop of their latest order.
What they asked for, by their words: "stamps" for points, stamps or their loyalty card; "usual" for their usual, ordering again or the same as last time; "rewards" for freebies, rewards or anything free; "all" for all their stamps or every card they have (no shop needed); "earn" for how to get or earn stamps at a shop; "wallet" for putting their card in Apple Wallet or Google Wallet; "reminders" for their drop reminders; "new" for what is new at their shops; "year" for how often they have been to a shop; "account" for what Membber knows or shares about them. Leave it out for "stamps".
stampsusualrewardsallearnwalletremindersnewyearaccountWhat she asked for, as asked (stamps when not said): the card draws only that.
stampsusualrewardsallearnwalletremindersnewyearaccountyours: a shop and what she has there. nothing_yet: no order with this email on Membber. not_at_that_shop: none at the shop she named.
yoursnothing_yetnot_at_that_shopOne or two plain sentences for the person.
Null when it cannot be said truly: no stamp card at this shop, or her record there is not provably hers.
The shop's own name for the reward, only when it reads as one. Null otherwise.
The photo of the item her reward names, when it names one of the shop's items with a photo.
One per stamp drawn, newest first: the photo of what earned it, or null for a stamp with no order behind it.
itm_ id of the item on her menu, so Same again can find it today. Null when the item is no longer on her menu.
Her shop's card look, as the app and her Wallet card draw it. Null when there is no shop to show.
Her card colour, as her Wallet card's.
The published picture her stamps sit on, through Membber's media address.
Her filled stamp. Null: the plain tick.
Her empty stamp, as the app draws an empty place. Absent or null: her filled stamp, faded.
Her card's own name, drawn in place of the shop name. Absent: the shop name.
Whether her last box can go in a box again now: ready (a drop of this shop that holds those items is open, or her order page takes one of them now for collection), no_open_drop (the shop is on Membber but neither can take them now: offer the reminder), not_here (a test shop, a shop not in the public search, nothing still on her menu, or it could not be checked: offer nothing).
readyno_open_dropnot_hereshow "reminders" only: her drop reminders. Empty: none.
drops: when the shop opens any drop (her list). drop: one drop she asked about.
dropsdropdrop: the drop she asked about.
The page her reminder messages link to for stopping them: it asks before it stops anything. Null: none to open.
show "new" only: new items and drops at her shops, newest first. Empty: none.
itemdropAs her shop prices it: "£4", or "From £4". Null when it has no single price.
Its own page on Membber.
show "year" only: her and the shop. Null: fewer than 3 paid orders there.
The month of her first paid order at the shop.
The day of her first paid order at the shop, so the card says "4 orders since 12 Oct", never a month alone.
Her paid orders at the shop since then: always the true count, from one.
Free rewards she has had there (her redeemed rewards, on two keys). Null: none, or not provably hers.
The shop's own name for that reward ("Free cookie"), only when it reads as one and she has had one. Null otherwise.
The weekday she most often orders on (0 Sunday). Null: no clear one.
show "account" only: who is connected and whose shops this app can see.
Her proved email, masked: its first letters, then •••, then the domain.
show "all" only: every stamp card she holds, ready rewards first, then her latest visit. Empty: none yet.
The photo of the item her reward names, when it names one of the shop's items with a photo.
Her card colour, as her Wallet card's.
The published picture her stamps sit on, through Membber's media address.
Her filled stamp. Null: the plain tick.
Her empty stamp, as the app draws an empty place. Absent or null: her filled stamp, faded.
Her card's own name, drawn in place of the shop name. Absent: the shop name.
show "earn" only: how a stamp is earned at this shop, in its own settings' words. Null: it runs no stamp card.
curl -G "https://www.membber.com/api/v1/shopper/yours" \
-H "Authorization: Bearer $MEMBBER_TOKEN" \
--data-urlencode "what=<what>"import { createMembberClient } from "@membber/sdk-ts";
const membber = createMembberClient({
getAccessToken: () => process.env.MEMBBER_TOKEN,
});
const { data, error } = await membber.raw.GET("/api/v1/shopper/yours", {
params: { query: { what: "<what>" } },
});
if (error) {
// Typed error envelope: { error: { code, message, requestId } }
throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);import MembberSwift
let client = MembberClient(
serverURL: MembberClient.productionServerURL,
tokenProvider: { session.accessToken }
)
let response = try await client.api.getYours(
query: .init(what: "<what>")
).ok.body.json
print(response){
"contract_version": "<contract_version>",
"show": "stamps",
"result_status": "yours",
"summary": "<summary>",
"shop": {
"business_id": "490799fa-0000-4000-8000-d0c500000049",
"name": "Example name",
"kind": "<kind>",
"url": "https://example.com/image.jpg"
},
"stamps": {
"count": 1,
"goal": 1,
"reward": "<reward>",
"reward_photo": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"photos": [
{
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
}
]
},
"last_box": {
"placed_on": "<placed_on>",
"item_count": 1,
"total": {
"pence": 0,
"display": "<display>"
},
"lines": [
{
"offering_id": "3b791bf4-0000-4000-8000-d0c50000003b",
"title": "Morning class",
"quantity": 1,
"photo": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
}
}
]
},
"card": {
"colour": "<colour>",
"picture": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"logo": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"stamp_icon": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"stamp_icon_empty": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"name": "Example name"
},
"other_shops": [
{
"business_id": "490799fa-0000-4000-8000-d0c500000049",
"name": "Example name"
}
],
"same_again": "ready",
"reminders": [
{
"business_id": "490799fa-0000-4000-8000-d0c500000049",
"name": "Example name",
"colour": "<colour>",
"logo": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"what": "drops",
"drop_name": "<drop_name>",
"stop_url": "https://example.com/image.jpg"
}
],
"new_things": [
{
"business_id": "490799fa-0000-4000-8000-d0c500000049",
"name": "Example name",
"colour": "<colour>",
"logo": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"kind": "item",
"title": "Morning class",
"price": "<price>",
"photo": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"url": "https://example.com/image.jpg",
"added_on": "<added_on>"
}
],
"year": {
"since": "<since>",
"first_on": "<first_on>",
"orders": 1,
"favourite": {
"title": "Morning class",
"times": 2,
"photo": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
}
},
"rewards_had": 1,
"reward_name": "<reward_name>",
"usual_day": 0
},
"account": {
"email": "alex@example.com",
"shops": [
{
"business_id": "490799fa-0000-4000-8000-d0c500000049",
"name": "Example name"
}
],
"more_shops": 0
},
"cards": [
{
"business_id": "490799fa-0000-4000-8000-d0c500000049",
"name": "Example name",
"url": "https://example.com/image.jpg",
"count": 1,
"goal": 1,
"reward": "<reward>",
"reward_photo": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"card": {
"colour": "<colour>",
"picture": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"logo": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"stamp_icon": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"stamp_icon_empty": {
"url": "https://example.com/image.jpg",
"large": "<large>",
"alt": "<alt>"
},
"name": "Example name"
}
}
],
"earn": "<earn>"
}