Перейти к документации
API

Начать оплату

Ссылка, по которой покупают платный тариф.

POST/billing/checkout

Выполняет настоящий запрос в вашем рабочем пространстве.

POST /billing/checkout

Ссылка, по которой покупают платный тариф.

Пример

Требуется billing:write. plan принимает starter, business или enterprise, а interval равен month, по умолчанию, или year. Ничего не списывается, пока человек не оплатит там, и тариф начинается, когда он это сделал.

curl
curl -X POST "$OE/billing/checkout" -H "$AUTH" -H 'content-type: application/json' \  -d '{ "plan": "business", "interval": "year" }'
Ответ
{ "object": "checkout", "url": "https://checkout.example.com/c/3Hq8vXnP2sT6kL0w" }

Рабочее пространство, которое уже платит за тариф, даёт 409 plan_conflict: вместо этого смените тариф на биллинг-портале. Тариф или период, которые эта установка не продаёт, дают 422 plan_unavailable.

Через API ничего не оплачивается. Ссылка открывает страницу платёжного провайдера, где человек платит, меняет карту или отменяет, как и из приложения.

Токену доступа OAuth для этого вызова нужен код подтверждения. Пока приложение не подтвердило код за последние 60 минут, вызов отвечает 403 step_up_required и ничего не меняет. У API-ключа его никогда не спрашивают. Страница «Аутентификация» показывает, как запросить код и подтвердить его.

Справочник