Способ оплаты Google Pay

Эта ссылка основана на схеме платежного инструмента "Банковская карта" для объекта способа оплаты, возвращаемого обработчиком платежей Google Pay после завершения оформления заказа в массиве payment.instruments.

{
  "id": string,
  "handler_id": string,
  "type": string,
  "selected": boolean,
  "display": {
    "brand": string,
    "last_digits": string,
    "description": string,
    "card_art": string
  },
  "billing_address": {
    "first_name": string,
    "last_name": string,
    "street_address": string,
    "extended_address": string,
    "address_locality": string,
    "address_region": string,
    "postal_code": string,
    "address_country": string,
    "phone_number": string
  },
  "credential": {
    "type": "PAYMENT_GATEWAY" | "DIRECT",
    "token": string
  }
}

Свойства

Свойство Тип Всегда ли присутствует? Описание
id Строка Да Уникальный идентификатор экземпляра платежного инструмента, присвоенный платформой.
handler_id строка Да Уникальный идентификатор экземпляра обработчика, который создал этот инструмент. Соответствует полю id в конфигурации обработчика платежей.
type строка Да Тип платежного инструмента, например card.
selected Логическое значение Нет Указывает, был ли выбран этот инструмент пользователем.
display Объект Да Показывает информацию о способе оплаты.
display.brand строка Да Бренд или сеть карты (например, VISA).
display.last_digits строка Да Последние четыре цифры номера карты.
display.description строка Нет Описание карточки, которое будет видно пользователю.
display.card_art строка Нет URI изображения, представляющего карточку.
billing_address Объект Нет Платежный адрес, связанный с картой. Возвращается, только если в конфигурации для параметра billing_address_required задано значение true.
billing_address.first_name строка Нет Имя контактного лица, связанного с адресом.
billing_address.last_name строка Нет Фамилия контактного лица, связанного с адресом.
billing_address.street_address строка Нет Почтовый адрес.
billing_address.extended_address строка Нет Дополнительная информация об адресе, например номер квартиры.
billing_address.address_locality строка Нет Населенный пункт, например город.
billing_address.address_region строка Нет Регион, например штат или провинция.
billing_address.postal_code строка Нет Почтовый индекс.
billing_address.address_country строка Нет Код страны (двухбуквенный код в формате ISO 3166-1 alpha-2).
billing_address.phone_number строка Нет Номер телефона. Возвращается, только если в конфигурации для параметра phone_number_required задано значение true.
credential Объект Нет Безопасные данные токенизации, возвращенные Google Pay.
credential.type строка Да Тип токенизации. Соответствует настроенному типу.
  • PAYMENT_GATEWAY – используется, если вы обрабатываете платежи через поддерживаемый платежный шлюз.
  • DIRECT – используется, если вы сами расшифровываете учетные данные.
credential.token строка Да Зашифрованный токен платежных данных в виде сериализованной строки JSON.

Для PAYMENT_GATEWAY содержит зашифрованную полезную нагрузку, которую нужно передать шлюзу. Для DIRECT этот параметр содержит зашифрованные реквизиты карты (требуется расшифровка с помощью закрытого ключа). Подробную информацию о формате и процессе расшифровки можно найти в руководстве Шифрование платежных данных.