API methods — request structure
XML Merchant API
A single endpoint POST /API/XML/InvoiceManagementService.ashx (the path is case-insensitive). Dispatching is based on the root <XxxxRequest> tag inside <Request>.
HTTP headers: Service-Method, Callisto-Protocol-Version: 2, SignatureVersion: 3, Content-Type: text/xml; charset=utf-8.
REST JSON v3
Base path /api/v3/projects/{project_id}/. All responses use a single success/data or success/error envelope. Every response includes the X-Correlation-Id header.
| Method | Path | Description |
|---|---|---|
| POST | /invoices | Create an invoice |
| GET | /invoices/{id} | Invoice status |
| GET | /invoices?merchant_order_id=… | Search by order |
| POST | /invoices/{id}/cancel | Cancel an invoice |
| POST | /invoices/{id}/refund | Refund |
| POST | /contracts | Create a contract |
| POST | /contracts/{id}/authorize | Authorize a contract |
| POST | /contracts/{id}/cancel | Cancel a contract |
| POST | /billing/check | Check subscriber billing |
JSON API v3
Response envelope (JSON)
// Success response
{
"success": true,
"data": { ... }
}
// Error
{
"success": false,
"error": {
"code": "INVOICE_NOT_FOUND",
"message": "Invoice not found",
"details": { ... }
}
}