/v1/subscriptions/

Запрос на получение информации по подписке.

Возвращает идентификатор подписки, состояние подписки и привязанного способа оплаты.

Request

GET

https://pay.yandex.ru/api/merchant/v1/subscriptions/{customer_subscription_id}

Production

GET

https://sandbox.pay.yandex.ru/api/merchant/v1/subscriptions/{customer_subscription_id}

Sandbox

Path parameters

Name

Description

customer_subscription_id*

Type: string

ID подписки

Max length: 2048

Body

application/json
{
    "check_card_active": false
}

Name

Description

check_card_active

Type: boolean

Позволяет проверить привязку карты

Responses

200 OK

Body

application/json
{
    "code": 200,
    "data": {
        "cancelledAt": "2022-12-29T18:02:01Z",
        "customerSubscriptionId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b",
        "isCardActive": false,
        "nextWriteOff": "2022-12-29T18:02:01Z",
        "status": "NEW",
        "subscriptionPlanId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b"
    },
    "status": "success"
}

Name

Description

code

Type: number

Default: 200

data

Type: CustomerSubscriptionResponseData

status

Type: string

Default: success

Enum: success

CustomerSubscriptionResponseData

Name

Description

status*

Type: string

Статус подписки

Enum: NEW, ACTIVE, CANCELLED, EXPIRED

subscriptionPlanId*

Type: string<uuid>

ID плана подписки

Max length: 2048

cancelledAt

Type: string<date-time>

Время отмены подписки

customerSubscriptionId

Type: string<uuid>

ID подписки

Max length: 2048

isCardActive

Type: boolean

Статус привязанной карты

nextWriteOff

Type: string<date-time>

Дата следующего списания

Предыдущая
Следующая