Gigma

Карты клиента и их смена

Карта сохраняется при первой оплате и дальше используется для автоматических списаний. Клиенту нужно дать возможность её заменить — иначе просроченная карта тихо превращается в отменённую подписку.

Получение способов оплаты клиента

Метод
GET
URL
https://api.gigma.ru/api/counterparty/payment-methods
Авторизация
App Token + Bearer token
Headers
Token: {application_token}; Authorization: Bearer {counterparty_token}
Успешный ответ
200

Ответ

{
    "data": [
        {
            "id": 9,
            "payment_method_type": "bank_card",
            "card_type": "Visa",
            "card_last_4": "4242",
            "title": "Visa •••• 4242",
            "is_active": true,
            "created_at": "2026-08-15T10:00:00+00:00"
        }
    ]
}

API возвращает только безопасное представление карты. Полный номер и CVC не сохраняются в этом контракте.

Отвязка сохранённого способа оплаты

Метод
DELETE
URL
https://api.gigma.ru/api/counterparty/payment-methods/{id}
Авторизация
App Token + Bearer token
Headers
Token: {application_token}; Authorization: Bearer {counterparty_token}
Успешный ответ
200

Ответ

{
    "message": "Способ оплаты отвязан"
}

Backend деактивирует способ оплаты только в контексте текущего клиента и Application. Если он нужен действующей подписке, операция может быть отклонена.

Начало безопасной смены карты подписки

Метод
POST
URL
https://api.gigma.ru/api/counterparty/subscriptions/{id}/payment-method-change
Авторизация
App Token + Bearer token
Headers
Token: {application_token}; Authorization: Bearer {counterparty_token}
Успешный ответ
200

Параметры запроса

  • autopay_consent (boolean, обязательно) — должно быть true.

Не передавайте card, card_number, cvc, payment_method_data или собственный return_url: validation специально запрещает эти поля.

Пример запроса

{
    "autopay_consent": true
}

Ответ

Backend создаёт provider-flow и возвращает его состояние:

{
    "id": 31,
    "subscription_id": 42,
    "status": "pending",
    "confirmation_url": "https://yoomoney.ru/confirmation/...",
    "saved_payment_method_id": null,
    "expires_at": "2026-08-16T11:00:00+00:00"
}

Откройте confirmation_url, затем синхронизируйте попытку.

Синхронизация смены карты

Метод
POST
URL
https://api.gigma.ru/api/counterparty/subscriptions/{id}/payment-method-changes/{change_id}/sync
Авторизация
App Token + Bearer token
Headers
Token: {application_token}; Authorization: Bearer {counterparty_token}
Успешный ответ
200

Ответ

Возвращает тот же объект попытки. Завершённый статус содержит saved_payment_method_id; для незавершённого confirmation_url может оставаться доступным.

© 2026 Gigma