paygine.php¶

В этой статье

• Методы API
• paygine/check
• paygine/init
• paygine/sbp_check
• paygine/sbp_subscribe
• paygine/sync_orders

Модуль синхронизации заказов Paygine для администраторов: выполнение сверки платежей, обработка реферальных систем и формирование отчетов по биллингам.

Методы API¶

paygine/check¶

Проверяет текущий статус заказа и завершает транзакцию, если платеж подтвержден.

HTTP-метод: POST

Параметры:

curl -s "https://invapi.hostkey.ru/paygine.php" -X POST \
--data "action=check" \
--data "token=HOSTKEY_TOKEN" \
--data "invoice_id=123" \
--data "order_id=456"

{
"result": "OK",
"message": "Paid",
"invoice_id": 123,
"transid": "TXN_789",
"subscription_activated": 1,
"payment_method": "card"
}

{
"code": -1,
"message": "Order failed"
}

paygine/init¶

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

HTTP-метод: POST

Параметры:

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

{
"result": "OK",
"message": "Paid",
"invoice_id": 123,
"order_id": 456,
"pay_url": "https://gateway.example.com/pay/abc",
"subscription_activated": 0,
"reused": 0,
"subscribe": 0
}

{
"code": -1,
"message": "Invalid invoice id"
}

paygine/sbp_check¶

Проверяет статус привязки счета СБП по идентификатору QR-кода.

HTTP-метод: POST

Параметры:

curl -s "https://invapi.hostkey.ru/paygine.php" -X POST \
--data "action=sbp_check" \
--data "token=HOSTKEY_TOKEN" \
--data "qrc_id=VALUE"

{
"result": "OK",
"message": "Active"
}

{
"code": -1,
"message": "Expired"
}

paygine/sbp_subscribe¶

Инициализирует процесс привязки счета СБП для автоматических платежей.

HTTP-метод: POST

Параметры:

curl -s "https://invapi.hostkey.ru/paygine.php" -X POST \
--data "action=sbp_subscribe" \
--data "token=YOUR_TOKEN"

{
"result": "OK",
"action": "sbp_subscribe",
"qrc_id": "abc123XYZ",
"payload": "base64_encoded_data",
"expires": 1700000000
}

{
"code": -1,
"message": "Customer not found"
}

paygine/sync_orders¶

Синхронизирует заказы по указанным биллингам за определенный период времени. Доступно только администраторам.

HTTP-метод: POST

Параметры:

curl -s "https://invapi.hostkey.ru/paygine.php" -X POST \
--data "action=sync_orders" \
--data "token=HOSTKEY_TOKEN" \
--data "billing[]=val1" \
--data "billing[]=val2" \
--data "days=5"

{
"result": "OK",
"report": {
"billing_name": {
"result": -1,
"checked": 5,
"booked": 2,
"refunds": 0,
"errors": [
"error message line"
]
}
}
}

{
"code": -1,
"message": "staff only"
}