Google Pay

Google Pay™ позволяет клиентам осуществлять платежи в вашем приложении или на веб-сайте с помощью любой кредитной или дебетовой карты, сохраненной в их учетной записи Google, в том числе из Google Play, YouTube, Chrome или устройства Android.

Google Pay™ полностью совместим с продуктами и функциями theMAP, что позволяет вам использовать его вместо традиционной формы оплаты при любой возможности. Используйте его для приема платежей за физические или цифровые товары, пожертвования, подписки и многое другое. Платежи за цифровые товары применимы только для Web и мобильных Web-платежей.

При использовании формы оплаты theMAP, Продавцу нет необходимости проводить интеграцию с Google Pay™, этот метод оплаты доступен по-умолчанию.

Также есть возможность размещения кнопки для оплаты Google Pay™ на стороне Продавца. Этот вариант требует интеграции Продавца с Google Pay™.

Принцип работы

  1. Клиент выбирает кнопку Google Pay. Используя Google API, ваша система инициирует запрос Google Pay, идентифицирующий кибер-ресурс как ваш платежный шлюз, передавая ваш идентификатор продавца CyberSource в качестве идентификатора продавца шлюза.
  2. Клиент подтверждает оплату. Google API связывается со службами Google Pay. Генерируется токен на платежной сети.
  3. Google создает зашифрованные данные платежа, используя специальный ключ шлюза, который предоставляется в запросе кошелька и включает его в ответ Google API.
  4. Ваша система готовит данные Google Pay для отправки в службу theMAP. PaymentData, полученная от Google API, шифруется алгоритмом base64 и передается в качестве параметра GooglePayToken в методы Pay и Block.
  5. theMAP возвращает ответ авторизации для вашей системы.
  6. Ваша система возвращает авторизационный ответ в платежное приложение/сайт. Платежное приложение/сайт отображает подтверждение или сообщение об отказе для клиента.

Интеграция

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

  • Руководство интеграции в Web-сайт.
  • Используйте чек-лист для проверки выполнения всех необходимых шагов в интеграции с Web.
  • Следуйте инструкциям, которые помогут вам правильно разместить элементы бренда Google Pay на Web-сайтах.

Пример токенизации:

const tokenizationSpecification = {
  type: 'PAYMENT_GATEWAY',
  parameters: {
    'gateway': 'themap',
    'gatewayMerchantId': 'exampleGatewayMerchantId'
  }
}
  • gateway: themap
  • gatewayMerchantId: Public ID, выдается через саппорт theMAP

Пример установки платежных систем, поддерживаемых Google Pay и theMAP:

const allowedCardNetworks = ["AMEX", "JCB", "MASTERCARD", "VISA"];

Взаимодействие с theMAP

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

{
  "protocolVersion":"ECv2",
  "signature":"MEQCIH6Q4OwQ0jAceFEkGF0JID6sJNXxOEi4r+mA7biRxqBQAiAondqoUpU/bdsrAOpZIsrHQS9nwiiNwOrr24RyPeHA0Q\u003d\u003d",
  "intermediateSigningKey":{
    "signedKey": "{\"keyExpiration\":\"1542323393147\",\"keyValue\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE/1+3HBVSbdv+j7NaArdgMyoSAM43yRydzqdg1TxodSzA96Dj4Mc1EiKroxxunavVIvdxGnJeFViTzFvzFRxyCw\\u003d\\u003d\"}",
    "signatures": ["MEYCIQCO2EIi48s8VTH+ilMEpoXLFfkxAwHjfPSCVED/QDSHmQIhALLJmrUlNAY8hDQRV/y1iKZGsWpeNmIP+z+tCQHQxP0v"]
  },
  "signedMessage":"{\"tag\":\"jpGz1F1Bcoi/fCNxI9n7Qrsw7i7KHrGtTf3NrRclt+U\\u003d\",\"ephemeralPublicKey\":\"BJatyFvFPPD21l8/uLP46Ta1hsKHndf8Z+tAgk+DEPQgYTkhHy19cF3h/bXs0tWTmZtnNm+vlVrKbRU9K8+7cZs\\u003d\",\"encryptedMessage\":\"mKOoXwi8OavZ\"}"
}

