Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Часто задаваемые вопросы

В этой статье приведена общая информация о Google Pay API и ответы на часто задаваемые вопросы о нем.

О Google Pay API

Google Pay позволяет клиентам легко оплачивать покупки на вашем сайте или в приложении. Google Pay API позволяет клиентам использовать для оплаты на вашем сайте или в приложении карты, данные которых они сохранили в своих аккаунтах Google.

Как обратиться в службу поддержки

Зарегистрируйтесь в Google Pay & Wallet Console и выберите "Служба поддержки". Мы поможем устранить неполадки с интеграцией. Вы также можете изучить наши руководства по устранению неполадок для Android и веб-платформ, чтобы решить проблему самостоятельно.

Поддерживаемые функции

После внедрения Google Pay API вашим клиентам станут доступны специальные возможности. Подробнее о них рассказывается ниже.

Доступные способы оплаты

Google Pay API может возвращать карты или сетевые токены.

Подписки и регулярные платежи

Поддержка абонентской платы зависит от способа оплаты, указанного в ответе Google Pay API. используя как токенизированные карты, так и обычные, связанные с аккаунтом Google, для абонентской платы. Для обработки абонентской платы продавцу не нужно вызывать наш API с определенной периодичностью. При этом платежные данные сохраняются в системе продавца. Продавец использует API своего платежного шлюза для управления абонентской платой.

Регулярные платежи поддерживаются в Google Pay, если выполняются следующие условия:

Продавец соблюдает правила сети, например требования в отношении транзакций, инициированных продавцом.
Условия оплаты раскрываются и принимаются пользователем в процессе покупки.

Мы также поддерживаем абонентскую плату с переменной суммой. например ежемесячная оплата мобильной связи. Получить более подробную информацию можно у представителей платежного шлюза.

Автоматическое пополнение счета

Ваши клиенты могут настроить автоматическое пополнение счета на одну и ту же сумму. Платежные данные сохраняются в системе продавца и используются повторно. Получить более подробную информацию можно у представителей платежного шлюза.

Возвратные платежи

Продавцы могут отменять транзакции в случае отмены заказа, возврата средств или спора так же, как и при возврате средств за другие способы оплаты. Чтобы получить более подробную информацию, продавцам необходимо связаться с представителем платежной системы.

Сбор пожертвований

Одобренные некоммерческие организации могут внедрить на свой сайт Google Pay API и собирать пожертвования с помощью этого инструмента. Однако сначала им нужно подтвердить свой статус. Например, некоммерческие организации из США должны предоставить действительное подтверждение статуса 501(c)3 от Налогового управления США.

Условия и правила

Условия использования Google Pay API

Все продавцы должны принять Условия использования Google Pay API и соблюдать их.

Правила допустимого использования Google Pay API

Все продавцы должны принять правила допустимого использования Google Pay API и соблюдать их.

Правила в отношении азартных игр

Наши правила в отношении азартных игр описаны в правилах допустимого использования Google Pay API.

Правила в отношении азартных игр могут время от времени меняться. Все материалы проходят проверку и должны быть одобрены.

Мы принимаем интеграции с азартными играми от компаний, зарегистрированных в следующих странах:

Австралия
Австрия
Канада
Чехия
Франция
Грузия
Германия
Греция
Венгрия
Ирландия
Италия
Япония
Нидерланды
Польша
Португалия
Румыния
Испания
Швеция
Великобритания

Возможно, в будущем ситуация изменится.

Чтобы получить доступ к рабочей версии Google Pay API для интеграции с азартными играми, необходимо выполнить ряд требований:

Если вы интегрировали азартные игры только в приложения для Android и находитесь в одной из упомянутых выше стран, сначала вам нужно соблюсти правила Google Play в отношении азартных игр и пройти проверку. После этого мы сможем оценить вашу интеграцию только для Android и предоставить вам доступ к рабочей версии Google Pay API.
Если вы интегрировали азартные игры только на сайте и находитесь в одной из упомянутых выше стран, то при регистрации в Google Pay API вам нужно будет предоставить действующую лицензию, подтверждающую ваше право предлагать услуги, связанные с азартными играми, в этой стране. После этого мы сможем оценить вашу интеграцию только для сайтов и предоставить вам доступ к рабочей версии Google Pay API.
Если вы интегрировали азартные игры для Android и веб-сайтов в одной из упомянутых выше стран, сначала вам нужно соблюдать правила Google Play в отношении азартных игр и пройти проверку. После этого мы сможем оценить ваши интеграции для Android и сайтов и предоставить вам доступ к рабочей версии Google Pay API.

