Создать подписку
POST /Http/Services/CreateSubscription.aspx
Инициализация подписки. Две ветки:
- SMS_PIN — в запросе
Subscriber_MSISDN(принимается и legacy-имяMSISDN). В ответеSubscriptionIDиSubscriberAcceptanceChannel=SMS_PIN; подтверждение —ApproveSubscriptionс PIN1234. - Банковская карта и СБП — в запросе
CustomerType=CardиCustomerId. В ответеSubscriberAcceptanceChannel=AUTH_PAGEиAuthorizeUrl: абонента нужно перенаправить на этот адрес. Для оплаты по QR-коду СБП добавьте к нему?useSbpQr=True.ApproveSubscriptionв этой ветке не вызывается — подписка активируется по факту оплаты.
Коллбек SubscriptionStatusNotification уходит при фактической активации
(EventType=APPROVED), а не сразу после создания.
Повторный вызов для того же Subscriber_MSISDN в рамках проекта возвращает
уже созданную подписку (боевая платформа отвечает
WRONG_PARAMS / SubscriptionAlreadyCreated).
Тело запроса
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
Now | string | да | Текущее время UTC в формате yyyyMMddHHmmss. |
Signature | string | да | Подпись запроса: LOWERCASE(HMACSHA256(SecretKey, SubscriptionProjectID + Now)). |
SubscriptionProjectID | integer (int32) | да | Идентификатор проекта подписок. |
MerchantSubsID | string | — | |
Localization | string | — | Необязательно. Язык текстов для пользователя; по умолчанию ru-RU. |
Subscriber_MSISDN | string | — | Необязательно. Номер (MSISDN) пользователя, на который создаётся подписка (либо SubscriberID). Не передаётся при WAP-активации (SubscriberAcceptanceChannel=AUTH_PAGE). Песочница принимает и прежнее имя MSISDN. |
SubscriberID | integer (int64) | — | Идентификатор абонента в Системе, вместо Subscriber_MSISDN. При WAP-активации номер не нужен: он определяется, когда пользователь открывает страницу активации. |
BillingPeriod | string | — | |
BillingCount | string | — | |
BillingPeriodIntervalType | string | — | |
StartTimeUtc | string | — | Необязательно. Время начала активации подписки (для SMS_PIN — время отправки SMS с PIN); по умолчанию текущее. Формат yyyy-MM-dd HH:mm. |
BillingStartTimeUtc | string | — | Необязательно. Время первого списания; по умолчанию StartTimeUtc плюс сдвиг из настроек проекта. Формат yyyy-MM-dd HH:mm. |
ContentProjectUID | string | — | |
SubscriptionTitle | string | — | |
ResendSmsPinIfSubscriptionAlreadyExists | string | — | Необязательно, по умолчанию false. Для SMS_PIN: если подписка уже есть, ответ остаётся WRONG_PARAMS / SubscriptionAlreadyCreated, но SMS с PIN отправляется повторно (не более 2 раз). |
ClientIP | string | — | IP-адрес пользователя, от которого идёт запрос. |
CustomerId | string | — | Идентификатор клиента в системе партнёра (уникальный). |
CustomerType | string | — | Тип источника оплаты подписки: Card — банковская карта или СБП. |
ExpectedApprovingType | string | — | |
ExternalApprovingType | NONE · IVR · SMS · USSD · SMS_PIN · AUTH_PAGE · AUTH_PAGE_AOC · SMS_AOC | — | |
ContentLogin | string | — | |
ContentPassword | string | — | |
AdditionalParams | string | — | |
ApplyPreAuthTemplate | boolean | — | |
ExternalServiceId | string | — | |
PartnerLandingSplitId | string | — | |
LandingPageId | string | — |
Коды ответов
| Код | Описание |
|---|---|
200 | Результат в StatusName (REQUEST_ACCEPTED при успехе) |
500 | Внутренняя ошибка платформы |