Skip to Content

Методы

МетодОписание
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
ClientIPWAP-активация, если передан без номера. Вместе с номером — проверка соответствия стран

POST /Http/Services/{Method}.aspx

CreateSubscription — запрос
<?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>