Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nuwebgroup.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Basket links allow external systems to build a shopping basket through the API and generate a secure URL that takes a customer directly into the ticket shop with items already reserved. When the customer clicks the link, the basket is loaded into their session and they can proceed straight to checkout. This is useful for:
  • Third-party booking platforms that handle event selection but need to hand off to the ticket shop for payment
  • Marketing campaigns with pre-configured item selections
  • Custom integrations that build baskets programmatically
Basket links requires a feature flag to be activated for your company. Contact your account manager to request access.

​
How It Works

​
1. Create a Basket via the API

An external system calls the API to add items to a basket, including the generateBasketUrl parameter set to true. The API response includes a startBasketUrl field — a cryptographically signed URL pointing to the ticket shop. The API request can also include optional redirect URLs:
  • Success redirect URL — where the customer is sent after completing checkout (receives order_id and customer_id as query parameters)
  • Failure redirect URL — where the customer is sent if payment fails (receives basket_id and customer_id as query parameters)
When a customer clicks the basket link:
  1. The system validates the signed URL and checks the basket is still active and not expired
  2. If the basket belongs to a registered customer, they are automatically logged in
  3. Any other active baskets the customer has are expired
  4. The pre-built basket is loaded into the customer’s session
  5. The customer is redirected to the basket page with all items ready

​
3. Customer Completes Checkout

From this point, the experience is identical to a normal purchase. The customer can:
  • Review the items in their basket
  • Apply discount codes or access codes
  • Add or remove items (unless the API request flagged items as non-modifiable)
  • Proceed through checkout and payment
After payment, the customer is redirected to either the success page in the ticket shop or the external success redirect URL if one was configured.

​
Security

Basket links use Laravel’s signed URL mechanism:
  • Each link contains a cryptographic signature that prevents tampering
  • Links are validated before any basket data is accessed
  • If a logged-in user tries to access a basket belonging to a different user, they are redirected with an error
  • The internal confirmation step uses a 1-minute time-limited signature for additional security

​
Restrictions

  • One purchase per link — once a basket is activated and the order completes, the link cannot be reused
  • Expiry — if the basket expires (based on the configured basket timeout), the link becomes invalid
  • Event cancellations — if any items in the basket are for a cancelled event, the link returns an error
  • Customer context only — basket links are for customer use; they cannot be activated in box office mode

API Reference

Create baskets programmatically using the API.

Checkout

The checkout flow customers complete after clicking a basket link.

Basket

How the basket works, including timeouts and item management.