From 6d55ff9266c378cd971b46058e10a9878b991880 Mon Sep 17 00:00:00 2001 From: navin10sharma <3096611+navin10sharma@users.noreply.github.com> Date: Tue, 25 Aug 2026 11:26:36 +0530 Subject: [PATCH] docs: refresh README, FAQ, package metadata, and repo social preview --- .github/social-preview.png | Bin 0 -> 65768 bytes README.md | 67 ++++++++++++++++++++++++++++++++----- composer.json | 2 +- 3 files changed, 59 insertions(+), 10 deletions(-) create mode 100644 .github/social-preview.png diff --git a/.github/social-preview.png b/.github/social-preview.png new file mode 100644 index 0000000000000000000000000000000000000000..cb9642a2d6ca28cdabcfbffecc94c1fe4dd646a9 GIT binary patch literal 65768 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 **Server-side only.** This package authenticates with your secret key. Never expose it to a > browser or anything a ticket buyer can reach — browser surfaces get short-lived, origin-bound @@ -299,6 +308,46 @@ suite runs without a network. Full reference: [docs.seatlayer.io/server-sdk](https://docs.seatlayer.io/server-sdk/install/) +## Frequently asked questions + +### How do I book seats from PHP? + +Create a client with your secret key, obtain a hold id — either from the buyer's +browser session or by holding server-side — and call `$seatlayer->inventory->book($eventKey, holdId: ..., bookingRef: ...)`. +`bookingRef` is your own stable order id and is the join between SeatLayer +inventory and your commercial order, so the same reference identifies the booking +in Booking History and when you later cancel it. For phone orders, box office, and +comps, `$seatlayer->inventory->bookBestAvailable(...)` books outright with no browser involved. + +### What does the server SDK do compared with the buyer SDK? + +The buyer SDK runs where the ticket buyer is: it renders the interactive seating +chart, handles seat selection, and creates temporary holds. This server SDK is the +trusted side. It authenticates with your secret key, inspects what a hold actually +contains, prices from server-owned data, and books. Never bundle the secret key +into a browser or a mobile app — browser surfaces get short-lived, origin-bound +tokens that you mint here. + +### How do temporary holds work server-side? + +A hold reserves seats against concurrent buyers for a limited window. +`$seatlayer->inventory->retrieveHold($eventKey, $holdId)` is the authoritative answer for what is held +and at what price, so charge from its `items` rather than from anything the browser +sent you. When an order runs longer than the checkout window, `$seatlayer->inventory->extendHold(...)` +renews the hold instead of releasing and re-holding, which would hand the seats to +whoever is racing for them. Bookings carry the server's exact-selection plus +`bookingRef` safeguard, but the SDK sends each booking once — reconcile an unknown +outcome before trying again. + +### Can I use my own payment provider? + +Yes. SeatLayer never processes payment. Inspect the hold, compute the charge from +the returned `items` and their authoritative `unitPrice` and `currency`, take the +money through whichever provider you already use — Stripe, Adyen, Razorpay, or your +own — and then book the hold with your order id as `bookingRef`. SeatLayer owns +seating state, holds, booking concurrency, and the inventory ledger; your platform +owns payments, commercial orders, tickets, delivery, and refunds. + ## Related resources - [Server SDK guide](https://docs.seatlayer.io/server-sdk/install/) @@ -311,21 +360,21 @@ Full reference: [docs.seatlayer.io/server-sdk](https://docs.seatlayer.io/server- ### Other SeatLayer SDKs -| Surface | Package | -|---|---| -| Browser (vanilla) | [`@seatlayer/js`](https://www.npmjs.com/package/@seatlayer/js) | +| Surface | Package or source | +| --- | --- | +| JavaScript | [`@seatlayer/js`](https://www.npmjs.com/package/@seatlayer/js) | | React | [`@seatlayer/react`](https://www.npmjs.com/package/@seatlayer/react) | | React Native | [`@seatlayer/react-native`](https://www.npmjs.com/package/@seatlayer/react-native) | | iOS | [`seatlayer-ios`](https://github.com/seatlayer/seatlayer-ios) | -| Android | [`seatlayer-android`](https://github.com/seatlayer/seatlayer-android) | | Flutter | [`seatlayer`](https://pub.dev/packages/seatlayer) | +| Android | [`seatlayer-android`](https://github.com/seatlayer/seatlayer-android) | | Node.js (server) | [`@seatlayer/server`](https://www.npmjs.com/package/@seatlayer/server) | | Python (server) | [`seatlayer`](https://pypi.org/project/seatlayer/) | -| Java (server) | [`io.seatlayer:seatlayer-java`](https://central.sonatype.com/artifact/io.seatlayer/seatlayer-java) | -| Go (server) | [`github.com/seatlayer/seatlayer-go`](https://pkg.go.dev/github.com/seatlayer/seatlayer-go) | +| PHP (server) | [`seatlayer/seatlayer-php`](https://packagist.org/packages/seatlayer/seatlayer-php) (this package) | | Ruby (server) | [`seatlayer`](https://rubygems.org/gems/seatlayer) | -| PHP (server) | [`seatlayer/seatlayer-php`](https://packagist.org/packages/seatlayer/seatlayer-php) | | .NET (server) | [`SeatLayer`](https://www.nuget.org/packages/SeatLayer) | +| Java (server) | [`io.seatlayer:seatlayer-java`](https://central.sonatype.com/artifact/io.seatlayer/seatlayer-java) | +| Go (server) | [`github.com/seatlayer/seatlayer-go`](https://pkg.go.dev/github.com/seatlayer/seatlayer-go) | ## Development diff --git a/composer.json b/composer.json index 175973f..625fcd5 100644 --- a/composer.json +++ b/composer.json @@ -4,7 +4,7 @@ "type": "library", "license": "MIT", "homepage": "https://seatlayer.io/", - "keywords": ["seatlayer", "reserved-seating", "seating-chart", "ticketing", "box-office"], + "keywords": ["seatlayer", "seating-chart", "seat-map", "reserved-seating", "seat-booking", "ticketing", "event-ticketing", "box-office", "server-sdk", "php"], "authors": [ { "name": "SeatLayer",