Chargebee

Интеграция с API Chargebee с использованием управляемой OAuth-аутентификации. Позволяет работать с подписками, клиентами, счетами и страницами оформления заказа. Этот инструмент стоит использовать, когда необходимо взаимодействовать с биллинговыми данными Chargebee. Для других сторонних сервисов рекомендуется применять универсальный API-шлюз.

Обзор

Данный инструмент предоставляет доступ к API Chargebee через единый шлюз с автоматической аутентификацией. Он упрощает управление подписками, клиентской базой, выставлением счетов и биллинговыми процессами.

Быстрый старт

# Получение списка клиентов
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/chargebee/api/v2/customers?limit=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/chargebee/{native-api-path}

Замените {native-api-path} на конкретный путь API Chargebee. Шлюз автоматически перенаправляет запросы к соответствующему поддомену и добавляет необходимые данные аутентификации.

Аутентификация

Каждый запрос требует передачи API-ключа Maton в заголовке:

Authorization: Bearer $MATON_API_KEY

Перед началом работы необходимо задать переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Как получить API-ключ

• Зарегистрируйтесь или войдите в аккаунт на maton.ai
• Перейдите в настройки
• Скопируйте свой API-ключ

Управление подключениями

Все подключения Chargebee управляются через сервис управления соединениями.

Получение списка подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=chargebee&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Создание подключения

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'chargebee'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Получение информации о подключении

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

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

{
 "connection": {
 "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
 "status": "ACTIVE",
 "creation_time": "2025-12-08T07:20:53.488460Z",
 "last_updated_time": "2026-01-31T20:03:32.593153Z",
 "url": "https://connect.maton.ai/?session_token=...",
 "app": "chargebee",
 "metadata": {}
 }
}

Для завершения авторизации откройте полученную ссылку url в браузере.

Примечания

• Для POST-запросов используется формат form-urlencoded
• Вложенные параметры передаются с помощью bracket-нотации (например, customer[email])
• Временные метки представлены в формате Unix
• Для постраничной навигации используется параметр next_offset
• В Product Catalog 2.0 применяются items и item_prices

Обработка ошибок

• 400 — отсутствует подключение Chargebee
• 401 — неверный или отсутствующий API-ключ
• 429 — превышен лимит запросов (10 запросов в секунду)
• 4xx/5xx — ошибка со стороны Chargebee API

Устранение неполадок

Проблемы с API-ключом:

echo $MATON_API_KEY

Также можно проверить корректность ключа, запросив список подключений.

Некорректное имя приложения:

Убедитесь, что URL начинается с chargebee.

• Правильно: https://gateway.maton.ai/chargebee/api/v2/customers
• Неправильно: https://gateway.maton.ai/api/v2/customers