Настройка обработчика платежей Google Pay

Данная справочная информация основана на схеме объекта конфигурации обработчика платежей Google Pay для протокола Universal Commerce Protocol (UCP).

{
  "api_version": 2,
  "api_version_minor": 0,
  "environment": "TEST" | "PRODUCTION",
  "merchant_info": {
    "merchant_id": string,
    "merchant_name": string,
    "merchant_origin": string,
    "auth_jwt": string
  },
  "allowed_payment_methods": [
    {
      "type": "CARD",
      "parameters": {
        "allowed_auth_methods": [
          "PAN_ONLY"
        ],
        "allowed_card_networks": [
          "AMEX" | "DISCOVER" | "ELECTRON" | "ELO" | "ELO_DEBIT" | "INTERAC" | "JCB" | "MAESTRO" | "MASTERCARD" | "VISA"
        ],
        "allow_prepaid_cards": boolean,
        "allow_credit_cards": boolean,
        "assurance_details_required": boolean,
        "billing_address_required": boolean,
        "billing_address_parameters": {
          "format": "MIN" | "FULL" | "FULL-ISO3166",
          "phone_number_required": boolean
        }
      },
      "tokenization_specification": {
        "type": "PAYMENT_GATEWAY" | "DIRECT",
        "parameters": {
          ...
        }
      }
    }
  ]
}

Характеристики

Свойство Тип Необходимость Описание
api_version целое число Необходимый Основная версия API Google Pay. Поддерживается только 2 .
api_version_minor целое число Необходимый Незначительная версия API Google Pay. Поддерживается только 0 .
environment нить Необходимый Среда Google Pay, которую следует использовать.
  • TEST : Только для тестирования платежных данных.
  • PRODUCTION : Реальные, авторизуемые платежные данные.
merchant_info объект Необходимый Идентификационные данные продавца.
merchant_info. merchant_id нить Необходимый Ваш идентификатор продавца Google Pay из консоли Google Pay & Wallet . Это необходимо для PRODUCTION среды. В TEST среде это необязательно и игнорируется.
merchant_info. merchant_name нить Необязательный Название компании, с которой взаимодействуют пользователи.
merchant_info. merchant_origin нить Необязательный Полное доменное имя веб-сайта, где происходит оформление заказа (формат: hostname ).
merchant_info. auth_jwt нить Необязательный Авторизационный JWT для определенных контекстов интеграции.
allowed_payment_methods объект[ ] Необходимый Доступные способы оплаты для данной транзакции.
allowed_payment_methods[]. type нить Необходимый Поддерживаемые способы оплаты. Поддерживаются только CARD .
allowed_payment_methods[]. parameters объект Необходимый Параметры, необходимые для настройки способа оплаты CARD .
allowed_payment_methods[].parameters. allowed_auth_methods нить[ ] Необходимый Поддерживаемые поля для аутентификации карточных транзакций.
  • PAN_ONLY : Возвращает основной номер счета (PAN) и срок действия карты, сохраненной в Google Wallet.
allowed_payment_methods[].parameters. allowed_card_networks нить[ ] Необходимый Платежные системы, поддерживаемые продавцом. Поддерживаемые значения: AMEX , DISCOVER , ELECTRON , ELO , ELO_DEBIT , INTERAC , JCB , MAESTRO , MASTERCARD , VISA .
allowed_payment_methods[].parameters. allow_prepaid_cards логический Необязательный Установите значение false , если вы не поддерживаете предоплаченные карты. По умолчанию — true .
allowed_payment_methods[].parameters. allow_credit_cards логический Необязательный Установите значение false , если вы не поддерживаете кредитные карты. По умолчанию — true .
allowed_payment_methods[].parameters. assurance_details_required логический Необязательный Установите значение true , чтобы запросить данные для подтверждения платежеспособности карты.
allowed_payment_methods[].parameters. billing_address_required логический Необязательный Установите значение true , если для завершения транзакции требуется платежный адрес.
allowed_payment_methods[].parameters. billing_address_parameters объект Необязательный Параметры, определяющие возвращаемый платежный адрес.
allowed_payment_methods[].parameters.billing_address_parameters. format нить Необязательный Для завершения транзакции необходим указанный формат платежного адреса.
  • MIN : Название, код страны и почтовый индекс (по умолчанию).
  • FULL : Имя, адрес, населенный пункт, регион, код страны и почтовый индекс.
  • FULL-ISO3166 : Название, адрес, населенный пункт, регион, код страны, почтовый индекс и iso3166AdministrativeArea .
allowed_payment_methods[].parameters.billing_address_parameters. phone_number_required логический Необязательный Установите значение true , если для завершения транзакции требуется номер телефона.
allowed_payment_methods[]. tokenization_specification объект Необходимый Настройки, определяющие способ возврата вам платежных данных.
allowed_payment_methods[].tokenization_specification. type нить Необходимый Тип токенизации.
  • PAYMENT_GATEWAY : Используется, если вы обрабатываете платежи через [поддерживаемый платежный шлюз](/pay/api#participating-processors). Возвращает зашифрованные данные для передачи вашему платежному процессору.
  • DIRECT : Используется, если вы расшифровываете учетные данные самостоятельно (требуется соответствие стандарту PCI DSS уровня 1).
allowed_payment_methods[].tokenization_specification. parameters объект Необходимый Параметры, специфичные для выбранного type токенизации.

Для PAYMENT_GATEWAY необходимы следующие параметры: Для DIRECT необходимы следующие параметры: