Настройка обработчика платежей 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,
        "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 Целое число Обязательно Основная версия Google Pay API. Поддерживается только 2.
api_version_minor Целое число Обязательно Дополнительная версия Google Pay API. Поддерживается только 0.
environment string Обязательно Среда Google Pay, которую нужно использовать.
  • TEST: платежные данные, предназначенные только для тестирования.
  • PRODUCTION – настоящие платежные данные, которые можно авторизовать.
merchant_info Объект Обязательно Идентификационные данные продавца.
merchant_info.merchant_id string Обязательно Идентификатор продавца Google Pay из Google Pay & Wallet Console. Это необходимо для среды PRODUCTION. Это необязательный параметр, который игнорируется в среде TEST. Идентификатор продавца – это цифровое или буквенно-цифровое значение, которое показывается рядом с названием вашей компании в Google Pay & Wallet Console.
merchant_info.merchant_name string Необязательно Пользовательское название компании продавца.
merchant_info.merchant_origin string Необязательно Полное доменное имя сайта, на котором происходит оплата (формат: hostname).
merchant_info.auth_jwt string Необязательно Токен JWT для авторизации в определенных контекстах интеграции.
allowed_payment_methods object[ ] Обязательно Способы оплаты, разрешенные для этой транзакции.
allowed_payment_methods[].type string Обязательно Тип поддерживаемого способа оплаты. Допустимые значения: CARD, EWALLET.
allowed_payment_methods[].parameters Объект Необязательно Параметры, необходимые для настройки способа оплаты CARD. Это свойство обязательно, если для типа type выбран вариант CARD.
allowed_payment_methods[].parameters.allowed_auth_methods string[ ] Обязательно Поля, поддерживаемые для аутентификации транзакции по карте.
  • PAN_ONLY – возвращает основной номер счета (PAN) и дату окончания срока действия карты, сохраненной в Google Кошельке.
allowed_payment_methods[].parameters.allowed_card_networks string[ ] Обязательно Платежные системы, которые поддерживает продавец. Допустимые значения: 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.billing_address_required Логическое значение Необязательно Установите значение true, если для завершения транзакции требуется платежный адрес.
allowed_payment_methods[].parameters.billing_address_parameters Объект Необязательно Параметры, которые настраивают возвращаемый платежный адрес.
allowed_payment_methods[].parameters.billing_address_parameters.format string Необязательно Для завершения транзакции требуется указать платежный адрес.
  • MIN – имя, код страны и почтовый индекс (по умолчанию).
  • FULL – имя, почтовый адрес, населенный пункт, регион, код страны и почтовый индекс.
  • FULL-ISO3166 – название, почтовый адрес, населенный пункт, регион, код страны, почтовый индекс и iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required Логическое значение Необязательно Установите значение true, если для завершения транзакции требуется номер телефона.
allowed_payment_methods[].tokenization_specification Объект Необязательно Конфигурация, определяющая, как вам возвращаются платежные данные. Это свойство обязательно, если для типа type выбран вариант CARD.
allowed_payment_methods[].tokenization_specification.type string Обязательно Тип токенизации.
  • PAYMENT_GATEWAY – если вы обрабатываете платежи через [поддерживаемый платежный шлюз](/pay/api#participating-processors). Возвращает зашифрованную полезную нагрузку, которую нужно передать поставщику платежных услуг.
  • DIRECT – используется, если вы самостоятельно расшифровываете учетные данные (требуется соответствие стандарту PCI DSS уровня 1).
allowed_payment_methods[].tokenization_specification.parameters Объект Обязательно Параметры, относящиеся к выбранной токенизации type.

Для PAYMENT_GATEWAY обязательными являются следующие параметры: Для DIRECT обязательными являются следующие параметры:
allowed_payment_methods[].processing_specification Объект Необязательно Укажите информацию, необходимую для обработки платежа. Это свойство обязательно, если для типа type выбран вариант EWALLET.
allowed_payment_methods[].processing_specification.type string Обязательно Тип поставщика услуг электронного кошелька. Допустимые значения: SHOPEE_PAY, TOUCH_N_GO.
allowed_payment_methods[].processing_specification.parameters Объект Обязательно Параметры, относящиеся к выбранному поставщику электронного кошелька.

Обязательные параметры:
  • ewallet_merchant_name – название продавца, которое показывается пользователям.
  • ewallet_merchant_account – идентификатор продавца, выданный электронным кошельком или агрегатором.
  • psp_transaction_reference – уникальный ссылочный номер, созданный PSP для обеспечения идемпотентности.