Google Pay™ (по API)

Этот функционал будет активирован после вашего запроса в групповом чате.


Содержание

 

 


Описание

 

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


Демо

 

 


Чеклист интеграции

 

Привести сайт / приложение к соответствию требованиям.
Интегрировать API Google Pay.
Указать environment в режим TEST.
Передать тех поддержке PSP Platon ссылку для Callback.
Сообщить в тех поддержке PSP Platon ваши 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.
Уведомить клиента об успешной / не успешной оплате.

Требования

 

У вашего сайта должен быть SSL сертификат.

Для проверки валидности и срока действия вашего SSL сертификата рекомендуем воспользоваться сервисом по ссылке.

В футере вашего сайта необходимо разместить логотипы платежных систем и PSP Platon.

Скачайте подходящие под стиль вашего сайта варианты логотипов.

 

Необходима поддержка протокола TLS не ниже версии 1.2


Ограничения

 

На данный момент Google Pay работает в таких браузерах:

  • Chrome

  • Safari

  • UC Browser

  • Firefox

  • Opera

  • Microsoft Edge

  • Android

Для работы Google Pay в WebView необходимо следовать согласно документации Google https://developer.android.com/guide/webapps/webview?hl=ru#BindingJavaScript


Google Pay API

 

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

Для мобильных приложений: https://developers.google.com/pay/api/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)

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 { "apiVersion": 2, "apiVersionMinor": 0, "allowedPaymentMethods": [ { "type": "CARD", "parameters": { "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"], "allowedCardNetworks": ["VISA", "MASTERCARD"] }, "tokenizationSpecification": { "type": "PAYMENT_GATEWAY", "parameters": { "gateway": "platon", "gatewayMerchantId": "RJ9AE5Y7GX" } } } ], "merchantInfo": { "merchantId": "00986993593073708917", "merchantName": "Name" }, "transactionInfo": { "totalPriceStatus": "FINAL", "totalPriceLabel": "Total", "totalPrice": "5.00", "currencyCode": "UAH", "countryCode": "UA" } }

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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 { "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 можете ознакомиться ниже:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 { "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 разработчика.

Callback url должен быть обязателен если вы работаете в асинхронном режиме и не должен превышать 255 символов.


API параметры

 

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

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

Верный вариант

1000.00

Неверные варианты

1000
1000.0
1,000.0
1,000.00

order_currency
Обязательно

UAH

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

Оплата возможна только в национальной валюте гривне

order_description
Обязательно

String

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

Для кириллических символов необходимо использовать формат UTF-8

Max 255 символов

payment_token
Обязательно

String

Токен, полученный мерчантом от Google

 

payer_ip
Обязательно

Number

IP-адрес плательщика

В формате "ХХХ.ХХХ.ХХХ.ХХХ"

IPv6 на данный момент не поддерживается

term_url_3ds
Обязательно

String

Ссылка по которой будет отправлен клиент после успешной оплаты при прохождении 3DS

Max 255 символов

hash
Обязательно

String

Контрольная подпись

1 2 3 4 5 6 7 md5( strtoupper( strrev($payer_email). $CLIENT_PASS. strrev($payment_token) ) )

payer_first_name
не обязательно

String

Имя плательщика

Max 32 символа без пробелов

payer_last_name
не обязательно

String

Фамилия плательщика

Max 32 символа без пробелов

payer_middle_name
не обязательно

String

Отчество плательщика

Max 32 символа без пробелов

payer_birth_date
не обязательно

String

Дата рождения плательщика

В формате “YYYY-MM-DD”

payer_address
не обязательно

String

Адрес плательщика

Max 256 символа
Укажите NA, если нет данных

payer_country
не обязательно

String

Страна плательщика

Стандарт ISO 3166-1 alpha-2
В формате "ХХ"
2 символа
Укажите NA, если нет данных

payer_state
не обязательно

String

Штат плательщика

Обязательный параметр для стран US, CA, AU

Стандарт ISO 3166-2
В формате "ХХ"
2 символа
Укажите NA, если нет данных

payer_city
не обязательно

String

Город плательщика

Max 32 символа
Укажите NA, если нет данных

payer_zip
не обязательно

String

Почтовый индекс плательщика

Max 32 символа
Укажите NA, если нет данных

payer_email
не обязательно

String

E-mail плательщика

Max 256 символа

payer_phone
не обязательно

Number

Номер телефона плательщика

Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то:

  1. обязательный формат телефона 380…

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

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
не обязательно

String

10 дополнительных полей

Max 1024 символа в каждом ext поле

channel_id
не обязательно

String

Дополнительный платежный канал

Позволяет отправить платежи на другой банковский терминал

async
не обязательно

Y
N

Включить асинхронный режим

В асинхронном режиме обязательное использование коллбеков.

По умолчанию значение N.

auth
не обязательно

Y
N

Холдирование средств на карте плательщика

По умолчанию N

req_token
не обязательно

Y
N

Для получения card_token

По умолчанию N


Примеры запроса

 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 <?php $CLIENT_PASS='***'; $data['action']='GOOGLEPAY'; $data['CLIENT_KEY']='***'; $data['order_id']='Test_006'; $data['order_amount']='0.51'; $data['order_currency']='UAH'; $data['order_description']='test'; $data['payment_token']='{"signature":"MEUCIQD+9/PnFvB+Lo6d/eHpgqQrMvmRDZdW1AcjQKavHrcPmQIgeVjR1hXqH7hkCn+VZqx/kjdofMIYbyL15Xp52mR9+2s\u003d","intermediateSigningKey":{"signedKey":"{\"keyValue\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEBOHyOhwWk6SK5nqhFBBI1hSvWHAaOO0Ukbrl56zx7fPNttFFKs2U10f6EWbdhULrv4QT4qMNbyVAq8ig1jdsYA\\u003d\\u003d\",\"keyExpiration\":\"1570945959000\"}","signatures":["MEYCIQCe6t42U5OemtGGdYC6npBNbVxe1HbTF8pUkSD7mO+CWAIhAI/0M/XQuW6i8reT0LCNHKoNfgWYwOWHBoj2wpZdgKHh"]},"protocolVersion":"ECv2","signedMessage":{\"encryptedMessage\":\"U9ChAIukmQ85TdZKAU/26mJUwUt3cVpJmx/JtFi350F/KiRNiIEGi1CmkgVe+ohzikkKLo37Ty3YQjyjVHNTHmF3AyNVTIJCL7qYybt+aFNI1XFlpv3ArWU+fH8Bi190tl7lLyyeNjWx8L402spsLpuUe9OLLjazIq0Vfjw3wRZ2B2+ybUrnoz5Iydapn8B7c/QqR7w53n6svIK58q7eL159Ano0GyfLpUOLLQ949MhP1ze***UzapUGtMd0k0c/4Nnkfs2TnN6ETEtP8y9J29hYKGVOCo79rRSN2xLsYXGNawIiPc6082HWB82JyuW2bfWAL1R0W+2iql2dBWY\\u003d\",\"ephemeralPublicKey\":\"BPYYpVT5INyXSwoNbP/HuGkjQnfnUwUPMH2bCp6Od3EoihnegFZObjP0IVvDA5YfNlLDJjHutBDj30GW5Fei8xw\\u003d\",\"tag\":\"qt4FcCGO4rp969CBBTPJ0nhAeQeR+rOM0FmXk8DdGLQ\\u003d\"}"}'; $data['payer_email']='sale@gmail.com'; $data['term_url_3ds']='http://google.com'; $hash = md5( strtoupper( strrev( $data['payer_email'] ). ($CLIENT_PASS). strrev( $data['payment_token'] ) ) ); ?> <!DOCTYPE html> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Payment</title> </head> <body onload="javascript:document.forms[0].submit()"> <form action="https://secure.platononline.com/post/" method="post"> <input type="hidden" name="action" value="<?=$data['action']?>" /> <input type="hidden" name="client_key" value="<?=$data['CLIENT_KEY']?>" /> <input type="hidden" name="order_id" value="<?=$data['order_id']?>" /> <input type="hidden" name="order_amount" value="<?=$data['order_amount']?>" /> <input type="hidden" name="order_currency" value="<?=$data['order_currency']?>" /> <input type="hidden" name="order_description" value="<?=$data['order_description']?>" /> <input type="hidden" name="payment_token" value="<?=$data['payment_token']?>" /> <input type="hidden" name="payer_email" value="<?=$data['payer_email']?>" /> <input type="hidden" name="term_url_3ds" value="<?=$data['term_url_3ds']?>" /> <input type="hidden" name="hash" value="<?=$hash?>" /> </form> </body> </html>

Тестирование

 

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

Используйте реальную карту подвязанную в Google Pay для оплаты.

При успешном тесте вы получите ответ о неуспешной транзакции (особенности тестового режима) и 'decline_reason' => 'Declined by processing'

Сообщите тех саппорту об успешном тесте и только после этого перейдите к активации бизнес-аккаунта Google.

Параметр environment в режим 'TEST’ оставить до указаний со стороны тех саппорта PSP Platon.


Проверка платежей

 


Callback и Response

 

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

Данный режим работает по умолчанию. Передавать async = N не нужно.

Промежуточный редирект плательщика на 3DS (синхронный режим):

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "action": "SALE", "result": "REDIRECT", "status": "3DS", "trans_id": "03346-89225-87891", "order_id": "ORDER-12345", "trans_date": "2012-04-0316:02:02", "redirect_url": "https://server_3ds.com/3ds.php", "redirect_params": { "PaReq": "bc5865698ae46de4eba4c51f0359a714", "MD": "111111111111111111111", "TermUrl": "https://term_url.com/3ds/67c14e5?trans_id=03346-89225-87891&hash=8b98db60fb3c24c14a6d7075241da38b" }, "redirect_method": "POST" }

