Методы
| Метод | Описание |
|---|---|
CreateSubscription | Создать подписку — по номеру (SMS_PIN), с оплатой картой / СБП (CustomerType=Card) либо через WAP (ClientIP) |
ApproveSubscription | Подтвердить подписку PIN-кодом (1234, три попытки) |
CancelSubscription | Отменить подписку |
GetSubscriptionStatus | Получить статус подписки |
ResendPinCode | Повторно отправить PIN — не более трёх раз, только для SMS_PIN |
GetSubscriptions | Список подписок проекта — активные и закрытые, новые первыми |
RefundBillingOperation | Возврат списания по BillingOperationID из уведомления |
Остальные методы (кроме CreateSubscription, GetSubscriptions и RefundBillingOperation) принимают дополнительно <SubscriptionID> — либо <Subscriber_MSISDN> / <SubscriberID> вместо него, — а ApproveSubscription ещё и <PinCode>.
GetSubscriptions — единственный метод сервиса, чей путь без .aspx: так он объявлен в спецификации платформы.
Отличия песочницы у этих двух методов. Выдача GetSubscriptions ограничена 50 записями (проект песочницы общий), и печатаются только поля, которые песочница действительно знает: MerchantSubsID, RenewPeriod, ActualRenewCount, ClosedTime и NetworkID она не хранит. У биллинговых операций состояния нет: BillingOperationID рождается в самом уведомлении и нигде не хранится, поэтому RefundBillingOperation проверяет только форму идентификатора (UUID), считает возврат мгновенным и всегда успешным и не меняет ни статус подписки, ни расписание списаний.
Поля клиента в CreateSubscription
| Поле | Когда передавать |
|---|---|
Subscriber_MSISDN | Активация SMS_PIN. Мок принимает и legacy-имя MSISDN, но спека называет поле Subscriber_MSISDN |
CustomerType = Card | Оплата картой или через СБП. MSISDN не нужен |
CustomerId | Идентификатор клиента в вашей системе, обязателен вместе с CustomerType=Card |
ClientIP | WAP-активация, если передан без номера. Вместе с номером — проверка соответствия стран |
POST /Http/Services/{Method}.aspx
<?xml version="1.0" encoding="utf-8"?>
<Request>
<SubscriptionProjectID>2001</SubscriptionProjectID>
<Subscriber_MSISDN>79001234567</Subscriber_MSISDN>
<Now>20260625120000</Now>
<Signature>d2f36558ca5455be...</Signature>
</Request><Response>
<StatusName>REQUEST_ACCEPTED</StatusName>
<SubscriptionID>10000001</SubscriptionID>
<SubscriberAcceptanceRequired>true</SubscriberAcceptanceRequired>
<SubscriberAcceptanceChannel>SMS_PIN</SubscriberAcceptanceChannel>
<OperatorID>22</OperatorID>
<PaidUntil>2026-07-25T12:00:00+03:00</PaidUntil>
</Response>