Для того чтобы создать подписку, нужно отправить видоизмененный запрос на создание платежа (осуществляемых через общую страницу платежей).
Изменения заключаются в следующем: в поле paymentGroup надо отправить значение SUBSCRIPTION. Так же надо добавить новое поле plan, со
следующими параметрами:
| Название параметра | Тип | Всегда доступен | Объяснение |
|---|---|---|---|
price |
double |
Да | Общая сумма подписки |
periodType |
decimal |
Да | Период подписки (возможные значения: 7, 30, 360 дней) |
nochargeDayCount |
decimal |
Да | Пробный период (исчесляется в днях) |
description |
String |
Да | Описание подписки |
Возмодные статусы подписок:
| Значение | Объяснение | Цифра |
|---|---|---|
ACTIVE |
Эта подписка активна и будет обновляться каждые periodType дней. |
0 |
PASSIVE |
Эта подписка является пассивной из-за нескольких неудачных попыток снятия оплаты или статуса, запрошенного пользователем. | 1 |
PENDING |
Повторная попытка снятия оплаты для активизации подписки будет проведена сегодня. | 2 |
DELETED |
Подписка была удалена. | 3 |
PROCESSING |
Ровно в данный момент обрабатывается платеж для подписки. | 4 |
ANOMALY |
Произошла ошибка во время сохранения платежа. Платеж прошел, но подписка не была обновлена. | 5 |
WAITING |
Подписка в статусе ожидания следующей попытки платежа. | 6 |
Типичный REST request может быть осуществлен следующим образом:
{
"price": 17.99,
"paidPrice": 17.99,
"currency": "AZN",
"paymentGroup": "SUBSCRIPTION",
"callbackUrl": "NO_CALLBACK_URL",
"conversationId: "my_conversation_id_1231",
"items": [
{
"name": "TV Premium",
"price": 17.99
}
],
"plan": {
"price": 17.99,
"periodType": 30,
"nochargeDayCount": 0,
"description": "monthly tv subscription without free week"
}
}