Skip to main content
This guide walks you through your first call to the Gift Shop API. You will authenticate with your API key, open a session with the Create a new session endpoint, and use the returned identifier for the rest of the journey.

Prerequisites

Get the following from D-EDGE before starting:
  • API key: sent in the X-API-KEY header on every request.
  • API base URL: the base URL for your environment.
  • Hotel or group identifiers: the gift shop owner you integrate against.
All are delivered during the build step of your integration journey, after the partnership agreement.
1

Create a session

Send a POST to the Create a new session endpoint with the gift shop owner. Replace the identifiers with the ones delivered by D-EDGE. The full field requirements are documented in the Reference.
2

Use the session

A successful response returns the session identifier:
Carry that identifier in the path of every following call, for example to read the shop’s configuration:
From here, follow the journey: browse the catalogue, build the cart, and confirm it for payment. Each stage is documented in the Reference.

Common issues

Next steps

Reference

Every endpoint, grouped by stage of the journey.

Guidelines

Authentication, request conventions, and response formats.

Best practices

Patterns to run the shop reliably, from caching to session recovery.