Occasion landing page

Gift voucher sales cluster around occasions: Christmas, Valentine’s Day, and Mother’s Day. A landing page dedicated to the occasion converts that intent far better than a generic shop. And because the voucher arrives by email minutes after payment, the campaign keeps selling until the day itself.

How it works

The catalogue is organised in categories, translated to the session’s culture. Read them with Get all categories, pick the one that matches the occasion, and build the landing page on the matching slice of the catalogue. Search active products returns the full active catalogue; each product carries its category, so the occasion filter is yours to apply.

The examples send the X-API-KEY header introduced in the Quick start. Replace {sessionId} with your session.

curl --request GET \
  --url 'https://{apiBaseUrl}/v1/{sessionId}/categories' \
  --header 'X-API-KEY: YOUR_API_KEY'

{
  "categories": [
    { "id": 70001, "name": "Online" },
    { "id": 70002, "name": "At the hotel" }
  ]
}

Build the occasion page

Fetch the catalogue and keep the products of the occasion’s category:

curl --request POST \
  --url 'https://{apiBaseUrl}/v1/{sessionId}/products/search' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{}'

const response = await fetch("https://{apiBaseUrl}/v1/{sessionId}/products/search", {
  method: "POST",
  headers: {
    "X-API-KEY": process.env.DEDGE_API_KEY,
    "Content-Type": "application/json",
  },
  body: "{}",
});

const { products } = await response.json();
const occasion = products
  .filter((p) => p.category?.id === OCCASION_CATEGORY_ID)
  .sort((a, b) => amountOf(a) - amountOf(b));

import os
import requests

response = requests.post(
    "https://{apiBaseUrl}/v1/{sessionId}/products/search",
    headers={"X-API-KEY": os.environ["DEDGE_API_KEY"]},
    json={},
)

products = response.json()["products"]
occasion = sorted(
    (p for p in products if p.get("category", {}).get("id") == OCCASION_CATEGORY_ID),
    key=amount_of,
)

$response = $client->post('v1/{sessionId}/products/search', [
    'headers' => ['X-API-KEY' => getenv('DEDGE_API_KEY')],
    'json'    => new stdClass(),
]);

$products = json_decode($response->getBody(), true)['products'];
$occasion = array_filter($products, fn ($p) =>
    ($p['category']['id'] ?? null) === OCCASION_CATEGORY_ID);

var response = await client.PostAsJsonAsync(
    "/v1/{sessionId}/products/search", new { });

var catalogue = JsonDocument.Parse(
    await response.Content.ReadAsStringAsync()).RootElement;
var occasion = catalogue.GetProperty("products").EnumerateArray()
    .Where(p => p.GetProperty("category").GetProperty("id").GetInt32() == OccasionCategoryId);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://{apiBaseUrl}/v1/{sessionId}/products/search"))
    .header("X-API-KEY", System.getenv("DEDGE_API_KEY"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{}"))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
JsonNode products = mapper.readTree(response.body()).path("products");

Sorting is yours too: the search returns the whole active catalogue in one call, so order the page by ascending price, best sellers, or whatever fits the campaign.

Make it feel like a gift

Pre-fill the gift options for the occasion when the guest adds to the cart: a suggested personal message (“Happy Mother’s Day!”) in comment and the beneficiary’s email for direct delivery. On Indirect products, set hidePrice on by default (a Direct voucher always shows its value). The full options are covered in Voucher for a friend.

Tips

One page per occasion. A stable URL per occasion (/gifts/mothers-day) builds search ranking year after year, and gives ads and emails a precise destination.
Say that delivery is instant. Late buyers are a large share of gift traffic; “delivered by email in minutes” removes their last objection.
Show the validity. Each product carries its validity period (365.00:00:00 is one year); displaying “valid one year” reassures buyers that the beneficiary has time.

Get all categories

The catalogue’s categories, in the session’s culture.

Add a cart item

The cart call that carries the gift options.

Get started

Build

Resources

Occasion landing page

How it works

Build the occasion page

Make it feel like a gift

Tips

Get all categories

Add a cart item

​How it works

​Build the occasion page

​Make it feel like a gift

​Tips

​Related

Get all categories

Add a cart item

How it works

Build the occasion page

Make it feel like a gift

Tips

Related