Info |
---|
Этот функционал будет активирован после вашего запроса в групповом чате. |
Цей функціонал буде активовано після вашого запиту в груповому чаті. |
Зміст
Table of Contents | ||||||||
---|---|---|---|---|---|---|---|---|
|
Опис
Данный Цей метод позволит разместить на вашем сайте или в приложении отдельную кнопку для оплаты дозволить розмістити на вашому сайті або додатку окрему кнопку оплати Google Pay.
Демо
Iframe | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Чекліст інтеграції
- Привести сайт / приложение к соответствию требованиямдодаток до відповідності вимогам.
- Интегрировать Інтегрувати 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. - Уведомить клиента об успешной / не успешной оплате.
Требования
Expand | ||
---|---|---|
| ||
У вашего сайта должен быть SSL сертификат. Для проверки валидности и срока действия вашего SSL сертификата рекомендуем воспользоваться сервисом по ссылке. |
title | Логотипы платежных систем и PSP Platon |
---|
В футере вашего сайта необходимо разместить логотипы платежных систем и PSP Platon.
Скачайте подходящие под стиль вашего сайта варианты логотипов.
Expand | ||
---|---|---|
| ||
Необходима поддержка протокола TLS не ниже версии 1.2 |
Ограничения
Expand | ||
---|---|---|
| ||
На данный момент Google Pay работает в таких браузерах:
|
Expand | ||
---|---|---|
| ||
Для работы 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.
Параметры- для отримання кнопки 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. - Відобразити клиенту інформаію про успішну / невдалу оплату.
Вимоги
Include Page | ||||
---|---|---|---|---|
|
Обмеження
Expand | ||
---|---|---|
| ||
На даний момент Google Pay працює в таких браузерах:
|
Expand | ||
---|---|---|
| ||
Google забороняє використовувати Google Pay в WebView. |
Google Business Console
Активація Google Pay в Business Console
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Google Pay API
Для сайта:
Для 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)
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Если Якщо все сделано зробити правильно - на своем сайте/приложении вы получите кнопку Google Pay и после выбора карты вам вернется набор данных с вашому сайті / додатку відобразиться кнопка Google Pay та після вибору картки вам повернеться набір даних з PaymentData.
Expand | |||||
---|---|---|---|---|---|
| |||||
|
С примером PaymentData можете ознакомиться нижеОзнайомтесь з прикладом token
з PaymentData нижче:
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Настройте отправку полученного значения параметра "token" POST запросом по API Platon, в параметре payment_token.
Предусловия:
Прежде чем вы получите доступ к платежной платформе, вы должны предоставить следующее данные администратору платежной платформы:
список ваших IP-адресов, с которых будут направляться запросы на платежную платформу;
callback URL - URL-адрес, на который будет отправляться уведомления о результатах обработки Вашего запроса через платежную платформу;
контактный E-mail разработчика.
Note |
---|
Callback url должен быть обязателен если вы работаете в асинхронном режиме и не должен превышать 255 символов. |
API параметры
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/post/
Параметр
Значение
Описание
Особенности
action
Status | ||||
---|---|---|---|---|
|
GOOGLEPAY
Код платежного метода
client_key
Status | ||||
---|---|---|---|---|
|
String
API ключ мерчанта
Ключ предоставляется на почту мерчанту
order_id
Status | ||||
---|---|---|---|---|
|
String
ID платежа в системе мерчанта
Max 32 символа
order_amount
Status | ||||
---|---|---|---|---|
|
Number
Сумма платежа
Tip |
---|
Верный вариант 1000.00 |
Warning |
---|
Неверные варианты 1000 |
order_currency
Status | ||||
---|---|---|---|---|
|
UAH
Валюта платежа
Info |
---|
Оплата возможна только в национальной валюте гривне |
order_description
Налаштуйте відправку отриманого значення token
в параметрі payment_token
у відповідному форматі вказаному нижче:
Expand | ||
---|---|---|
| ||
|
API параметри
HTTP METHOD: POST
API ENDPOINT: https://secure.platononline.com/post/
title | Пример запроса на PHP |
---|
language | php |
---|
Параметр | Значення | Опис | Особливості | ||
---|---|---|---|---|---|
|
payment_token
|
String
Описание платежа
Note |
---|
Для кириллических символов необходимо использовать формат UTF-8 |
Max 255 символов
| Код платіжного метода | ||||
|
| String |
Токен, полученный мерчантом от Google
payer_ip
API ключ мерчанта | Ключ надається на пошту мерчанта | ||||
|
term_url_3ds
|
Number
IP-адрес плательщика
В формате "ХХХ.ХХХ.ХХХ.ХХХ"
Note |
---|
IPv6 на данный момент не поддерживается |
String | ID оплати в системі мерчанта | Max 255 символи | |||
|
hash
Status | ||||
---|---|---|---|---|
|
String
Контрольная подпись
Code Block | ||
---|---|---|
| ||
md5(
strtoupper(
strrev($payer_email).
$CLIENT_PASS.
strrev($payment_token)
)
) |
payer_first_name
|
String
Ссылка по которой будет отправлен клиент после успешной оплаты при прохождении 3DS
Max 255 символов
Number | Сума оплати |
| ||||
|
payer_last_name
|
String
Имя плательщика
Max 32 символа без пробелов
|
| Валюта |
| ||||
|
|
payer_middle_name
| String |
Фамилия плательщика
Max 32 символа без пробелов
Опис |
Max 255 символів | ||
|
|
| String |
Отчество плательщика
Токен отриманий від Google | Токен необхідно відформатувати відповідно до прикладу вказаного вище. |
|
|
|
String
Дата рождения плательщика
В формате “YYYY-MM-DD”
payer_address
| Number | IP-адреса платника | В форматі "ХХХ.ХХХ.ХХХ.ХХХ"
| ||||
|
|
String
| String | E-mail платника |
Max 256 |
Укажите
NA
, если нет данныхсимволів |
|
|
|
String
Страна плательщика
Стандарт ISO 3166-1 alpha-2
В формате "ХХ"
2 символа
Укажите NA
, если нет данных
payer_state
| Number | Номер телефона платника |
| ||||
|
|
payer_city
| String |
Штат плательщика
Note |
---|
Обязательный параметр для стран US, CA, AU |
Стандарт ISO 3166-2
В формате "ХХ"
2 символа
Укажите NA
, если нет данных
Посилання куди буде відправлено платника після спроби оплати | Max 255 символів | |||||||||||||
| String | Контрольний підпис |
| |||||||||||
|
| String |
Ім'я платника | Max 32 |
Укажите
NA
, если нет данныхсимволи без пробілів |
|
|
| String |
Прізвище платника | Max 32 |
Укажите
NA
, если нет данныхpayer_email
символи без пробілів | ||||||
|
| String |
Отчество плательщика | Max |
32 символи без пробілів |
|
|
ext1
, ext2
, ext3
, ext4
, ext5
, ext6
, ext7
, ext8
, ext9
, ext10
|
Number
Номер телефона плательщика
Note |
---|
Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то:
|
String | Дата народження платника | В форматі “YYYY-MM-DD” | ||||
|
channel_id
| String |
10 дополнительных полей
Max 1024 символа в каждом ext поле
Адреса платника | Max 256 символів | |||||
|
async
| String |
Дополнительный платежный канал
Позволяет отправить платежи на другой банковский терминал
Країна платника | Стандарт ISO 3166-1 alpha-2 | |||||
|
|
Y
String |
N
Включить асинхронный режим
Note |
---|
В асинхронном режиме обязательное использование коллбеков. |
По умолчанию значение N
.
auth
status
Штат платника | Стандарт ISO 3166-2 | |||||
|
|
Y
String |
N
По умолчанию N
req_token
Місто платника | Max 32 символи | |||||
|
|
Y
String |
N
Для получения card_token
По умолчанию N
Примеры запроса
Поштовий індекс платника | Max 32 символи | ||||||||||
| String | 10 додаткових полів | Max 1024 символи в кажному ext полі | ||||||||
| String | Додатковий платіжний канал | Дозволяє перенаправляти платежі на інший банківський термінал | ||||||||
|
| Включити асинхронний режим |
Стандартне значення | ||||||||
|
| Стандартне значення | |||||||||
|
| Для отримання | Стандартне значення |
Приклад запиту
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|
Тестирование
Переведите environment в режим 'TEST’.
Используйте реальную карту подвязанную в Google Pay для оплаты.
При успешном тесте вы получите ответ о неуспешной транзакции (особенности тестового режима) и 'decline_reason' => 'Declined by processing'
Сообщите тех саппорту об успешном тесте и только после этого перейдите к активации бизнес-аккаунта Google.
Warning |
---|
Параметр environment в режим 'TEST’ оставить до указаний со стороны тех саппорта PSP Platon. |
Проверка платежей
title | Полный список методов получения результата транзакции |
---|
Callback и Response
title | Особенности работы с Callback |
---|
title | Безопасность |
---|
Синхронный режим:
Данный режим работает по умолчанию. Передавать async = N
не нужно.
Промежуточный редирект плательщика на 3DS (синхронный режим):
title | Промежуточный Response при наличии 3DS проверки |
---|
Code Block | ||
---|---|---|
| ||
{
"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)
title | Промежуточный Callback при наличии проверки 3DS |
---|
Code Block | ||
---|---|---|
| ||
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
Зашифрованная подпись для проверки достоверности коллбека
Code Block | ||
---|---|---|
| ||
md5(
strtoupper(
strrev(email).
CLIENT_PASS.
strrev(payment_token)
)
) |
Info |
---|
Внимание! Если при запросе на оплату не был указан |
При успешной оплате (синхронный режим):
title | Response при успешном списании |
---|
Code Block | ||
---|---|---|
| ||
{
"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
Сумма транзакции
Info |
---|
Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат. |
ext1
- ext10
10 дополнительных полей
Info |
---|
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат. |
currency
Валюта операции
title | Callback при успешном списании |
---|
Code Block | ||
---|---|---|
| ||
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
Сумма транзакции
Info |
---|
Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат. |
ext1
- ext10
10 дополнительных полей
Info |
---|
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат. |
hash
Зашифрованная подпись для проверки достоверности коллбека
Code Block | ||
---|---|---|
| ||
md5(
strtoupper(
strrev($payer_email).
$CLIENT_PASS.
strrev($payment_token)
)
) |
Info |
---|
Внимание! Если при запросе на оплату не был указан |
При неуспешной оплате (синхронный режим):
title | Response при неуспешном списании |
---|
Code Block | ||
---|---|---|
| ||
{
"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
Сумма транзакции
Info |
---|
Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат. |
ext1
- ext10
10 дополнительных полей
Info |
---|
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат. |
trans_date
Дата транзакции в платежной системе. Время UTC
decline_reason
Причина, по которой транзакция была отклонена
title | Callback при неуспешном списании |
---|
Code Block | ||
---|---|---|
| ||
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
Сумма транзакции
Info |
---|
Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат. |
ext1
- ext10
10 дополнительных полей
Info |
---|
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат. |
decline_reason
Причина, по которой транзакция была отклонена
hash
Зашифрованная подпись для проверки достоверности коллбека
Code Block | ||
---|---|---|
| ||
md5(
strtoupper(
strrev(email).
CLIENT_PASS.
strrev(payment_token)
)
) |
Info |
---|
Внимание! Если при запросе на оплату не был указан |
При ошибке в запросе (синхронный режим):
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Асинхронный режим:
Данный режим активируется при передаче async = Y
. В этом режиме обязательно необходимо принимать callback на ваш callback url.
Промежуточный ответ (асинхронный режим):
title | Response о принятии запроса в обработку |
---|
Code Block | ||
---|---|---|
| ||
{
"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 (асинхронный режим):
title | Промежуточный Callback при наличии проверки 3DS |
---|
Code Block | ||
---|---|---|
| ||
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
Зашифрованная подпись для проверки достоверности коллбека
Code Block | ||
---|---|---|
| ||
md5(
strtoupper(
strrev(email).
CLIENT_PASS.
strrev(payment_token)
)
) |
Info |
---|
Внимание! Если при запросе на оплату не был указан |
При успешной оплате (асинхронный режим):
title | Callback при успешном списании |
---|
Code Block | ||
---|---|---|
| ||
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
Сумма транзакции
Info |
---|
Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат. |
ext1
- ext10
10 дополнительных полей
Info |
---|
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат. |
hash
Зашифрованная подпись для проверки достоверности коллбека
Code Block | ||
---|---|---|
| ||
md5(
strtoupper(
strrev($payer_email).
$CLIENT_PASS.
strrev($payment_token)
)
) |
Info |
---|
Внимание! Если при запросе на оплату не был указан |
При неуспешной оплате (асинхронный режим):
title | Callback при неуспешном списании |
---|
Code Block | ||
---|---|---|
| ||
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
Сумма транзакции
Info |
---|
Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат. |
ext1
- ext10
10 дополнительных полей
Info |
---|
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат. |
decline_reason
Причина, по которой транзакция была отклонена
hash
Зашифрованная подпись для проверки достоверности коллбека
Code Block | ||
---|---|---|
| ||
md5(
strtoupper(
strrev(email).
CLIENT_PASS.
strrev(payment_token)
)
) |
Info |
---|
Внимание! Если при запросе на оплату не был указан |
При ошибке в запросе (асинхронный режим):
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Ошибки запросов
title | Список ошибок, их причин и возможных решений. |
---|
Боевой режим
Пройдите контрольный список интеграции:
После добавления кнопки на ваш сайт/мобильное приложение необходимо пройти контрольный список интеграции для проверки корректности работы Google Pay API:
Для сайтов
|
Info |
---|
Тестовий режим
Переведіть environment в режим 'TEST’.
Використайте реальну картку підв'язану в Google Pay для оплати.
При успішному тесті ви отримаєте відповідь про невдалу транзакцію (особливість тествого режиму) 'decline_reason' => 'Declined by processing'
Повідомте тех підтримці про успішний тест і тільки після цього можете переходити до активаціх в Google бізнес акаунті.
Warning |
---|
Параметр environment в режимі 'TEST’ залишити до вказівок з боку тех підтримки PSP Platon. |
Боєвий режим
Пройдіть контрольний список інтеграції:
Після додавання кнопки на ваш сайт / мобільний додаток необхідно пройти контрольний список інтеграції для перевірки коректності роботи 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 скринов процесса заказа и оплаты.
Сразу можете подавать заявку и для получения доступа с продовым доменом.
Note |
---|
Просьба обратить внимание, что в прод режиме Google Pay будет работать только на проаппрувленых гуглом доменах. |
доменом.
Note |
---|
Зверніть увагу, що в прод режимі буде працювали лише проапрувлений домен. |
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/request-prod-access
Получение доступа занимает 2-3 дня. Если у сотрудников Google будут замечания - они отправят письмо на мейл, под которым вы зарегистируетесь.
После этого с вашей стороны необходимо переключиться на Production в интеграции с GooglePay:
Для этого: -and-deploy/deploy-production-environment
Встановіть environment: ‘PRODUCTION' замість 'TEST’
Вкажіть значення merchantId з бізнес акаунта Google Pay (правий верхній куток)
І повідомте по готовності про переключення налаштувань з вашого боку.
Додатково для мобільного додатку на Android:
Рекомендуємо подавати заявку в бізнес консоль з того ж акаунта під яким ви зареєстровані в Google Play і з якого викладали додаток.
Якщо подавати заявку з іншого акаунта - додатково треба буде зв'язати акаунти. Інструкція як зв'язати акаунти https://support.google.com/googleplay/android-developer/answer/2528691
Для інтеграції з мобільним додатком необхідно буде підписати додаток релізними ключами коли отримаєте доступ в прод і будете переключатися https://developers.google.com/pay/api/webandroid/guides/test-and-deploy/deploy-production-environment
Установить environment: ‘PRODUCTION' вместо 'TEST’
Указать значение 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
Связанные разделы
Перевірка оплат
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Callback & Response
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Синхроний режим:
Стандартний режим роботи. Передавати async = N
не потрібно.
Асинхронний режим:
Цей режим активується при передачі async = Y
.
Include Page | ||||
---|---|---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|
Помилки запитів
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|