⚙️Как подключить Google Play Gift Cards к магазину через API

Почему API — это единственный масштабируемый подход

Вручную копировать коды Google Play Gift Cards невозможно, если вы обрабатываете больше нескольких заказов в день. Telegram-бот, WooCommerce-магазин или собственная платформа — в любом случае вам нужна прямая интеграция с оптовым поставщиком. Через API вы получаете актуальный каталог, размещаете заказы и получаете коды за секунды — без участия человека.

FoxReload предоставляет REST API, разработанный специально для реселлеров цифровых товаров. В этом руководстве — полный цикл интеграции Google Play Gift Cards.

Что нужно перед началом

• Подтверждённый оптовый аккаунт FoxReload (foxreload.com/wholesale)
• API-ключ из личного кабинета поставщика
• Сервер или бэкенд, способный отправлять HTTPS-запросы
• Базовые знания JSON и REST

Шаг 1 — Аутентификация

Каждый запрос должен содержать API-ключ в заголовке Authorization.

GET /api/v1/catalog HTTP/1.1
Host: api.foxreload.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Храните ключ в переменных окружения, а не в коде.

export FOXRELOAD_API_KEY="ваш_ключ"

Шаг 2 — Получение каталога Google Play

GET /api/v1/catalog?category=google-play&currency=USD

Пример ответа:

{
  "products": [
    {
      "id": "gp-usd-5",
      "name": "Google Play Gift Card $5",
      "face_value": 5,
      "currency": "USD",
      "wholesale_price": 4.55,
      "stock": 320,
      "region": "US"
    },
    {
      "id": "gp-usd-25",
      "name": "Google Play Gift Card $25",
      "face_value": 25,
      "currency": "USD",
      "wholesale_price": 22.75,
      "stock": 140,
      "region": "US"
    }
  ]
}

Сохраняйте локально: id, wholesale_price, stock. Поле id понадобится при оформлении заказа.

Шаг 3 — Проверка наличия перед показом

Никогда не показывайте товар в магазине, если stock равен 0. Обновляйте каталог каждые 15–30 минут или используйте вебхуки.

import requests, os

headers = {"Authorization": f"Bearer {os.environ['FOXRELOAD_API_KEY']}"}
r = requests.get("https://api.foxreload.com/api/v1/catalog",
                 params={"category": "google-play"}, headers=headers)
products = r.json()["products"]

available = [p for p in products if p["stock"] > 0]

Шаг 4 — Размещение заказа

Когда покупатель оформляет заказ в магазине, отправьте POST-запрос на эндпоинт заказов.

POST /api/v1/orders
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "product_id": "gp-usd-25",
  "quantity": 1,
  "external_order_id": "ваш-внутренний-заказ-123"
}

Успешный ответ:

{
  "order_id": "fr-ord-98712",
  "status": "completed",
  "codes": [
    {
      "code": "XXXX-XXXX-XXXX-XXXX",
      "pin": null,
      "serial": "SN123456"
    }
  ],
  "delivered_at": "2026-05-27T14:32:01Z"
}

Для товаров в наличии статус сразу возвращается как completed. Сохраните код и передайте его покупателю.

Шаг 5 — Обработка ошибок

HTTP-статус	Значение	Действие
200	Успех	Передать код покупателю
400	Неверный запрос	Проверить тело запроса
401	Неверный API-ключ	Перевыпустить ключ
402	Недостаточно баланса	Пополнить оптовый счёт
404	Товар не найден	Повторно синхронизировать каталог
503	Нет в наличии	Поставить в очередь, повторить через 60 с

Реализуйте логику повторных попыток с экспоненциальным откатом для ошибок 503.

Шаг 6 — Автоматическое обновление цен

Оптовые цены меняются. Синхронизируйте их не реже одного раза в час и применяйте наценку динамически.

def sync_prices():
    r = requests.get("https://api.foxreload.com/api/v1/catalog",
                     params={"category": "google-play"}, headers=headers)
    for p in r.json()["products"]:
        retail_price = round(p["wholesale_price"] * 1.15, 2)  # наценка 15%
        update_storefront_price(p["id"], retail_price)

Чек-лист безопасности

• Никогда не передавайте API-ключ во фронтенд
• Используйте только HTTPS
• Верифицируйте подписи вебхуков
• Логируйте все ответы API для сверки заказов

Что делать дальше

После подключения каталога и эндпоинта заказов ваш магазин может продавать Google Play Gift Cards полностью автоматически. Следующие шаги:

• Автообновление цен — запустите почасовой cron-job для синхронизации
• Вебхуки — получайте уведомления в реальном времени вместо поллинга
• Оповещения об остатках — уведомляйте себя при снижении запасов

---

Смотрите также

• Как автоматически обновлять цены Google Play Gift Cards
• Как настроить вебхуки для доставки цифровых кодов
• Как реализовать мгновенную доставку Google Play Gift Cards

---

Готовы начать? Подключитесь к оптовому API FoxReload и продавайте Google Play Gift Cards без ручного исполнения заказов.