Объекты ответов JSON

В этом справочнике описаны параметры объектов ответа API Google Pay для использования в вашем приложении. Объекты ответа — это объекты, возвращаемые клиентскими методами API Google Pay.

PaymentData

Это объект ответа, который возвращается Google после того, как плательщик одобряет платеж.

Свойство Тип Всегда существует Описание
apiVersion число Да Основная версия API. Значение в ответе совпадает со значением, указанным в PaymentDataRequest .
apiVersionMinor число Да Версия API младшего уровня. Значение в ответе соответствует значению, указанному в PaymentDataRequest .
paymentMethodData PaymentMethodData Да Данные о выбранном способе оплаты.
email нить Нет Адрес электронной почты, если emailRequired имеет значение true в PaymentDataRequest .Если в другом запросе свойство установлено как true , то это не даст никакого эффекта.
shippingAddress Адрес Нет Адрес доставки, если shippingAddressRequired имеет значение true в PaymentDataRequest .

Пример

В этом примере ответа для API Google Pay версии 2.0 на странице оплаты Google Pay выбран способ оплаты CARD . Для example шлюза был сгенерирован токен способа оплаты.

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "paymentMethodData": {
    "type": "CARD",
    "description": "Visa •••• 1234",
    "info": {
      "cardNetwork": "VISA",
      "cardDetails": "1234",
      "cardFundingSource": "CREDIT"
    },
    "tokenizationData": {
      "type": "PAYMENT_GATEWAY",
      "token": "examplePaymentMethodToken"
    }
  }
}

PaymentMethodData

Этот объект предоставляет данные для выбранного способа оплаты.

Свойство Тип Всегда существует Описание
type нить Да PaymentMethod type , выбранный на платежной странице Google Pay.
description нить Да

Сообщение для пользователя, описывающее способ оплаты, с помощью которого финансируется данная транзакция.

info объект Да Значение этого свойства зависит от возвращаемого type способа оплаты. Для CARD см. CardInfo .
tokenizationData МетодОплатыТокенизацияДанные Нет Данные токенизации платежей для выбранного способа оплаты.

Пример

В этом примере ответа показано, как способ оплаты CARD , выбранный на платежной странице Google Pay, генерирует токен способа оплаты для шлюза в example .

{
  "type": "CARD",
  "description": "Visa •••• 1234",
  "info": {
    "cardNetwork": "VISA",
    "cardDetails": "1234"
  },
  "tokenizationData": {
    "type": "PAYMENT_GATEWAY",
    "token": "examplePaymentMethodToken"
  }
}

CardInfo

Данный объект предоставляет информацию о выбранной платежной карте.

Свойство Тип Всегда существует Описание
cardDetails нить Да Данные карты. Обычно это последние четыре цифры номера выбранного платёжного счёта.
assuranceDetails ГарантияДеталиХарактеристики Да Этот объект предоставляет информацию о проверке, выполненной для возвращенных платежных данных, если параметру assuranceDetailsRequired присвоено значение true в ПараметрыКарты .
cardNetwork нить Да

Платежная система выбранной карты. Возвращаемые значения соответствуют формату allowedCardNetworks в ПараметрыКарты .

Это значение сети карты не должно отображаться покупателю. Оно используется, когда требуются данные карты покупателя. Например, если службе поддержки клиентов требуется это значение для идентификации карты, которую покупатель использовал для транзакции. Для описания, видимого пользователю, используйте свойство description объекта PaymentMethodData .

billingAddress Адрес Нет Платежный адрес, связанный с предоставленным способом оплаты, если billingAddressRequired имеет значение true в ПараметрыКарты .
cardFundingSource нить Да

Источник пополнения карты для выбранного способа оплаты.

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

Пример

В этом примере показана карта в сети Visa.

{
  "cardNetwork": "VISA",
  "cardDetails": "1234",
  "cardFundingSource": "CREDIT",
  "assuranceDetails": {
    "cardHolderAuthenticated": false,
    "accountVerified": true
  }
}

ГарантияДеталиХарактеристики

Этот объект предоставляет информацию о том, какая проверка была выполнена в отношении возвращенных платежных данных, чтобы можно было применить соответствующие проверки риска инструмента.

Имя Тип Описание
accountVerified булев Если true , это означает, что проверка владельца Cardholder на предмет владения возвращенными платежными данными была выполнена.
cardHolderAuthenticated булев

Если true , это означает, что для возвращенных платежных данных была выполнена идентификация и проверка (ID&V).

Если false , может быть использована та же аутентификация с учётом риска, что и для транзакций по карте. Эта аутентификация с учётом риска может включать, помимо прочего, использование протокола 3D Secure, если применимо.

Вы можете получить и обработать объект ответа, даже если не используете поле assuranceDetails . Чтобы получить этот объект, добавьте assuranceDetailsRequired: true в поле запроса. ПараметрыКарты .

МетодОплатыТокенизацияДанные

Этот объект предоставляет данные токенизации для способа оплаты.

Свойство Тип Всегда существует Описание
type нить Да Тип токенизации, применяемый к выбранному способу оплаты. Это значение соответствует type заданному в PaymentMethodTokenizationSpecification .
token нить Нет

Сгенерированный токен способа оплаты.

Пример

Это пример токенизированного ответа, подготовленного для example шлюза.

{
  "type": "PAYMENT_GATEWAY",
  "token": "examplePaymentMethodToken"
}

Адрес

Этот объект предоставляет информацию о запрошенном почтовом адресе. Все свойства являются строками.

Адреса могут быть возвращены в форматах MIN , FULL и FULL-ISO3166 . Свойства каждого формата представлены в следующей таблице.

Свойство Формат адреса Описание
name MIN , FULL , FULL-ISO3166 Полное имя адресата.
postalCode MIN , FULL , FULL-ISO3166 Почтовый индекс.
countryCode MIN , FULL , FULL-ISO3166 Код страны ISO 3166-1 alpha-2.
phoneNumber MIN , FULL , FULL-ISO3166 Номер телефона, если в параметре phoneNumberRequired установлено значение true PaymentDataRequest .
address1 FULL , FULL-ISO3166 Первая строка адреса.
address2 FULL , FULL-ISO3166 Вторая строка адреса.
address3 FULL , FULL-ISO3166 Третья строка адреса.
locality FULL , FULL-ISO3166 Город, поселок, район или пригород.
administrativeArea FULL , FULL-ISO3166 Подразделение страны, например штат или провинция.
sortingCode FULL , FULL-ISO3166 Код сортировки.
iso3166AdministrativeArea FULL-ISO3166 Код административной зоны ISO 3166-2, соответствующий AdministrativeArea.

Пример

Это пример адреса в формате FULL-ISO3166 в США с несколькими строками данных адреса.

{
  "name": "John Doe",
  "address1": "c/o Google LLC",
  "address2": "1600 Amphitheatre Pkwy",
  "address3": "Building 40",
  "locality": "Mountain View",
  "administrativeArea": "CA",
  "countryCode": "US",
  "postalCode": "94043",
  "sortingCode": ""
  "iso3166AdministrativeArea": "US-CA"
}