Методы API — структура запросов
XML Merchant API
Единый endpoint POST /API/XML/InvoiceManagementService.ashx (регистр пути не важен). Диспетчеризация — по корневому тегу <XxxxRequest> внутри <Request>.
HTTP-заголовки: Service-Method, Callisto-Protocol-Version: 2, SignatureVersion: 3, Content-Type: text/xml; charset=utf-8.
REST JSON v3
Базовый путь /api/v3/projects/{project_id}/. Все ответы — единый конверт success/data либо success/error. Каждый ответ содержит заголовок X-Correlation-Id.
| Метод | Путь | Описание |
|---|---|---|
| POST | /invoices | Создать инвойс |
| GET | /invoices/{id} | Статус инвойса |
| GET | /invoices?merchant_order_id=… | Поиск по заказу |
| POST | /invoices/{id}/cancel | Отменить инвойс |
| POST | /invoices/{id}/refund | Возврат средств |
| POST | /contracts | Создать контракт |
| POST | /contracts/{id}/authorize | Авторизовать контракт |
| POST | /contracts/{id}/cancel | Отменить контракт |
| POST | /billing/check | Проверить биллинг абонента |
JSON API v3
Конверт ответа (JSON)
// Успешный ответ
{
"success": true,
"data": { ... }
}
// Ошибка
{
"success": false,
"error": {
"code": "INVOICE_NOT_FOUND",
"message": "Invoice not found",
"details": { ... }
}
}