Page Comparison

Данный Цей метод позволит разместить на вашем сайте или в приложении отдельную кнопку для оплаты дозволить розмістити на вашому сайті або додатку окрему кнопку оплати Google Pay.

•  Привести сайт / приложение к соответствию требованиямдодаток до відповідності вимогам.
•  Интегрировать Інтегрувати API Google Pay.
•  Указать Вказати environment в режим режимі TEST.
•  Передать Передати тех поддержке підтримці PSP Platon ссылку посилання для Callback.
•  Сообщить в Повідомити тех поддержке підтримці PSP Platon ваши ваші IP адреса сервера сайта или о том, что будет использоваться приложение (в этом случае ограничения по IP будут снятыадреси серверів сайта або про те, що буде використовуватить додаток (в цьому випадку обмеження по IP будуть зняті).
•  Провести запрос для получения зашифрованных данных согласно запит по API Google Pay .
•  После авторизации пользователя и выбора реальной карты в кошельке Google Pay вернет зашифрованные данные.
•  Провести запрос согласно API PSP Platon используя зашифрованные данные от Google Pay.
•  Получить Response или Callback для редиректа плательщика на 3DS проверку.
•  Отправить клиента на 3DS проверку.
•  Получить Response или Callback со статусом платежа DECLINED от PSP Platon.
•  Отправить запрос в Google Business Console для активации аккаунта.
•  Сообщить в тех поддержке PSP Platon об активации аккаунта.
•  Указать environment в режим PRODUCTION.
•  Провести запрос с получение успешного Response или Callback со статусом платежа SUCCESS от PSP Platon.
•  Уведомить клиента об успешной / не успешной оплате.

• для отримання кнопки Google Pay.
•  Після авторизації користувача та вибору реальної картки в гаманці Google Pay вам повернуться зашифровані дані PaymentData.
•  З отриманих шифрованих даних PaymentData необхідно витянути token та відформатувати його відповідно до вимогам і прикладу вказаному в цій документації.
•  Провести запит відповідно API методу PSP Platon використовуючи відформатований токен Google Pay.
•  Отримати Response або Callback для редиректа платника на 3DS перевірку.
•  Відправити кліента на 3DS перевірку.
•  Отримати Response або Callback зі статусом оплати DECLINED від PSP Platon.
•  Відправити запит в Google Business Console для активації акаунта.
•  Повідомити тех підтримці PSP Platon про активацію акаунта.
•  Вказати environment в режимі PRODUCTION.
•  Провести запит з отриманням Response или Callback зі статусом оплати SUCCESS від PSP Platon.
•  Відобразити клиенту інформаію про успішну / невдалу оплату.

Активація Google Pay в Business Console

Для сайта: https://developers.google.com/pay/api/web

Для мобильных приложений: https://developers.google.com/pay/api/android

Интегрируйте Google Pay API следуя документации выше для получения PaymentData.

Параметры:

• Відео від Google про імплементацію Google Pay API для сайту.

• Документація Google Pay API для інтеграції на сайт.

• Контрольний список інтеграції Google Pay API для сайту.

• Розгортання робочого середовища Google Pay на сайті.

Для Android додатку:

• Відео від Google про імплементацію Google Pay API для Android додатку.

• Документація Google Pay API для інтеграції в Android додаток.

• Контрольний список інтеграції Google Pay API для Android додатку.

• Розгортання робочого середовища Google Pay в Android додатку.

Інтегруйте Google Pay API слідуючи документації вище для отримання PaymentData.

Параметри:

• allowPaymentMethods : CARD

• tokenizationSpecification = { "type": "PAYMENT_GATEWAY"}

• allowedCardNetworks = ['MASTERCARD', 'VISA'];

• allowedCardAuthMethods = ['PAN_ONLY', 'CRYPTOGRAM_3DS'];

• gateway = platon

• gatewayMerchantId = CLIENT_KEY (API ключ выдается сотрудником компании PSP Platon)

{
    "apiVersion": 2,
    "apiVersionMinor": 0,
    "allowedPaymentMethods": [
        {
            "type": "CARD",
            "parameters": {
                "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"],
                "allowedCardNetworks": ["VISA", "MASTERCARD"]
            },
            "tokenizationSpecification": {
                "type": "PAYMENT_GATEWAY",
                "parameters": {
                    "gateway": "platon", //фіксований ідентифікатор PSP Platon
                    "gatewayMerchantId": "RJ9AE5Y7GX" //API ключ PSP Platon
                }
            }
        }
    ],
    "merchantInfo": {
        "merchantId": "00986993593073708917", //ваші дані з Google Business Console
        "merchantName": "Name" //ваші дані з Google Business Console
    },
    "transactionInfo": {
        "totalPriceStatus": "FINAL",
        "totalPriceLabel": "Total",
        "totalPrice": "5.00",
        "currencyCode": "UAH",
        "countryCode": "UA"
    }
}

Если Якщо все сделано зробити правильно - на своем сайте/приложении вы получите кнопку Google Pay и после выбора карты вам вернется набор данных с вашому сайті / додатку відобразиться кнопка Google Pay та після вибору картки вам повернеться набір даних з PaymentData.

{
  "apiVersionMinor": 0,
  "apiVersion": 2,
  "paymentMethodData": {
    "description": "Mastercard •••• 5179",
    "tokenizationData": {
      "type": "PAYMENT_GATEWAY",
      "token": {
        "signature": "MEYCIQC+IHxUu9Wwra2Vu6tBa2wJPCMT3pWtN1VphLGYtNVLLwIhAOkdbNje//eLrXVc+n6LOlc4PqxWOUcqwrmki/CNA1ur",
        "intermediateSigningKey": {
          "signedKey": "{\"keyValue\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEwhRrvGB0kZ1248MEJAPwX0YfrQInhyyRM7nyGFjQuzGSViZG3QC9NMvXR9Zd6uVcVzAz+6K/+NEGIWbX8zbk6A\\u003d\\u003d\",\"keyExpiration\":\"1571208568000\"}",
          "signatures": [
            "MEUCIQCR6vIEiyHB8qmlho4/tLd7W8CIGrZDJlCI48CBHeFPvQIgLZJIe4cZv6pYtYYa56QCI/vvg1GqXTP3bTBjO49r5mI="
          ]
        },
        "protocolVersion": "ECv2",
        "signedMessage": "{\"encryptedMessage\":\"k85CGUMmd5PaGmQlHFqHc0HrDZmjM1yG82rFB/p31ZyUleN5nihzjOZif/BKXwg3XA2oLXqBSSWcAdfZwXxCEOqvAQE+kpTC7qVO4wTPip6RruraT6vO9M9FtIf0kcqzYSAN7pl1SUA5jC9rHrqucPoh0/FSspup78SWBt8TnmVKC9O3sQhIZ3SMoGOG4mdjtIrgCwWH2cbrxUH0dHAqOe5ANGOY/mII4nTEp7xaKu41hK/kFE15zVyqgPJXP9bPxzMVk/ozEZSfhSzVTS+9stjkU/kT5EibKB3O1bbxyybKcGQ5vxBOtNOBKKd/NuqNmN2eEK3UbSKb1M3gv45gT9cCeEvlzO7Wg0N100vUBp9RPDN9TH4tj4w578sWFKfTi6FsSrZB27SGWcU0EaKHO9buo94mRBY5yqffF3bKg5mAMPzjDhyHSujqWKAs9C5fBzMEuEr2z7A23kfLqBceH5uS9LJMiZ/yVKCwfpY9u2XyCjKdp7I\\u003d\",\"ephemeralPublicKey\":\"BAMDAtfgcPNuzItrwGLigGj3rtxmyHhZLwx1B4RJZ2oo11jpFf3SA6a3utryCMmlCEcqLfLn6WDH2ArrNBGn+Ew\\u003d\",\"tag\":\"T/qhZ/XY5/3Fe4QBKafm6NqS6EzwVeiKXhRlp8NeWrA\\u003d\"}"
      }
    },
    "type": "CARD",
    "info": {
      "cardNetwork": "MASTERCARD",
      "cardDetails": "5179"
    }
  }
}

С примером PaymentData можете ознакомиться нижеОзнайомтесь з прикладом token з PaymentData нижче:

{
  "signature": "MEYCIQC+IHxUu9Wwra2Vu6tBa2wJPCMT3pWtN1VphLGYtNVLLwIhAOkdbNje//eLrXVc+n6LOlc4PqxWOUcqwrmki/CNA1ur",
  "intermediateSigningKey": 
    {
    "signedKey": "{
        \"keyValue\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEwhRrvGB0kZ1248MEJAPwX0YfrQInhyyRM7nyGFjQuzGSViZG3QC9NMvXR9Zd6uVcVzAz+6K/+NEGIWbX8zbk6A\\u003d\\u003d\",
        \"keyExpiration\":\"1571208568000\"
      }",
      "signatures": [
        "MEUCIQCR6vIEiyHB8qmlho4/tLd7W8CIGrZDJlCI48CBHeFPvQIgLZJIe4cZv6pYtYYa56QCI/vvg1GqXTP3bTBjO49r5mI="
      ]
    },
    "protocolVersion": "ECv2",
    "signedMessage": "{
      \"encryptedMessage\":\"k85CGUMmd5PaGmQlHFqHc0HrDZmjM1yG82rFB/p31ZyUleN5nihzjOZif/BKXwg3XA2oLXqBSSWcAdfZwXxCEOqvAQE+kpTC7qVO4wTPip6RruraT6vO9M9FtIf0kcqzYSAN7pl1SUA5jC9rHrqucPoh0/FSspup78SWBt8TnmVKC9O3sQhIZ3SMoGOG4mdjtIrgCwWH2cbrxUH0dHAqOe5ANGOY/mII4nTEp7xaKu41hK/kFE15zVyqgPJXP9bPxzMVk/ozEZSfhSzVTS+9stjkU/kT5EibKB3O1bbxyybKcGQ5vxBOtNOBKKd/NuqNmN2eEK3UbSKb1M3gv45gT9cCeEvlzO7Wg0N100vUBp9RPDN9TH4tj4w578sWFKfTi6FsSrZB27SGWcU0EaKHO9buo94mRBY5yqffF3bKg5mAMPzjDhyHSujqWKAs9C5fBzMEuEr2z7A23kfLqBceH5uS9LJMiZ/yVKCwfpY9u2XyCjKdp7I\\u003d\",
      \"ephemeralPublicKey\":\"BAMDAtfgcPNuzItrwGLigGj3rtxmyHhZLwx1B4RJZ2oo11jpFf3SA6a3utryCMmlCEcqLfLn6WDH2ArrNBGn+Ew\\u003d\",
      \"tag\":\"T/qhZ/XY5/3Fe4QBKafm6NqS6EzwVeiKXhRlp8NeWrA\\u003d\"
    }"
  }
}

Настройте отправку полученного значения параметра "token" POST запросом по API Platon, в параметре payment_token.

Предусловия:

Прежде чем вы получите доступ к платежной платформе, вы должны предоставить следующее данные администратору платежной платформы:

• список ваших IP-адресов, с которых будут направляться запросы на платежную платформу;

• callback URL - URL-адрес, на который будет отправляться уведомления о результатах обработки Вашего запроса через платежную платформу;

• контактный E-mail разработчика.

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/post/

Параметр

Значение

Описание

Особенности

action

GOOGLEPAY

Код платежного метода

client_key

String

API ключ мерчанта

Ключ предоставляется на почту мерчанту

order_id

String

ID платежа в системе мерчанта

Max 32 символа

order_amount

Number

Сумма платежа

order_currency

UAH

Валюта платежа

order_description

String

Описание платежа

Max 255 символов

Налаштуйте відправку отриманого значення token в параметрі payment_token у відповідному форматі вказаному нижче:

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/post/

md5(
  strtoupper(
    strrev($payer_email).
    $CLIENT_PASS.
    strrev($payment_token)
  )
)

md5(
  strtoupper(
    strrev($payer_email).
    $CLIENT_PASS.
    strrev($payment_token)
  )
)

Пройдите контрольный список интеграции:

После добавления кнопки на ваш сайт/мобильное приложение необходимо пройти контрольный список интеграции для проверки корректности работы Google Pay API:

';
  $data['payer_email']='sale@gmail.com';
  $data['term_url_3ds']='http://google.com';
  $data['hash'] = md5(
            strtoupper(
            strrev($data['payer_email']).
            $client_pass.
            strrev($data['payment_token'])
            )
          );

