TABLE OF CONTENTS

• Integration Scope & Prerequisites
  • Active Buyer Endpoints
  • Integration Prerequisites
• Supported Event Types
• Webhook Management APIs
  • Create Webhook Configuration (createWebhook)
    • Request Body
  • Request Payload Example
    • Response
  • Response Payload Example
  • Update Webhook Configuration (updateWebhook)
    • Request Body
  • Request Payload Example
    • Response
  • Response Payload Example
    • Error Codes

Flight GDN Seller API v2.0 introduces real-time Webhook Notifications to push critical post-booking flight and order event updates directly to downstream buyer endpoints. This event-driven architecture eliminates the need for frequent orderRetrieve polling, optimizing network overhead and processing latency.

When order servicing events occur, GDN automatically pushes real-time event notification payloads to the callbackUrl configured by the Buyer.

Integration Scope & Prerequisites

Active Buyer Endpoints

Buyers only need to invoke two management APIs to control subscriptions:

• POST /api/webhook/createWebhook: Creates a new Webhook subscription configuration.
• POST /api/webhook/updateWebhook: Updates an existing Webhook subscription configuration.

Integration Prerequisites

Downstream Buyers must prepare the following before setup:

1. Public HTTPS Callback URL: Provide an accessible HTTPS endpoint (callbackUrl).
2. Request Handler: Endpoint must accept HTTP POST application/json requests.
3. Idempotency Logic: Endpoint must implement duplicate check logic based on the eventId in the push payload.
4. Secret Key Storage: Securely store the webhookId and secret returned during initial creation.

Important Operational Notes:
• One-Time Secret Exposure: The secret is returned in plain text ONLY ONCEupon successful invocation of createWebhook. It will NOT be returned in plain text in subsequent query or update requests.
• Environment Handling: The environment is automatically detected by the GDN server context and should NOT be passed in requests.
• Single Subscription Policy: Only ONE active Webhook configuration is allowed per Buyer account per environment.

Supported Event Types

The event array defines the subscription targets. The allowed event enumeration includes:

Webhook Management APIs

Create Webhook Configuration (createWebhook)

Creates a new webhook endpoint configuration for the current Seller in the current environment.

Request Body

{
   "callbackUrl": "https://procurement.example.com/gdn/webhook",
   "apiVersion": "1.0",
   "timeStamp": "1713607500123",
   "events": [
       "ticketing.result",
       "refund.result"
   ]
}

Response

{


       "webhookId": "whk_202604200001",
       "callbackUrl": "https://procurement.example.com/gdn/webhook",
       "events": [
           "ticketing.result",
           "refund.result"
       ],
       "environment": "test",
       "active": true,
       "secret": "generated-secret-value",
       "createdAt": "2026-04-20T10:00:00Z",
       "updatedAt": "2026-04-20T10:00:00Z",
       "timeStamp": "1713607500123"
}

Update Webhook Configuration (updateWebhook)

Updates the subscribed event list for an existing webhook configuration without re-creating the webhook or changing the secret.

Request Body

{
   "webhookId": "whk_202604200001",
   "apiVersion": "1.0",
   "timeStamp": "1713607800123",
   "events": [
       "ticketing.result",
       "refund.result",
       "flightTimeChange.result"
   ]
}

Response

{
       "webhookId": "whk_202604200001",
       "callbackUrl": "https://procurement.example.com/gdn/webhook",
       "events": [
           "ticketing.result",
           "refund.result",
           "flightTimeChange.result"
       ],
       "environment": "test",
       "active": true,
       "secret": null,
       "createdAt": "2026-04-20T10:00:00Z",
       "updatedAt": "2026-04-20T10:05:00Z",
       "timeStamp": "1713607800123"
}

Error Codes