gdex-retailer-onboarding · git:20260521.958306f · 2026-05-21 · sha256 7ce3f58f55ea7854

gdex-retailer-onboarding git:20260521.958306fA

Immutable. This exact content never changes and is served at /api/v1/blob/7ce3f58f55ea7854.

---
name: gdex-retailer-onboarding
description: Retailer partner integrations — list branded onboarding partners that white-label the GDEX trading stack
---

# GDEX: Retailer Onboarding

Inspect the list of registered retailer partners — third-party brands that
white-label the GDEX trading stack and have their own branded onboarding
experience.

## When to Use

- Building a partner-aware onboarding flow that routes users to their
  retailer's branded sign-up
- Surfacing partner branding (logo, theme, name) at the application level

## Prerequisites

- `@gdexsdk/gdex-skill` installed
- No authentication required (public retailer registry)

## Backend Endpoints

| Method | Path | Purpose |
|--------|------|---------|
| `GET`  | `/v1/retailer` | List registered retailer integrations |

## SDK Usage

```typescript
import { GdexSkill } from '@gdexsdk/gdex-skill';

const skill = new GdexSkill();
const retailers = await skill.getRetailers();
// Optionally filter by retailer slug / identifier:
const single = await skill.getRetailers({ retailer: 'partner-slug' });
```

## Notes

- The retailer registry is the source of truth for the partner-onboarding
  routing layer — clients should treat it as authoritative.
- Per-retailer schema (logo, theme, redirect URLs) is determined by the
  backend deployment.