Параметры

Описание

Параметры

Описание

action

GOOGLEPAY

result

REDIRECT

status

3DS

order_id

ID транзакции в системе мерчанта

trans_id

ID транзакции в платежной системе

trans_date

Дата транзакции в платежной системе. Время UTC

redirect_url

URL, на который должен быть перенаправлен плательщик

redirect_params

Массив определенных параметров 3DS

redirect_method

Метод передачи параметров (POST/GET)

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 array ( 'action' => 'SALE', 'result' => 'REDIRECT', 'status' => '3DS', 'order_id' => '6b51033e-3e58-42e0-8ec3-88c97388018b', 'trans_id' => '28738-47774-55067', 'trans_date' => '2020-04-20 12:12:57', 'redirect_url' => 'https://acs.privatbank.ua/pPaReqMC.jsp', 'redirect_params' => array ( 'PaReq' => 'eJxVUllu2zAQvYqg/4qUIlFUMGYgxykaoEqN2j4AIxGxUi2Olsb+K/qTG+S3VygKpGhRtL0CdaMMHWUDSHDeLJw3Cxxty8L6rJo2r6uJ7TrUtlSV1lleXUzs1fLtG24fCViuG6VmC5X2jRKQqLaVF8rKs4k9lx/VlRvw8ID7YRhFYcgDHrmeF/KQc8apG/jcFjCP0U/AmElgIscD8gjxyyZdy6oTINOr6emZwCgWcCAjhFI1pzPBXB66jAF5gFDJUolpPF29P1k4xx8SZxUD2Sshrfuqa3aCUx/II4C+KcS66zbtISGbQnZ1VeSVctK6BGJsQJ6ZzHsjtfjXNs9EMouv8e7w0uQy3p4t6HWy/IT4ZALEeEAmOyU86lHqe9RyvUM8QQRkrwdZGhKmcoplPQDYmBzxaDGGlwrAdjc4jZ2IOJqeEKjtpq4UemALn2TIVJsK/U3fDV/0nf4x3OL7b7jRf/Uv/dvS//Uf/X34Otzqn9a5PO8L1Zq6nV4iQxMK5Lni43dmEmmHTfZdN2CMMz/wzTj2OsMgx356B5TtKRgAxESRcdJk3BKUXm3PPfYf2CM=', 'TermUrl' => 'https://secure.platononline.com/3ds/4de0025?operation_type=purchase&trans_id=28738-47774-55067&hash=*************************************************** ), 'redirect_method' => 'POST', 'hash' => '********************************', )

Параметры

Описание

Параметры

Описание

action

SALE

result

REDIRECT

status

3DS

order_id

ID транзакции в системе мерчанта

trans_id

ID транзакции в платежной системе

trans_date

Дата транзакции в платежной системе. Время UTC

redirect_url

URL, на который должен быть перенаправлен плательщик

redirect_params

Строка параметров

redirect_method

Метод передачи параметров (POST/GET)

hash

Зашифрованная подпись для проверки достоверности коллбека

1 2 3 4 5 6 7 md5( strtoupper( strrev(email). CLIENT_PASS. strrev(payment_token) ) )

Внимание! Если при запросе на оплату не был указан email, то при проверке hash в подписи Callback следует указать пустое значение для email.

При успешной оплате (синхронный режим):

1 2 3 4 5 6 7 8 9 { "action": "SALE", "result": "SUCCESS", "status": "SETTLED", "trans_id": "03346-89217-70541", "order_id": "ORDER-12345", "descriptor": "test", "trans_date": "2012-04-03 16:02:01" }

Параметры

Описание

Параметры

Описание

action

GOOGLEPAY

result

SUCCESS

status

PENDING/SETTLED; статус PENDING только когда было указано "auth=Y"

order_id

ID транзакции в системе мерчанта

trans_id

ID транзакции в платежной системе

trans_date

Дата транзакции в платежной системе. Время UTC

descriptor

Это строка, которую владелец кредитной карты увидит в выписка из банка.

В большинстве случаев это веб-сайт поддержки клиентов.

amount

Сумма транзакции

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

ext1 - ext10

10 дополнительных полей

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

currency

Валюта операции

1 2 3 4 5 6 7 8 9 10 11 array ( 'action' => 'SALE', 'result' => 'SUCCESS', 'status' => 'SETTLED', 'order_id' => '1_691201', 'trans_id' => '31176-65336-00444', 'trans_date' => '2021-01-27 16:55:33', 'descriptor' => NULL, 'auth_code' => '990647', 'hash' => '********************************', )

Параметры

Описание

Параметры

Описание

action

SALE

result

SUCCESS

status

PENDING/SETTLED; статус PENDING только когда было указано "auth=Y"

order_id

ID транзакции в системе мерчанта

trans_id

ID транзакции в платежной системе

trans_date

Дата транзакции в платежной системе. Время UTC

descriptor

Это строка, которую владелец кредитной карты увидит в выписка из банка.

В большинстве случаев это веб-сайт поддержки клиентов.

auth_code

Код авторизации от банка

amount

Сумма транзакции

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

ext1 - ext10

10 дополнительных полей

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

hash

Зашифрованная подпись для проверки достоверности коллбека

1 2 3 4 5 6 7 md5( strtoupper( strrev($payer_email). $CLIENT_PASS. strrev($payment_token) ) )

Внимание! Если при запросе на оплату не был указан email, то при проверке hash в подписи Callback следует указать пустое значение для email.

При неуспешной оплате (синхронный режим):

1 2 3 4 5 6 7 8 9 { "action": "SALE", "result": "DECLINED", "status": "DECLINED", "trans_id": "03346-89214-54141", "order_id": "ORDER-12345", "trans_date": "2012-04-0316:02:01", "decline_reason": "Declined by processing" }

Параметры

Описание

Параметры

Описание

action

GOOGLEPAY

result

DECLINED

status

DECLINED

order_id

ID транзакции в системе мерчанта

trans_id

ID транзакции в платежной системе

amount

Сумма транзакции

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

ext1 - ext10

10 дополнительных полей

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

trans_date

Дата транзакции в платежной системе. Время UTC

decline_reason

Причина, по которой транзакция была отклонена

1 2 3 4 5 6 7 8 9 10 array ( 'action' => 'SALE', 'result' => 'DECLINED', 'status' => 'DECLINED', 'order_id' => '1_691201', 'trans_id' => '31176-65336-00444', 'trans_date' => '2021-01-27 16:55:33', 'decline_reason' => 'Declined by processing', 'hash' => '********************************', )

Параметры

Описание

Параметры

Описание

action

SALE

result

DECLINED

status

DECLINED

order_id

ID транзакции в системе мерчанта

trans_id

ID транзакции в платежной системе

trans_date

Дата транзакции в платежной системе. Время UTC

amount

Сумма транзакции

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

ext1 - ext10

10 дополнительных полей

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

decline_reason

Причина, по которой транзакция была отклонена

hash

Зашифрованная подпись для проверки достоверности коллбека

1 2 3 4 5 6 7 md5( strtoupper( strrev(email). CLIENT_PASS. strrev(payment_token) ) )

Внимание! Если при запросе на оплату не был указан email, то при проверке hash в подписи Callback следует указать пустое значение для email.

При ошибке в запросе (синхронный режим):

1 2 3 4 { "result": "ERROR", "error_message": "Error description" }

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

Данный режим активируется при передаче async = Y. В этом режиме обязательно необходимо принимать callback на ваш callback url.

Промежуточный ответ (асинхронный режим):

1 2 3 4 5 6 7 { "action": "SALE", "result": "ACCEPTED", "trans_id": "03346-89211-86461", "order_id": "ORDER-12345", "trans_date": "2012-04-03 16:02:01" }

Параметры

Описание

Параметры

Описание

action

GOOGLEPAY

result

ACCEPTED

order_id

ID транзакции в системе мерчанта

trans_id

ID транзакции в платежной системе

trans_date

Дата транзакции в платежной системе. Время UTC

Промежуточный редирект плательщика на 3DS (асинхронный режим):

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 array ( 'action' => 'SALE', 'result' => 'REDIRECT', 'status' => '3DS', 'order_id' => '6b51033e-3e58-42e0-8ec3-88c97388018b', 'trans_id' => '28738-47774-55067', 'trans_date' => '2020-04-20 12:12:57', 'redirect_url' => 'https://acs.privatbank.ua/pPaReqMC.jsp', 'redirect_params' => array ( 'PaReq' => 'eJxVUllu2zAQvYqg/4qUIlFUMGYgxykaoEqN2j4AIxGxUi2Olsb+K/qTG+S3VygKpGhRtL0CdaMMHWUDSHDeLJw3Cxxty8L6rJo2r6uJ7TrUtlSV1lleXUzs1fLtG24fCViuG6VmC5X2jRKQqLaVF8rKs4k9lx/VlRvw8ID7YRhFYcgDHrmeF/KQc8apG/jcFjCP0U/AmElgIscD8gjxyyZdy6oTINOr6emZwCgWcCAjhFI1pzPBXB66jAF5gFDJUolpPF29P1k4xx8SZxUD2Sshrfuqa3aCUx/II4C+KcS66zbtISGbQnZ1VeSVctK6BGJsQJ6ZzHsjtfjXNs9EMouv8e7w0uQy3p4t6HWy/IT4ZALEeEAmOyU86lHqe9RyvUM8QQRkrwdZGhKmcoplPQDYmBzxaDGGlwrAdjc4jZ2IOJqeEKjtpq4UemALn2TIVJsK/U3fDV/0nf4x3OL7b7jRf/Uv/dvS//Uf/X34Otzqn9a5PO8L1Zq6nV4iQxMK5Lni43dmEmmHTfZdN2CMMz/wzTj2OsMgx356B5TtKRgAxESRcdJk3BKUXm3PPfYf2CM=', 'TermUrl' => 'https://secure.platononline.com/3ds/4de0025?operation_type=purchase&trans_id=28738-47774-55067&hash=*************************************************** ), 'redirect_method' => 'POST', 'hash' => '********************************', )

Параметры

Описание

Параметры

Описание

action

SALE

result

REDIRECT

status

3DS

order_id

ID транзакции в системе мерчанта

trans_id

ID транзакции в платежной системе

trans_date

Дата транзакции в платежной системе. Время UTC

redirect_url

URL, на который должен быть перенаправлен плательщик

redirect_params

Строка параметров

redirect_method

Метод передачи параметров (POST/GET)

hash

Зашифрованная подпись для проверки достоверности коллбека

1 2 3 4 5 6 7 md5( strtoupper( strrev(email). CLIENT_PASS. strrev(payment_token) ) )

Внимание! Если при запросе на оплату не был указан email, то при проверке hash в подписи Callback следует указать пустое значение для email.

При успешной оплате (асинхронный режим):

1 2 3 4 5 6 7 8 9 10 11 array ( 'action' => 'SALE', 'result' => 'SUCCESS', 'status' => 'SETTLED', 'order_id' => '1_691201', 'trans_id' => '31176-65336-00444', 'trans_date' => '2021-01-27 16:55:33', 'descriptor' => NULL, 'auth_code' => '990647', 'hash' => '********************************', )

Параметры

Описание

Параметры

Описание

action

SALE

result

SUCCESS

status

PENDING/SETTLED; статус PENDING только когда было указано "auth=Y"

order_id

ID транзакции в системе мерчанта

trans_id

ID транзакции в платежной системе

trans_date

Дата транзакции в платежной системе. Время UTC

descriptor

Это строка, которую владелец кредитной карты увидит в выписка из банка.

В большинстве случаев это веб-сайт поддержки клиентов.

auth_code

Код авторизации от банка

amount

Сумма транзакции

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

ext1 - ext10

10 дополнительных полей

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

hash

Зашифрованная подпись для проверки достоверности коллбека

1 2 3 4 5 6 7 md5( strtoupper( strrev($payer_email). $CLIENT_PASS. strrev($payment_token) ) )

Внимание! Если при запросе на оплату не был указан email, то при проверке hash в подписи Callback следует указать пустое значение для email.

При неуспешной оплате (асинхронный режим):

1 2 3 4 5 6 7 8 9 10 array ( 'action' => 'SALE', 'result' => 'DECLINED', 'status' => 'DECLINED', 'order_id' => '1_691201', 'trans_id' => '31176-65336-00444', 'trans_date' => '2021-01-27 16:55:33', 'decline_reason' => 'Declined by processing', 'hash' => '********************************', )

Параметры

Описание

Параметры

Описание

action

SALE

result

DECLINED

status

DECLINED

order_id

ID транзакции в системе мерчанта

trans_id

ID транзакции в платежной системе

trans_date

Дата транзакции в платежной системе. Время UTC

amount

Сумма транзакции

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

ext1 - ext10

10 дополнительных полей

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

decline_reason

Причина, по которой транзакция была отклонена

hash

Зашифрованная подпись для проверки достоверности коллбека

1 2 3 4 5 6 7 md5( strtoupper( strrev(email). CLIENT_PASS. strrev(payment_token) ) )

Внимание! Если при запросе на оплату не был указан email, то при проверке hash в подписи Callback следует указать пустое значение для email.

При ошибке в запросе (асинхронный режим):

1 2 3 4 { "result": "ERROR", "error_message": "Error description" }

Ошибки запросов

 


Боевой режим

 

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

После добавления кнопки на ваш сайт/мобильное приложение необходимо пройти контрольный список интеграции для проверки корректности работы 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 скринов процесса заказа и оплаты.

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

Просьба обратить внимание, что в прод режиме Google Pay будет работать только на проаппрувленых гуглом доменах.

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

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

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

Для этого: 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


Связанные разделы

 

Дополнения к оплате картой:

Последующие транзакции: