yookassa.php¶

Интеграция с сервисом ЮKassa для обработки платежей, инициализации сессий оплаты и синхронизации транзакций через вебхуки или API.

Методы API¶

Метод	Действие	Описание
`check_payment`	проверка статуса платежа	Проверяет статус платежа в ЮKassa и при успешной оплате обновляет данные инвойса и транзакции в биллинге.
`init`	инициализация оплаты	Создает платеж в ЮKassa для конкретного инвойса и возвращает токен подтверждения.

Проверяет статус платежа в ЮKassa и при успешной оплате обновляет данные инвойса и транзакции в биллинге.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `check_payment`
token	✅	string	Токен авторизации API.
id	✅	integer	Идентификатор платежа (payment id) для проверки статуса.
source	❌	string	Источник вызова метода для определения логики обработки платежа.

Пример запроса

curl -s "https://invapi.hostkey.ru/yookassa.php" -X POST \
--data "action=check_payment" \
--data "token=HOSTKEY_TOKEN" \
--data "id=VALUE"

Пример успешного ответа

{
"result": "OK",
"message": "Paid",
"invoice_id": 123,
"rate": 1.0,
"comission": 50.5,
"subscription_activated": true
}

Примеры ошибок

{
"result": -1,
"message": "Invalid payment id"
}

Создает платеж в ЮKassa для конкретного инвойса и возвращает токен подтверждения.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `init`
token	✅	string	Токен авторизации API.
force_subscr	❌	boolean	Флаг принудительного создания рекуррентного платежа для подписки.
invoice_id	✅	integer	Уникальный идентификатор счета в системе биллинга.

Пример запроса

curl -s "https://invapi.hostkey.ru/yookassa.php" -X POST \
--data "action=init" \
--data "token=HOSTKEY_TOKEN" \
--data "invoice_id=12345"

Пример успешного ответа

{
"result": "OK",
"message": "confirmation_token_value",
"id": 987654321
}

Примеры ошибок

{
"code": -1,
"message": "yookassa init failed: error_description"
}