Полная документация, готовые библиотеки и примеры кода для быстрой интеграции с PanaceaPay
Для начала работы получите у вашего менеджера ключ API (токен), который потребуется для авторизации всех запросов.
Отправьте запрос для создания инвойса. В ответе вы получите ссылку на платежную форму url, на которую нужно перенаправить пользователя.
После оплаты на ваш callback_url придет POST-запрос с результатом. Обязательно проверяйте подпись sign для безопасности.
При изменении статуса платежа, на указанный callback_url будет отправлена результирующая информация методом POST.
sign вычисляется как md5 от конкатенации следующих строк: сумма инвойса в копейках, наименование валюты, id инвойса, order_id, токен.
| Событие/Статус | Описание |
|---|---|
| Нотификация о платеже | Отправляется при смене статуса платежа (STATUS_PAID, STATUS_ERROR, STATUS_HOLD и др.). |
| Параметры | id, payment_id, order_id, card, amount, status, callback_url, return_url, fail_url, url, projectId, cardToken, created_at, status_time, sign. При ошибке добавляется error_description. |
sign вычисляется как md5 от конкатенации: orderId + amount + token.
| Событие/Статус | Описание |
|---|---|
| Финализация платежа | Отправляется при финализации СБП-платежа (статусы SUCCESS или FAILED). |
| Параметры | invoice_id, payment_id, order_id, guid, payment_type, amount, status, created_at, status_time, description, qrlink. |
В случае ошибки API возвращает HTTP-статус 4xx или 5xx и тело ответа с описанием проблемы.
{
"errors": {"title": "Заголовок ошибки", "text": "Описание ошибки"},
"status": false
}
{
"errors": {"title": "Ошибка запроса", "text": "Невозможно для текущего статуса платежа"},
"status": false
}
{
"result": false,
"message": "Ошибка при попытке возврата"
}
{
"status": false,
"data": "",
"errors": [
"Достигнут лимит по количеству платежей"
]
}
{
"guid": "...",
"payment_id": "...",
"status": "FAILED",
"errorDescription": "Ошибка проведения платежа. Обратитесь к менеджеру или попробуйте позже."
}
Скачайте подробную документацию по методам интеграции в формате Microsoft Word.
Получите API-ключи и начните принимать платежи с PanaceaPay уже сегодня.
Получить доступ к API