bitpay.php¶

В этой статье

Методы API

bitpay/check_payment

bitpay/init

Интеграция сервиса Bitpay для обработки платежей и инициализации инвойсов через WHMCS.

Методы API¶

Метод	Действие	Описание
`check_payment`	проверка оплаты	Проверяет статус платежа в Bitpay и при успешном завершении (complete) создает транзакцию в WHMCS.
`init`	инициализация платежа	Создает инвойс Bitpay на основе данных клиента и суммы счета WHMCS, возвращая URL для оплаты.

bitpay/check_payment¶

Проверяет статус платежа в Bitpay и при успешном завершении (complete) создает транзакцию в WHMCS.

HTTP-метод: POST

Параметры:

action	✅	string	Идентификатор метода: `check_payment`
token	✅	string	Токен авторизации для проверки прав доступа.
id	✅	integer	Идентификатор платежа (payment id) в системе Bitpay.
invoice_id	✅	integer	Уникальный идентификатор счета в системе биллинга.
invoiceId	❌	string	Альтернативное имя для передачи идентификатора счета.
source	❌	string	Источник вызова метода: invapi, webhook.

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

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

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

{
"result": "OK",
"message": "Paid",
"invoice_id": 12345,
"rate": 1,
"comission": 0,
"subscription_activated": 0
}

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

{
"code": -1,
"message": "Invalid payment id $id"
}

bitpay/init¶

Создает инвойс Bitpay на основе данных клиента и суммы счета WHMCS, возвращая URL для оплаты.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `init`
token	✅	string	Токен авторизации для проверки прав доступа.
invoice_id	✅	integer	Уникальный идентификатор счета (из \(_POST/\)_GET).
invoiceId	❌	string	Альтернативное строковое представление идентификатора счета.
url	❌	string	URL для перенаправления после оплаты.

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

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

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

{
"result": "OK",
"message": "https://bitpay.com/checkout/example-url",
"url": "https://bitpay.com/checkout/example-url"
}

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

{
"code": -1,
"message": "Invalid billing type bitpay to work with bitpay"
}