Токен необходимо без каких-либо модификаций закодировать с помощью Base64 и отправить в theMAP. Пример закодированного в Base64 токена:

ewogICJwcm90b2NvbFZlcnNpb24iOiJFQ3YyIiwKICAic2lnbmF0dXJlIjoiTUVRQ0lINlE0T3dRMGpBY2VGRWtHRjBKSUQ2c0pOWHhPRWk0cittQTdiaVJ4cUJRQWlBb25kcW9VcFUvYmRzckFPcFpJc3JIUVM5bndpaU53T3JyMjRSeVBlSEEwUVx1MDAzZFx1MDAzZCIsCiAgImludGVybWVkaWF0ZVNpZ25pbmdLZXkiOnsKICAgICJzaWduZWRLZXkiOiAie1wia2V5RXhwaXJhdGlvblwiOlwiMTU0MjMyMzM5MzE0N1wiLFwia2V5VmFsdWVcIjpcIk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRS8xKzNIQlZTYmR2K2o3TmFBcmRnTXlvU0FNNDN5UnlkenFkZzFUeG9kU3pBOTZEajRNYzFFaUtyb3h4dW5hdlZJdmR4R25KZUZWaVR6RnZ6RlJ4eUN3XFx1MDAzZFxcdTAwM2RcIn0iLAogICAgInNpZ25hdHVyZXMiOiBbIk1FWUNJUUNPMkVJaTQ4czhWVEgraWxNRXBvWExGZmt4QXdIamZQU0NWRUQvUURTSG1RSWhBTExKbXJVbE5BWThoRFFSVi95MWlLWkdzV3BlTm1JUCt6K3RDUUhReFAwdiJdCiAgfSwKICAic2lnbmVkTWVzc2FnZSI6IntcInRhZ1wiOlwianBHejFGMUJjb2kvZkNOeEk5bjdRcnN3N2k3S0hyR3RUZjNOclJjbHQrVVxcdTAwM2RcIixcImVwaGVtZXJhbFB1YmxpY0tleVwiOlwiQkphdHlGdkZQUEQyMWw4L3VMUDQ2VGExaHNLSG5kZjhaK3RBZ2srREVQUWdZVGtoSHkxOWNGM2gvYlhzMHRXVG1adG5ObSt2bFZyS2JSVTlLOCs3Y1pzXFx1MDAzZFwiLFwiZW5jcnlwdGVkTWVzc2FnZVwiOlwibUtPb1h3aThPYXZaXCJ9Igp9

API theMAP поддерживает передачу и обработку токена (как оригинального, так и расшифрованного) в методах: Block, Pay и tokenDecrypt в параметре payment_token. Пример запроса на одностадийную оплату Pay:

{
    "key": "GooglePayTestTerminal",
    "payment_token": {
        "type": "DecryptGooglePay",
        "data": "ewogICAgImdhdGV3YXlNZXJja......"
    },
    "merchant_order_id": "GooglePayTestOrder-001",
    "amount": 101
}

В результате успешного выполнения сценария из примера выше, средства клиента будут авторизованы и списаны с помощью theMAP и Google Pay. Пример успешного ответа:

{
    "Success": true,
    "OrderId": "GooglePayTestOrder-001",
    "Amount": 101,
    "ErrCode": ""
}

Если вы получили ошибочный ответ, пожалуйста, проверьте корректность закодированного в Base64 токена, корректность его передачи и другие параметры. Если данные корректны, обратитесь к словарю ошибок theMAP

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

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

  1. Через Google Pay нельзя оплачивать товары/услуги, запрещенные к продаже в интернете
  2. Правила использования бренда Google Pay
  3. Перед началом работы с Google Pay необходимо пройти процедуру регистрации и проверки WEB-сайта и/или моб. приложения в Google.