Страны с особыми условиями или ограничениями

Интеграция азартных игр разрешена в перечисленных ниже странах, если соблюдаются следующие требования:

Страна	Требования для интеграции с Android	Требования для интеграции с сайтом
Болгария	Да, с ограничениями: Приложения, которые перенаправляют на сайт, соответствуют требованиям. Запрещены приложения, которые не перенаправляют на сайт.	Да
Кипр	Да, с ограничениями: Государственная лотерея соответствует требованиям. OPAP Cyprus Limited соответствует требованиям. Онлайн-казино запрещены. Игровые автоматы запрещены. Ставки на скачки запрещены. Ставки на собачьи бега запрещены. Финансовые пари запрещены. Биржи ставок запрещены.	Да, с ограничениями: Государственная лотерея соответствует требованиям. OPAP Cyprus Limited соответствует требованиям. Онлайн-казино запрещены. Игровые автоматы запрещены. Ставки на скачки запрещены. Ставки на собачьи бега запрещены. Финансовые пари запрещены. Биржи ставок запрещены.
Финляндия	Да, с ограничениями: Veikkaus Oy соответствует требованиям.	Да, с ограничениями: Veikkaus Oy соответствует требованиям.
Казахстан	Да, с ограничениями: Лотереи допускаются. Ставки на спорт разрешены. Тотализаторы разрешены. Онлайн-казино запрещены. Электронные казино запрещены.	Да, с ограничениями: Лотереи допускаются. Ставки на спорт разрешены. Тотализаторы разрешены. Онлайн-казино запрещены. Электронные казино запрещены.
Польша	Нет	Да, с ограничениями: Лицензированные операторы азартных игр.
ЮАР	Да, с ограничениями: Ставки на спорт в интернете разрешены.	Да, с ограничениями: Ставки на спорт в интернете разрешены.

Если вы хотите добавить поддержку Google Pay API в стране, в которой она ранее не была одобрена, свяжитесь с нами. Обратите внимание, что вам потребуется предоставить лицензию на организацию азартных игр для каждой страны, в которой вы планируете предлагать услуги, связанные с азартными играми. Мы не разрешаем использовать Google Pay API для сервисов азартных игр, если они предназначены для лиц, не достигших совершеннолетия, или для тех, кому запрещено играть в азартные игры в соответствии с местным законодательством.

Правила в отношении медицинских услуг

Правила в отношении медицинских услуг определены в правилах допустимого использования Google Pay API.

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

Правила в отношении финансовых услуг

Правила в отношении финансовых услуг определены в правилах допустимого использования Google Pay API.

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

Общие вопросы

Ниже приведены ответы на вопросы продавцов.

Я пользуюсь услугами крупного поставщика платежных услуг для управления всеми рисками и строгой аутентификации клиентов. Что мне следует знать о GPay?

Google Pay API передает информацию о способах оплаты в виде полезной нагрузки с подписанными и зашифрованными данными. Возвращаемые способы оплаты состоят из PAN или из токенизированных карт, изготовленных из PAN устройств (DPAN) и криптограмм.

Полезная нагрузка токенизированных карт обрабатывается без дополнительных шагов и запросов.

Полезные нагрузки карт, которые состоят из PAN, требуют авторизации через 3D Secure с помощью собственных и предоставленных поставщиком платежных услуг решений.

Если ваш поставщик платежных услуг управляет тем, как выстроено управление рисками и строгая аутентификация клиентов, убедитесь, что ваша интеграция Google Pay API включает следующие параметры:

merchantInfo.merchantName (Android, веб-платформа): название продавца, которое отображается на странице оплаты.
transactionInfo.countryCode (Android, веб-платформа): где обрабатывается транзакция. В него нужно добавить страну банка-эквайера.
transactionInfo.totalPrice (Android, веб-платформа): общая денежная ценность транзакции с возможностью округления до двух знаков после запятой.

Как получить идентификатор продавца Google?

Идентификатор продавца Google можно получить после того, как Google одобрит ваш сайт. Чтобы начать, войдите в Google Pay & Wallet Console и создайте интеграцию Google Pay API. Вам нужно предоставить список полных доменных имен, включая поддомены, которые помогают вызывать Google Pay API.

Можно ли использовать один и тот же идентификатор продавца для разных брендов и каналов (сайта и приложения)?

