Глоссарий FazerCards
Gift card API (API подарочных карт)
REST API, позволяющий реселлеру программно заказывать цифровые подарочные карты (Amazon, Steam, iTunes и др.) по оптовым ценам и получать код в ответе за секунды.
Gift card API — это интеграционный слой между витриной реселлера (сайт, бот, бэкенд) и оптовым каталогом поставщика. Реселлер дергает GET /catalog для получения SKU и POST /order для покупки конкретного номинала; поставщик списывает оптовую цену с баланса и возвращает код активации (синхронно или через webhook). FazerCards публикует каталог на /api/v2 с авторизацией по X-Api-Key и асинхронной доставкой статусов через webhooks.
Главные факты
- Аутентификация обычно по API-ключу, не OAuth — клиент это бэкенд, а не конечный пользователь.
- Webhooks (order.completed / order.failed / order.refunded) — стандарт для асинхронного фулфилмента.
- Оптовая цена ниже номинала — разница и есть валовая маржа реселлера.
- Idempotency-ключ предотвращает дубли заказов при сетевых ретраях.