Метод получения платежа по его subscription_token

Метод позволяет получить платёж из системы платёжного провайдера по subscription_token. Чтобы его получить, используйте методы SmartPay API. Как получить subscription_token?

Параметры взаимодействия

GET /public/purchases/{subscription_token}

Атрибут

Тип

Описание

Обязательность

Расположение

Пример заполнения

Public-Token

string

Токен доступа к Public API Rustore

Да

header

subscription_token

string

Идентификатор покупки

Да

path

Параметры ответа

Атрибут

Тип

Описание

Обязательность

Расположение

Пример заполнения

code

number

Код ответа

Да

body

message

date

Расшифровка кода ответа

Нет

body

errorCode

string

Код ошибки (при наличии)

Нет

body

body{}

object

Данные ответа от SmartPay

Нет

body

body{}

Названия атрибутов в json необходимо конвертировать из snake_case в camelCase. Пример ответа от SmartPay:

{
  "error": {
    "user_message": "",
    "error_description": "",
    "error_code": "0"
  },
  "invoice_id": "1234567890",
  "invoice_date": "2020-04-29T08:18:03+03",
  "invoice_status": "created",
  "invoice": {
    "purchaser": {
      "email": "qq@dd.eof",
      "phone": "9123456789",
      "contact": "email"
    },
    "delivery_info": {
      "address": {
        "country": "RU",
        "city": "Москва",
        "address": "ул. Вавилова, 19, офис 1"
      },
      "delivery_type": "courier",
      "description": "Перезвонить за 1,5 часа"
    },
    "invoice_params": [
      {
        "key": "packageName",
        "value": "com.MashaAndTheBear.HairSalon"
      }
    ],
    "order": {
      "order_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "order_number": "145",
      "order_date": "2020-04-29T08:17:03+03",
      "service_id": "223",
      "amount": 11836,
      "currency": "RUB",
      "purpose": "Покупка в игре «Маша и Медведь, салон красоты Чародейка».",
      "description": "Покупка внутриигрового контента в игре «Маша и Медведь, салон красоты Чародейка».",
      "language": "ru-RU",
      "expiration_date": "2022-10-11T14:05:44.741Z",
      "tax_system": 0,
      "trade_name": "Romashka",
      "visual_name": "Покупка/продление подписки",
      "org_name": "ООО Ромашка",
      "org_inn": "1234567890",
      "visual_amount": "1 500,45 ₽",
      "order_bundle": [
        {
          "position_id": 1,
          "name": "Кучка из 100 кристаллов для использования при нырянии",
          "item_params": [
            {
              "key": "packageName",
              "value": "com.MashaAndTheBear.HairSalon"
            }
          ],
          "quantity": {
            "value": 1.05,
            "measure": "кг."
          },
          "item_amount": 11836,
          "currency": "RUB",
          "item_code": "com.MashaAndTheBear.HairSalon.crystal100",
          "item_price": 11836,
          "discount_type": "percent",
          "discount_value": 5.25,
          "interest_type": "agentPercent",
          "interest_value": 15.105,
          "tax_type": 6,
          "tax_sum": 2367,
        }
      ]
    }
  },
  "application_code": "com.MashaAndTheBear.HairSalon",
  "application_name": "Салон красоты \"Маша и медведь\"",
  "owner_code": "com.MashaAndTheBear",
  "owner_name": "Маша и медведь",
  "payment_info": {
    "payment_date": "2022-10-11T14:05:44.741Z",
    "payment_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "payment_params": {
      "key": "googlePurchaseToken",
      "value": "ameinkbophchljaejnocadib.AO-J1Oyrh3GSPGrLocZlW4UXiilTv_fMDz8Wpjadky8-26BhzBPMiwtoKql706e3ntW2BQNdl9WSiBjsjLebCcz3BhFyM7FVxDnOB1TFeeA0SHnco9j8G_OZVxghv7bwXWLgWsaUUGfw"
    },
    "device_info": {
      "device_platform_type": "iOS",
      "device_platform_version": "13.6.1",
      "device_model": "iPhone 7",
      "device_manufacturer": "Apple",
      "device_id": "83c3f257-46d8-41fe-951b-f79d04e288c2",
      "surface": "SBOL",
      "surface_version": "11.5.0"
    },
    "loyalty_info": {
      "service_code": "sbrf_spasibo",
      "service_name": "Сбербанк Спасибо",
      "change_rate": 1,
      "payment_bonus": 19800,
      "award_bonus": 21850,
    },
    "card_id": "ad454ffg-6c54-4b01-90e6-d701748f0851",
    "name": "Главная",
    "paysys_code": "RBS-shortname",
    "masked_pan": "**1111",
    "expiry_date": "201912",
    "cardholder": "Ivan Petrov",
    "payment_system": "Visa",
    "paysys": "Эквайринг Сбербанка",
    "payment_way": "Sber Pay",
    "payment_way_code": "SberPay",
    "bank_info": {
      "bank_name": "ПАО Сбербанк",
      "bank_country_code": "RU",
      "bank_country_name": "Россия",
    }
  },
  "payment_methods": {
    "user_message": "Для подключения подписки сохраните банковскую карту в мобильном приложении СалютАпп",
    "methods": [
      {
        "method": "QR",
        "action": "Оплатить по QR-коду"
      }
    ]
  }
}

errorCode:

  • outdated_token — токен недействителен (истек срок действия);

  • owner_blocked — владелец заблокирован и/или отключена монетизация;

  • app_owner_mismatch — приложение недоступно для переданного токена.

Валидация запроса

При получении запроса проверяется токен авторизации, полученный методом получения токена авторизации:

  • владелец и/или приложение не должны быть заблокированы;

  • токен должен быть действительным;

  • в ответе на запрос invoice в application_code должен содержаться код приложения, соответствующий владельцу, получившему токен. 
Was this information helpful?