$url = 'https://secure.platononline.com/post/';
$crq = curl_init();
curl_setopt($crq, CURLOPT_URL, $url);
curl_setopt($crq, CURLOPT_HEADER, 0);
curl_setopt($crq, CURLOPT_POST, 1);
curl_setopt($crq, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($crq, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($crq, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($crq, CURLOPT_POSTFIELDS, http_build_query($data));
$result = curl_exec($crq);
  if (curl_errno($crq)) {
    echo 'ERROR: '.curl_error($crq);
  }else{
    echo $result;
  }
curl_close($crq);

Переведіть environment в режим 'TEST’.

Використайте реальну картку підв'язану в Google Pay для оплати.

При успішному тесті ви отримаєте відповідь про невдалу транзакцію (особливість тествого режиму) 'decline_reason' => 'Declined by processing'

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

Пройдіть контрольний список інтеграції:

Після додавання кнопки на ваш сайт / мобільний додаток необхідно пройти контрольний список інтеграції для перевірки коректності роботи Google Pay API:

Для сайтів: https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist

Для мобильных приложениймобільних додатків: https://developers.google.com/pay/api/android/guides/test-and-deploy/integration-checklist

Запросіть доступ до робочої версії Google Pay API:

Для возможности начать принимать реальные платежи необходимо запросить доступ в рабочей версииможливості приймати реальні оплати необхідно запросити доступ до робочої версії:

https://developers.google.com/pay/api/android/guides/test-and-deploy/request-prod-access

Отримайте доступ на Production в Google Pay:

https://developers.google.com/pay/api/android/guides

Для этого необходимо создать учетную запись цього необхідно створити акаунт в https://pay.google.com/business/console/  (используя гугл аккаунт, желательно корпоративный и общий)

Заполните информацию о компании.

використовуйте загальний корпоративний акаунт)

Заповніть інформацію про компанію.

В інтеграції вкажіть В интеграциях выбрать Сайт, заполнить домен (пока домен тестового сайта), указать тип PaymentGateway и вложить 5 скринов процесса заказа и оплаты.

Сразу можете подавать заявку и для получения доступа с продовым доменом.

заявку и для получения доступа с продовым доменом.

https://developers.google.com/pay/api/android/guides/test-and-deploy/request-prod-access

Отримання доступу займає 2-3 дні. Якщо у співробітників Google будуть зауваження - вони відправлять вам лист під яким ви реєструвались.

Після цього вам треба переключитись на Production в інтеграції з Google Pay:

Для цього: https://developers.google.com/pay/api/androidweb/guides/test-and-deploy/requestdeploy-prod-access

Получение доступа занимает 2-3 дня. Если у сотрудников Google будут замечания - они отправят письмо на мейл, под которым вы зарегистируетесь.

После этого с вашей стороны необходимо переключиться на Production в интеграции с GooglePay:

Для этого: production-environment

1. Встановіть environment: ‘PRODUCTION' замість 'TEST’

2. Вкажіть значення merchantId з бізнес акаунта Google Pay (правий верхній куток)

І повідомте по готовності про переключення налаштувань з вашого боку.

Додатково для мобільного додатку на Android:

Рекомендуємо подавати заявку в бізнес консоль з того ж акаунта під яким ви зареєстровані в Google Play і з якого викладали додаток.

Якщо подавати заявку з іншого акаунта - додатково треба буде зв'язати акаунти. Інструкція як зв'язати акаунти https://support.google.com/googleplay/android-developer/answer/2528691

Для інтеграції з мобільним додатком необхідно буде підписати додаток релізними ключами коли отримаєте доступ в прод і будете переключатися https://developers.google.com/pay/api/web/guides/test-and-deploy/deploy-production-environment

1. Установить environment: ‘PRODUCTION' вместо 'TEST’

2. Указать значение merchantId из бизнес аккаунта GooglePay (правый верхний угол)

И сообщить нам по готовности для переключения настроек с нашей стороны. 

Дополнительно для мобильного приложения Android:

Рекомендуем подавать заявку в бизнес консоли с Google аккаунта, под которым вы зарегистрированы в Google Play и выкладываете приложения.

Если будете подавать заявку с другого аккаунта - дополнительно нужно будет связать аккаунты. Инструкция как связать https://support.google.com/googleplay/android-developer/answer/2528691

Для интеграции в моб приложении необходимо будет подписать приложение релизными ключами когда получите доступ на прод и будете преключаться https://developers.google.com/pay/api/android/guides/test-and-deploy/deploy-your-application /android/guides/test-and-deploy/deploy-your-application

Синхроний режим:

Стандартний режим роботи. Передавати async = N не потрібно.

Асинхронний режим:

Цей режим активується при передачі async = Y.