Да, использовать один и тот же идентификатор продавца для нескольких брендов и платформ (например, для сайта и приложения Android) можно. Мы рекомендуем это делать, чтобы упростить сверку.

Как сообщить пользователям, что на моем сайте принимается оплата через Google Pay?

Чтобы подчеркнуть поддержку Google Pay, используйте материалы, приведенные в правилах использования бренда в приложениях Android и на сайтах.

Если вы интегрировали Google Pay в приложение для Android, добавьте в описание в Google Play информацию о том, что теперь поддерживаете этот сервис. Если же тип вашей платформы – сайт, разместите на нем информацию о том, что принимаете оплату через Google Pay.

Можно ли внедрить оплату через Google Pay на платформах электронной торговли?

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

Какие поставщики платежных услуг поддерживают Google Pay?

Список обработчиков платежей, которые проводят транзакции через Google Pay, приведен здесь.

В каких странах и регионах поддерживается Google Pay?

Страны, в которых можно расплачиваться через Google Pay на сайтах и в приложениях, перечислены здесь.

В каких странах и регионах при оплате через Google Pay могут использоваться токены, аутентифицированные с помощью криптограммы 3-D Secure?

Список стран, где местные банки поддерживают токенизацию с помощью криптограммы 3-D Secure (CRYPTOGRAM_3DS), представлен здесь. Из нее вы также узнаете, какими картами можно расплачиваться, а какими – нет.

Чем Оплата контента через Google Play отличается от Google Pay API?

Разработчики, продающие цифровые товары и услуги в приложениях для Android через Google Play, должны использовать сервис "Оплата контента через Google Play", как указано в Центре правил для разработчиков Google Play. Примеры оплаты контента через приложения: виртуальные игровые товары, функции или контент приложений, а также облачные программные продукты. С более подробным обзором сервиса можно ознакомиться здесь.

Google Pay API используется для продажи нецифровых товаров и услуг через приложения.

Взимаются ли с продавцов какие-либо комиссии?

Google Pay не взимает с пользователей, продавцов и разработчиков дополнительную плату за использование Google Pay API для платежей. Однако с продавцов могут взимать комиссию обработчики платежей.

Как компания Google проверяет сведения о картах и предотвращает мошенничество?

Все карты, добавленные в Google, проходят авторизацию для проверки реквизитов, в том числе проверочного кода карты (CVC). Google также использует собственную систему оценки рисков, основанную на данных инструментов, профилях аккаунтов Google, истории покупок, местоположении и информации об устройстве. Кроме того, при обработке транзакций, выполненных через Google Pay, продавцы должны сами оценивать риски и возможность мошенничества.

Поддерживается ли Google Pay в элементах WebView для мобильных приложений?

Элементы WebView в Android полностью поддерживают Google Pay и имитируют мобильный веб-интерфейс, если вы добавите необходимую зависимость WebKit. Однако в WebView для iOS API isReadyToPay всегда возвращает значение false из-за ограничений iOS на сторонние файлы cookie. Как приложение Android, так и домен сайта в WebView должны быть одобрены для доступа к рабочей версии. Подробные инструкции по реализации приведены в документации Использование Android WebView и Использование iOS WKWebview.

Моего процессора нет в списке. Можно ли интегрировать Google Pay?

Google Pay постоянно расширяет партнерскую сеть, сотрудничая с платформами электронной торговли и платежными системами. Если вы не можете найти нужную платежную систему на странице g.co/pay/processors, отправьте запрос. Когда процессор станет доступен, вы получите уведомление.

Как включить Google Pay, если у меня уже есть платежный процессор или платформа для обработки платежей?

Google Pay работает с различными поставщиками платежных услуг и поставщиками платформ электронной торговли. Для каждого из них есть подробная документация, которая поможет вам начать работу, а также основное руководство для легкой регистрации.

Как предложить Google Pay продавцам, если я поддерживаемый обработчик платежей?

Поддерживаемые платежные системы могут реализовать наше серверное решение для оплаты в веб-интеграциях. Благодаря размещенной странице оплаты ваши клиенты могут предлагать своим покупателям Google Pay и не проходить отдельную регистрацию в Google Pay.

Чтобы начать, вам нужно зарегистрироваться в качестве поддерживаемого обработчика платежей. Чтобы интегрировать страницу оплаты с сайтом продавца, обратитесь к техническому специалисту Google, который помогал вам с регистрацией.

Как Google Pay учитывает разные варианты доставки и цены, если я предлагаю доставку в процессе оформления заказа?

