B Bookare Helpbookare.app →

Developers · Guides

Taking payments from your own app

How payments work with the API: online card payments through the venue’s own provider, IRIS, and paying at the venue.

Bookare never holds money. Each venue connects its own payment provider (Stripe, Viva or Cardlink) in its settings; online card payments go straight to the venue, without commission from Bookare.

Packs (gyms and studios)

  1. POST /me/packs { "pack_id", "method" }. method must be one of payment_methods from GET /me/packs/available.
  2. Depending on the method:
    • card → POST /me/packs/{id}/checkout → { "type": "redirect", "url" } or { "type": "form", "action", "fields" }. Open the URL, or post a form with fields to action (in a browser or a web view). The customer pays on the provider’s page and returns to the venue’s account page.
    • iris → the answer of step 1 has iris.number, iris.payee, iris.reference and iris.amount_eur. The customer sends the money from their bank app with the reference; the venue marks it paid.
    • cash → paid at the desk; the venue marks it paid.
  3. GET /me/packs shows paid: true once it is paid. A pack that costs nothing after a coupon is paid straight away.

Until a pack is paid, members can book as many classes on it as the venue allows (its booking rules, or more if the venue allowed this member to pay later).

Stays and appointments

Guests pay from the manage_url link in their confirmation email, where the venue takes cards. The API answer of the booking gives you the same manage_url, so you can send them there straight away.

From the venue’s side

  • GET /admin/unpaid: unpaid packs.
  • PUT /admin/member-packs/{id}/paid { "paid": true, "method": "cash" }: mark a pack paid.
  • GET /admin/sales?from&to: what was paid, by method and by pack.