Page Comparison

...

Параметр

Значение

Описание

Особенности

Обязательно

action

GOOGLEPAY

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

Status

colour	Green
title	Да

async

Y
N

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

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

Status

colour	Yellow
title	нет

client_key

String

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

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

Status

colour	Green
title	Да

channel_id

String

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

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

Status

colour	Yellow
title	нет

order_id

String

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

Max 32 символа

Status

colour	Green
title	Да

order_amount

Number

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

Tip

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

1000.00

Warning

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

1000
1000.0
1,000.0
1,000.00

Status

colour	Green
title	Да

order_currency

UAH

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

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

Status

colour	Green
title	Да

order_description

String

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

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

Max 255 символов

Status

colour	Green
title	Да

payment_token

String

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

Status

colour	Green
title	Да

payer_first_name

String

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

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

Status

colour	Yellow
title	нет

payer_last_name

String

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

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

Status

colour	Yellow
title	нет

payer_middle_name

String

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

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

Status

colour	Yellow
title	нет

payer_birth_date

String

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

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

Status

colour	Yellow
title	нет

payer_address

String

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

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

Status

colour	Yellow
title	нет

payer_country

String

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

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

Status

colour	Yellow
title	нет

payer_state

String

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

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

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

Status

colour	Yellow
title	нет

payer_city

String

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

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

Status

colour	Yellow
title	нет

payer_zip

String

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

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

Status

colour	Yellow
title	нет

payer_email

String

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

Max 256 символа

Status

colour	Yellow
title	нет

payer_phone

Number

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

Note

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

обязательный формат телефона 380…
номер телефона должен соответствовать финансовому номеру привязанному к карте

Status

colour	Yellow
title	нет

payer_ip

Number

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

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

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

Status

colour	Yellow
title	нет

term_url_3ds

String

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

Max 255 символов

Status

colour	Yellow
title	нет

ext1-ext10

String

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

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

Status

colour	Yellow
title	нет

auth

Y
N

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

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

Status

colour	Yellow
title	нет

req_token

Y
N

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

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

Status

colour	Yellow
title	нет

hash

String

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

Code Block

language	php

md5(
  strtoupper(
    strrev(payer$payer_email).
    CLIENT$CLIENT_PASS.
    strrev(payment$payment_token)
  )
)

Status

colour	Green
title	Да

...

Expand

title	Callback при успешном списании

Code Block

language	php

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

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

ext1-ext10

Дополнительные поля от 1 до 10

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

hash

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

Code Block

language	php

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

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

...

Expand

title	Callback при успешном списании

Code Block

language	php

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

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

ext1-ext10

Дополнительные поля от 1 до 10

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

hash

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

Code Block

language	php

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

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

...

Versions Compared

Old Version 21

New Version 22

Key