---
title: "private-giftcodes.{userId}"
url: https://lumean.app/de/developers/docs/realtime/giftcodes
locale: de
description: "Gift codes and reseller status of the key owner: a batch issued, a code changing status, the reseller status and the reseller application changing. Events never carry code values, only masks; the full code comes from `GET /reseller/codes` and `GET /reseller/codes/{uuid}`. Key permission: `reseller.read`."
generated: 2026-10-17
scopes: [reseller.read]
spec_version: 0.0.1
---

# private-giftcodes.{userId}

Gift codes and reseller status of the key owner: a batch issued, a code changing status, the reseller status and the reseller application changing. Events never carry code values, only masks; the full code comes from `GET /reseller/codes` and `GET /reseller/codes/{uuid}`. Key permission: `reseller.read`.

- Benötigtes Recht: `reseller.read`

## Kanalparameter

| Feld | Typ | Beschreibung | Beispiel |
| --- | --- | --- | --- |
| `userId` | `integer` | is the numeric id of the key owner, returned by `GET /user`. | `7` |

## Events

### `.status.changed` — Status changed

A gift code changed status.

**Payload**

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `gift_code` | `object` | Pflicht |  |
| `gift_code.uuid` | `string` | Pflicht |  |
| `gift_code.code_masked` | `string` | Pflicht |  |
| `gift_code.nominal` | `integer` | Pflicht |  |
| `gift_code.nominal_formatted` | `number` | Pflicht |  |
| `gift_code.source` | `string` — `purchase` · `reseller` | Pflicht |  |
| `gift_code.funding` | `string` — `rub` · `crypto` · `mixed` | Pflicht |  |
| `gift_code.status` | `string` — `active` · `refunding` · `redeemed` · `refunded` · `cancelled` · `annulled` | Pflicht |  |
| `gift_code.activatable_at` | `string` | Pflicht |  |
| `gift_code.redeemed_at` | `string (date-time) \| null` | Pflicht |  |
| `gift_code.cancelled_at` | `string (date-time) \| null` | Pflicht |  |
| `gift_code.created_at` | `string` | Pflicht |  |
| `gift_code.currency_asset` | `object` | Pflicht |  |
| `gift_code.currency_asset.code` | `string` | Pflicht |  |
| `gift_code.currency_asset.precision` | `integer` | Pflicht |  |

### `.issued` — Issued

A batch of gift codes was issued: the batch summary, without code values.

**Payload**

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `batch` | `object` | Pflicht |  |
| `batch.uuid` | `string` | Pflicht |  |
| `batch.source` | `string` — `purchase` · `reseller` | Pflicht |  |
| `batch.codes_count` | `integer` | Pflicht |  |
| `batch.nominal_total` | `integer` | Pflicht |  |
| `batch.nominal_total_formatted` | `number` | Pflicht |  |
| `batch.created_at` | `string` | Pflicht |  |
| `batch.currency_asset` | `object` | Pflicht |  |
| `batch.currency_asset.code` | `string` | Pflicht |  |
| `batch.currency_asset.precision` | `integer` | Pflicht |  |

### `.reseller.application.status.changed` — Reseller application status changed

The status of the reseller application changed.

**Payload**

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `application` | `object` | Pflicht |  |
| `application.id` | `integer` | Pflicht |  |
| `application.status` | `string` — `pending` · `approved` · `rejected` · `withdrawn` | Pflicht |  |
| `application.admin_comment` | `string \| null` | Pflicht |  |
| `application.reviewed_at` | `string (date-time) \| null` | Pflicht |  |
| `application.created_at` | `string` | Pflicht |  |

### `.reseller.status.changed` — Reseller status changed

The reseller status changed.

**Payload**

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `reseller` | `object` | Pflicht |  |
| `reseller.id` | `integer` | Pflicht |  |
| `reseller.status` | `string` — `active` · `blocked` · `revoked` | Pflicht |  |
| `reseller.discount_bps` | `integer` | Pflicht |  |
| `reseller.blocked_reason` | `string \| null` | Pflicht |  |
| `reseller.approved_at` | `string` | Pflicht |  |
| `reseller.currency_asset` | `object` | Pflicht |  |
| `reseller.currency_asset.code` | `string` | Pflicht |  |
| `reseller.currency_asset.precision` | `integer` | Pflicht |  |

---

- Diese Seite im Browser: https://lumean.app/de/developers/docs/realtime/giftcodes
- Vollständige maschinenlesbare Referenz: https://api.lumean.app/docs/llm.md