Globagift Docs
Merchant GuidesWebshop & Integrations

Custom integration

Build a bespoke integration using the Globagift API and embed snippets.

If your storefront isn't on Shopify, WooCommerce, or Magento, or you want more control than a plugin gives you, there are two ways to integrate Globagift gift cards directly.

Embed snippet (no backend code required)

The fastest path: generate an embed snippet from Webshop & Integrations in the dashboard and paste it into your site. Two styles are available:

  • Inline embed: an iframe that renders the gift card module directly on a page.
  • Pop-up button: a floating launcher that opens the gift card module in a pop-up.

Checkout happens inside Globagift's own checkout either way, so there's no payment integration to build. This is the right choice if you just need "sell gift cards on my site" without building anything custom around it.

Direct API integration

If you need to drive your own UI, for example showing gift card products inside an existing storefront page rather than via the embed, build against the public, unauthenticated storefront endpoints:

These are the same endpoints the hosted webshop itself uses, so the data you get back is exactly what a customer would see on webshop.globagift.io.

Read-only catalog data, not a checkout API

These endpoints return product data for display. They do not let you create an order or issue a card directly; for that, customers still need to complete checkout through Globagift's own flow (the embed, or the hosted webshop URL), not a custom checkout you build yourself.

When to build custom

Build a custom integration rather than using a Shopify/WooCommerce/Magento plugin when:

  • Your storefront runs on a platform without a Globagift plugin.
  • You want to surface gift card products inside your own UI rather than an embedded widget.
  • You're integrating gift cards into something other than a typical storefront (an app, a kiosk, or another internal tool).

For in-store, point-of-sale issuance and redemption rather than an online storefront, see POS and its API reference instead, that's a separate, authenticated surface from the public storefront endpoints above.

Where to start

  1. Read Authentication to understand how the authenticated (merchant-session) and public (storefront) surfaces differ.
  2. Browse the API reference for the full set of documented endpoints.
  3. If you only need to sell gift cards online, start with the embed snippet before reaching for the API directly, it covers most cases with no backend work.

On this page