# Verifying API booking flow with member discount via promo code
**URL:** https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763
**Category:** API General
**Created:** [May 7, 2026, 1:35pm UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763 "2026-05-07T13:35:18Z")
**Posts on this page:** 17
**Page:** 1
### Author:  [@thijmo](https://tech-support.simplybook.me/u/thijmo)
#### Post date: [May 7, 2026, 1:35pm UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/1 "2026-05-07T13:35:18Z")
Hi,
Before deciding on an implementation, I’d like to verify whether the following flow is feasible with your API. Could you confirm the points below?
**Goal:** We want to offer our members a discount when they book via our own custom booking page (built on top of your API). We want to keep a single booking flow for everyone — so instead of separate booking options for members vs non-members, our backend should detect whether the person booking is a member and automatically apply the discount if so. The discount should also work when a member books for a group (member + guests). Before we start building, I’d like to verify whether the flow below is feasible.
**The flow I have in mind:**
1. A client enters their email on our booking page
2. Our backend checks via the admin API (`getClientList` + `getClientMembershipList`) whether the email belongs to a client with an active membership
3. If yes, we call `book()` with a promo code passed as an additional field, e.g. `{ "name": "promocode", "value": "MEMBER5", "type": "text" }`
4. The promo code is configured in SimplyBook to give a fixed-amount discount (e.g. €5 off)
**My questions:**
1. Is passing a promo code as an additional field in the `book()` call the correct approach, and will the configured discount be applied automatically?
2. When `count` is greater than 1 (group booking), is the fixed-amount discount applied once to the total, or per person?
3. When making multiple `book()` calls in sequence (e.g. via `createBatch`), are the slots held between calls, or could another client book the same slot in between?
I’m not building anything yet — just trying to confirm the approach is viable before moving forward.
Thanks in advance,
Thymo
---
### Author:  [@mib](https://tech-support.simplybook.me/u/mib)
#### Post date: [May 7, 2026, 1:48pm UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/2 "2026-05-07T13:48:34Z")
---
### Author:  [@val\_komarov](https://tech-support.simplybook.me/u/val_komarov)
#### Post date: [May 7, 2026, 2:53pm UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/3 "2026-05-07T14:53:22Z")
Hi Thymo,
1. Passing a promo code as an additional field in the booking request is not the right approach — additional fields are custom client-facing form fields (name, phone, notes, etc.) and are not wired to the discount engine.
The correct flow is a two-step process:
- create a booking
- apply the promo code to the invoice that was created for the booking internally
1. The discount is applied **once to the invoice total** , not per person. A promo code adds a single discount line to the invoice regardless of the participant count, so a €5 fixed discount means €5 off the whole order, not €5 × participants.
2. If you are creating several bookings within a batch, they hold the time slots until they are canceled by a timeout, in case you don’t confirm them
---
### Author:  [@val\_komarov](https://tech-support.simplybook.me/u/val_komarov)
#### Post date: [May 7, 2026, 2:57pm UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/4 "2026-05-07T14:57:29Z")
By the way, pay attention you can not combine group bookings with multiple bookings: if you create a multiple booking batch, each booking will have to serve only 1 client
---
### Author:  [@thijmo](https://tech-support.simplybook.me/u/thijmo)
#### Post date: [May 8, 2026, 8:36am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/5 "2026-05-08T08:36:21Z")
Thanks for clarifying.
Two follow-up questions:
**1. Single record for group bookings**
For our use case, we’d like a group booking (member + guests, e.g. 4 participants total) to appear in the backend as a **single record** — so that rescheduling moves all participants to the new time slot in one action, and cancelling cancels the entire group at once.
Is this achievable by using `book()` with `count > 1` (instead of a batch), so the group is stored as one booking with multiple seats? And does `editBook` / `rescheduleBook` then operate on the whole group as one unit?
**2. Refunds via API**
Your documentation mentions that refunds can be issued via SBPay .me or the payment processor’s admin panel. For our integration we’d like to know:
- Is there an API method to trigger a refund (full or partial) through SBPay .me PRO or the connected payment processor?
- Or does it really have to be done manually through the admin interface — meaning we’d need to integrate directly with the payment processor (e.g. Stripe API) ourselves to automate refunds?
Thanks!
---
### Author:  [@dmytro\_bondarev](https://tech-support.simplybook.me/u/dmytro_bondarev)
#### Post date: [May 11, 2026, 9:55am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/6 "2026-05-11T09:55:41Z")
Hi Thymo,
Yes we do have such API, please have a look: [SBPay.me - Single place for all payment processors](https://app.sbpay.me/en/api-documentation#post_/api/order/%7Bid%7D/refund)
Note it requires SBPay API keys.
---
### Author:  [@val\_komarov](https://tech-support.simplybook.me/u/val_komarov)
#### Post date: [May 11, 2026, 9:57am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/7 "2026-05-11T09:57:46Z")
About group bookings, you get N separate booking records, which can be canceled one by one or together, but 1 invoice with 1 record in it for all bookings in group. Client rescheduling is not available for group bookings, but admin can modify them one by one
---
### Author:  [@thijmo](https://tech-support.simplybook.me/u/thijmo)
#### Post date: [May 11, 2026, 11:23am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/8 "2026-05-11T11:23:53Z")
**Client rescheduling is not available for group bookings, but admin can modify them one by one**
I see — but this isn’t workable for us. Is there a workaround? It’s essential that clients can modify their group bookings. Would it perhaps be possible to create a group as a batch booking, so that each individual booking within it can be changed separately?
And is it possible to change a location when you reschedule your booking?
---
### Author:  [@val\_komarov](https://tech-support.simplybook.me/u/val_komarov)
#### Post date: [May 11, 2026, 12:15pm UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/9 "2026-05-11T12:15:05Z")
You can implement it via admin API instead of client one, if you control all the process. In this case you can change both time and location for individual bookings
---
### Author:  [@thijmo](https://tech-support.simplybook.me/u/thijmo)
#### Post date: [June 11, 2026, 7:48am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/10 "2026-06-11T07:48:50Z")
My voucher code workaround is working, but the code doesn’t seem to stay valid forever. It seems to work only 5 times?
---
### Author:  [@val\_komarov](https://tech-support.simplybook.me/u/val_komarov)
#### Post date: [June 17, 2026, 2:48pm UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/11 "2026-06-17T14:48:17Z")
This can be set up via admin interface; parameter is called “allow\_usage\_count” (can be 0 for infinite usage)
---
### Author:  [@thijmo](https://tech-support.simplybook.me/u/thijmo)
#### Post date: [June 19, 2026, 8:03am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/12 "2026-06-19T08:03:54Z")
Ok thats where you set Coupons & Gift Cards? I only see this options with percentage not with fixed amount. Is this not possible with fixed amount?
---
### Author:  [@val\_komarov](https://tech-support.simplybook.me/u/val_komarov)
#### Post date: [June 19, 2026, 8:55am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/13 "2026-06-19T08:55:12Z")
This looks like a bug. System allows to create a percentage coupon with limited number of uses, and then change it to a fixed amount one, but number of uses remains from what was set on the previous step.
---
### Author:  [@thijmo](https://tech-support.simplybook.me/u/thijmo)
#### Post date: [June 19, 2026, 10:30am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/14 "2026-06-19T10:30:01Z")
I tested this by creating a coupon based on percentage with unlimited claims. After saving I changed it into the fixed price option. As a fixed price coupon it was still usable once.
---
### Author:  [@val\_komarov](https://tech-support.simplybook.me/u/val_komarov)
#### Post date: [June 19, 2026, 10:32am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/15 "2026-06-19T10:32:40Z")
You should not be able to change coupon settings after it was used at least once; otherwise it’s ok - but I will make the limitation to be removed when the type is changed
---
### Author:  [@thijmo](https://tech-support.simplybook.me/u/thijmo)
#### Post date: [June 24, 2026, 7:31am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/16 "2026-06-24T07:31:44Z")
Thanks I will test this.
Other question:
Is there a way to temporarily hold/reserve a time slot so that no one else can book it while a customer is filling in their details and going to the payment page — without having to create a full confirmed booking first?
---
### Author:  [@val\_komarov](https://tech-support.simplybook.me/u/val_komarov)
#### Post date: [June 24, 2026, 7:40am UTC](https://tech-support.simplybook.me/t/verifying-api-booking-flow-with-member-discount-via-promo-code/1763/17 "2026-06-24T07:40:46Z")
The flow you are describing does not exist exactly, but the slot will be locked as soon as you create the booking even if payment is not made yet. If you create your custom solution via API, you can try some workarounds, like create a booking with anonymous client first and then change it etc.