Для интеграции с сайтом вам потребуется адрес доставки. Разные варианты доставки и цены на них можно указать в объектах PaymentDataRequest, PaymentOptions и PaymentDataCallbacks. Пример можно найти в демонстрационном видео о динамическом обновлении цены.

Для интеграции с Android требуется указать адрес доставки в объекте PaymentDataRequest.

Как получать деньги за покупки, совершенные с помощью Google Pay?

Google Pay API помогает проводить транзакции, передавая платежные данные от пользователей вашему поставщику платежных услуг. Он не связан с денежными потоками и предназначен для работы поверх существующей платежной инфраструктуры.

Какие требования нужно выполнить, чтобы получить доступ к рабочей версии?

Продавцы должны создать профиль компании в Google Pay & Wallet Console и загрузить скриншоты процесса покупки для проверки. Каждый домен, на котором размещен Google Pay API, необходимо отправлять на проверку отдельно, поскольку домены с подстановочными знаками (например, *.merchant.com) не принимаются. Подробнее о публикации интеграции для Android и/или веб-приложений…

Как узнать статус заявки на интеграцию и нужно ли вносить изменения после проверки?

После того как вы отправите интеграцию Google Pay API на проверку, вы получите электронное письмо с результатами. Если интеграция соответствует правилам допустимого использования и руководству по использованию бренда, она будет одобрена и в Google Pay & Wallet Console получит статус Активно. Если в нем нужно что-то изменить, статус будет Требуется дополнительная информация, а в письме будет указано, что именно нужно исправить, прежде чем отправлять форму повторно. Если у вас возникнут вопросы, вы можете обратиться в службу поддержки прямо из Google Pay & Wallet Console.

Что делать, если при интеграции Google Pay API появляется сообщение об ошибке?

Чтобы узнать о распространенных кодах ошибок и способах их устранения, ознакомьтесь с руководствами по устранению неполадок для Android и веб-платформ. Если у вас возникнут вопросы, обратитесь в службу поддержки через Google Pay & Wallet Console.

Как настроить интеграцию с Google Pay API, чтобы ограничить использование карт?

Все настройки карточек доступны в объекте CardParameters как для Android, так и для веб-версии. Например, вы можете выбрать, какие платежные системы и страны эмитентов карт хотите разрешить.

Что такое Google Pay API

Google Pay API позволяет клиентам оплачивать покупки одним нажатием кнопки, используя способы оплаты, сохраненные в аккаунте Google. API позволяет миллионам пользователей с сотнями миллионов сохраненных карт оплачивать покупки одним нажатием кнопки. Она обеспечивает повышенную безопасность, поскольку платежные данные клиентов подвергаются сквозному шифрованию при передаче с серверов Google в ваш обработчик платежей. Инструмент Google Pay совместим с вашей имеющейся системой обработки платежей. Чтобы его интегрировать, нужно добавить всего несколько строчек кода.

Как связаны Google Pay API и Google Wallet API?

Google Pay API и Google Wallet API – это два разных API. Google Pay API позволяет клиентам использовать Google Pay в качестве способа оплаты на вашем сайте или в приложении Android. Google Wallet API позволяет разработчикам создавать и управлять цифровыми пропусками для различных целей. Например, карты постоянного клиента, билеты, пропуска, медицинские карты и другие настраиваемые объекты. Подробную информацию о Google Wallet API можно найти в документации для разработчиков.

Какая версия Google Pay API используется сейчас и как выполняются обновления?

Текущая версия указана в документации по Android и веб-версии. Google поддерживает эту версию уже несколько лет, добавляя в нее только новые функции и необязательные поля. Все обновления API обратно совместимы, поэтому текущие интеграции не будут нарушены.

На каких платформах поддерживаются DPAN (CRYPTOGRAM_3DS), а на каких – FPAN (PAN_ONLY)?

DPAN – это идентификаторы, которые используются только на устройствах Android и доступны только при оформлении покупки на таких устройствах или в мобильном браузере Android/WebView. На компьютерах и устройствах iOS не поддерживаются DPAN, поэтому по умолчанию будет возвращаться значение PAN_ONLY.

Как отличить DPAN от FPAN и как их обрабатывать?

Объект assuranceDetails предназначен не для того, чтобы строго различать DPAN и FPAN, а для того, чтобы помочь продавцам определить, нужно ли усилить аутентификацию клиента с помощью 3D Secure, чтобы соответствовать требованиям к строгой аутентификации клиентов (SCA). Чтобы получать эти данные, продавцам необходимо добавить assuranceDetailsRequired: true в параметр Card в запросе Google Pay API.

