Google Pay API теперь доступен во всем мире. Ознакомьтесь со списком поддерживаемых стран.

Чтобы переводить контент на ваш предпочитаемый язык, 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 вашего шлюза. Это означает, что каждый раз вызывать Google Pay API не придется. При этом платежные данные сохраняются в системе продавца для регулярных платежей. Регулярные платежи обрабатываются через API вашего шлюза.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Общие частые вопросы

Далее приведены ответы на часто задаваемые вопросы продавцов.

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

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

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

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

Если ваш PSP управляет всей логикой рисков и SCA, убедитесь, что ваша интеграция 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 и сайтов.

Если у вас есть интеграция с Android, вы можете указать в описании в Google Play, что теперь поддерживаете Google Pay. Если же тип вашей платформы – сайт, разместите на нем информацию о том, что принимаете оплату через 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?

Согласно правилам Google Play, разработчики товаров и приложений для Android должны использовать сервис "Оплата контента через 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 нет специального идентификатора. В вашей системе они будут отображаться как обычные учетные данные FPAN.

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

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

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

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

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

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

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

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

Какая конфигурация 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 Web API?

Если на вашем сайте действует строгая политика 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 применяет этот атрибут ко всем динамически добавляемым элементам <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 Google. Эти ресурсы могут быть полезны для вашей документации по соблюдению требований и для обеспечения большей прозрачности для ваших пользователей.