Создание контракта
XML: CreateCustomerContract · JSON: POST /contracts
Привязывает абонента (MSISDN) к проекту для повторных платежей. После создания абоненту «отправляется» PIN (в sandbox подходит любой).
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
ProjectID | int | Да | ID проекта |
ClientIP | string(39) | Нет | IP абонента |
MSISDN | string(20) | Да | Номер телефона |
MerchantContractID | string(64) | Да | ID контракта в системе Продавца |
Ответ
| Поле | Тип | Описание |
|---|---|---|
ContractID | guid | Уникальный ID контракта — сохранить для платежей |
AuthorizationType | enum | SMS_PIN / EXTERNAL |
ExpirationTimeUtc | datetime | Срок действия контракта |
MSISDN, Country, NetworkID, OperatorID | — | Данные абонента |
JSON API v3
Запрос и ответ (JSON)
// POST /api/v3/projects/1001/contracts
{
"client_ip": "87.101.32.12",
"customer": { "type": "mobile_phone", "msisdn": "79600000000" },
"merchant_contract_id": "contract-123"
}
// 201 Created
{
"success": true,
"data": {
"contract_id": "16449203-0000-009b-a125-351b7bfbd207",
"authorization_type": "SMS_PIN",
"expires_at": "2026-06-25T14:00:00Z",
"merchant_contract_id": "contract-123"
}
}