В чем разница между cardHolderAuthenticated и accountVerified?

Если в запросе для параметра assuranceDetailsRequired задано значение true, в ответе будут два свойства:

accountVerified: указывает, что карта, использованная для оплаты, действительна, а аккаунт не заблокирован. Однако одной лишь проверки недостаточно для защиты авторизации.
cardHolderAuthenticated – пользователь начал транзакцию на устройстве Android и использовал предоставленный сетевой токен на основе устройства.

Как эти флаги используются для запуска 3D Secure?

Продавцам следует использовать эти флаги при создании логики запуска 3D Secure. Если оба параметра cardHolderAuthenticated и accountVerified возвращают значение true, учетные данные считаются очень надежными и соответствующими требованиям SCA. В этом случае не нужно выполнять дополнительную аутентификацию 3DS.

Будут ли продавцы получать токены электронной торговли, если зададут значение assuranceDetailsRequired: true?

Нет, токены электронной торговли контролируются на уровне поставщика платежных услуг.

Распространяется ли перенос ответственности на транзакции Google Pay?

Доступность переноса ответственности зависит от платежной системы. Подробнее о том, как включить перенос ответственности Visa…

Как определить транзакции, совершенные с помощью сервиса "Покупай сейчас – плати потом" (BNPL)?

В настоящее время для транзакций BNPL нет специального идентификатора. В вашей системе они будут отображаться как обычные учетные данные FPAN.

Может ли Google предоставить тестовые карты для проверки сценариев SCA?

Google Pay API не может напрямую предоставлять тестовые карты для строгой аутентификации клиента. Ваш поставщик платежных услуг должен предоставить вам доступ к набору тестовых карт в изолированной среде.

Каков срок действия или время жизни зашифрованных платежных данных?

Зашифрованная полезная нагрузка Google Pay действительна ровно одну неделю. Продавцы, которые работают с отложенной авторизацией или асинхронной обработкой, должны убедиться, что платеж авторизован у поставщика платежных услуг (PSP) в течение этого периода до истечения срока действия полезной нагрузки.

Как обрабатываются операции после покупки, например возвраты и повторные авторизации?

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

Как динамическое ценообразование работает с транзакциями, инициированными продавцом?

В настоящее время транзакции, инициированные продавцом, не поддерживают динамическое ценообразование. Это известное ограничение.

Какая конфигурация Content Security Policy (CSP) требуется для Google Pay в WebView?

Если вы используете Content Security Policy (CSP), убедитесь, что для директивы connect-src заданы правильные значения, чтобы Google Pay можно было использовать в WebView. Пример:

Content-Security-Policy: connect-src pay.google.com google.com account.google.com www.google.com

Как использовать однократно используемый номер Content Security Policy (CSP) с Google Pay API для сайтов?

Если на вашем сайте действует строгая политика CSP, требующая одноразовых номеров для выполнения скриптов и динамически внедряемых стилей:

Добавьте атрибут CSP nonce в тег <script>, который загружает pay.js:

<script
  async
  src="https://pay.google.com/gp/p/js/pay.js"
  nonce="your-nonce-value"
  onload="onGooglePayLoaded()">
</script>

Передайте свойство nonce в PaymentOptions при создании экземпляра PaymentsClient:

const paymentsClient = new google.payments.api.PaymentsClient({
  environment: 'TEST',
  nonce: 'your-nonce-value'
});

Google Pay применяет атрибут nonce ко всем динамически внедряемым элементам <style> и <script>, включая стили кнопок, созданные с помощью createButton().

Использует ли Google Pay API файл cookie NID во время оформления заказа?

Нет. Файл cookie NID не используется для оформления заказа через Google Pay API и не поддерживает его.

Файл cookie NID связан с серверным сервисом Google, предназначенным для хранения персонализированных данных пользователей, которые не вошли в аккаунт Google.

Основные функции сервиса, в том числе безопасность, предотвращение мошенничества и надежность сервиса, работают независимо от файла cookie NID. Google Pay API разработан таким образом, чтобы обеспечивать безопасность и надежность для продавцов и пользователей независимо от наличия этого файла cookie.

Google стремится защищать конфиденциальность пользователей и обрабатывает эти файлы cookie в соответствии с Политикой конфиденциальности и Политикой в отношении технологий и файлов cookie. Эти ресурсы могут быть полезны для вашей документации по соблюдению нормативных требований и для обеспечения большей прозрачности для пользователей.