Versions Compared

Old Version 10

changes.mady.by.user Tech Platon

Saved on

compared with

New Version 11

changes.mady.by.user Tech Platon

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note

Response про фінальний статус при оплаті з 3DS відсутній.

currency
Expand
titleCallback при успешном списанииуспішній оплаті
Code Block
languagephp
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' => '********************************',
)
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee_type

ПараметрыПараметри

ОписаниеОпис

action

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

SALE

result

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

SUCCESS

status

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

SETTLED

PENDING только когда было указано auth = Y якщо оплата в холді

order_id

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

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

trans_id

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

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

trans_date

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

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

descriptor

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

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

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

auth_code

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

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

amount

Status
colourYellow
titleОПЦІЯ

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

Info

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

Сума

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10

Status
colourYellow
titleОПЦІЯ

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

Info

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

MIDдодаткових полів

MID

Status
colourYellow
titleОПЦІЯ

Унікальний ідентифікатор термінала в платіжній системі.

card

Status
colourYellow
titleОПЦІЯ

Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор.

Info

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

card

Status
colourYellow
titleОПЦІЯ

Маска карты в формате Маска картки в форматі ХХХХХХ****ХХХХ

Info

card_hash

Status
colourYellow
titleОПЦІЯ

Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту.

Этот параметр даст вам возможность в вашей системе:

  • Привязать карту под клиента.

  • Проверить не использовал ли другой клиент эту же карту.

  • Проверить какие кредиты, товары и услуги погашаются данной картой.

  • Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией.

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

Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку.

Цей параметр дозволить вам в вашій системі:

  • Прив'язати картку до клієнта.

  • Перевірити, чи не використовував інший клієнт цю ж картку.

  • Перевірити, які кредити, товари та послуги погашаються цією карткою.

  • Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.

brand

Status
colourYellow
titleОПЦІЯ

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

Info

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

fee_type

Status
colour
Status
colourYellow
titleОПЦІЯ

Признак каким образом взимается комиссияОзнака як буде списуватись комісія з мерчанта:

  • ACT - по актам.

  • TRANSACTION - потранзакционнопотранзакційно.

Info

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

fee

Status
colourYellow
titleОПЦІЯ

Сумма комиссии с мерчанта по транзакции Сума комісії з мерчанта в ГРН

Info

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

currency

Status
colour
Status
colourYellow
titleОПЦІЯ

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

Info

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

hash

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

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

Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    client_pass.
    trans_id.
    strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)
Info

Увага! Якщо в запиті на оплату не було вказано email, то при перевірці hash вкажіть пусте значення email.

...

Note

Response про фінальний статус при оплаті з 3DS відсутній.

Expand
titleCallback при неуспешном списанииневдалій оплаті
Code Block
languagephp
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

Status
colourGreen
titleОбязательноОБОВ'ЯЗКОВИЙ

SALE

result

Status
colourGreen
titleОбязательноОБОВ'ЯЗКОВИЙ

DECLINED

status

Status
colourGreen
titleОбязательноОБОВ'ЯЗКОВИЙ

DECLINED

order_id

Status
colourGreen
titleОбязательноОБОВ'ЯЗКОВИЙ

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

trans_id

Status
colourGreen
titleОбязательноОБОВ'ЯЗКОВИЙ

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

trans_date

Status
colourGreen
titleОбязательноОБОВ'ЯЗКОВИЙ

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

amount

Status
colourYellow
titleопционально

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

Info

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

опція

Сума

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10

Status
colourYellow
titleопциональноопція

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

Info

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

MID

Status
colourYellow
titleОПЦИОНАЛЬНО

Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор.

Info

MID

Status
colourYellow
titleопція

Унікальний ідентифікатор термінала в платіжній системі.

card

Status
colourYellow
titleОПЦИОНАЛЬНОопція

Маска карты картки в формате форматі ХХХХХХ****ХХХХ

Info

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

cardcard_hash

Status
colourYellow
titleОПЦИОНАЛЬНО

Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту.

Этот параметр даст вам возможность в вашей системе:

  • Привязать карту под клиента.

  • Проверить не использовал ли другой клиент эту же карту.

  • Проверить какие кредиты, товары и услуги погашаются данной картой.

  • Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией.

Info

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

опція

Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку.

Цей параметр дозволить вам в вашій системі:

  • Прив'язати картку до клієнта.

  • Перевірити, чи не використовував інший клієнт цю ж картку.

  • Перевірити, які кредити, товари та послуги погашаються цією карткою.

  • Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.

brand

Status
colourYellow
titleОПЦИОНАЛЬНОопція

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

Info

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

fee_type

Status
colourYellow
titleОПЦИОНАЛЬНО
Признак каким образом взимается комиссия
опція

Ознака як буде списуватись комісія з мерчанта:

  • ACT - по актам.

  • TRANSACTION - потранзакционнопотранзакційно.

Info

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

fee

Status
colourYellow
titleОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

Info

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

fee

Status
colourYellow
titleопція

Сума комісії з мерчанта в ГРН

currency

Status
colourYellow
titleопциональноопція

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

info

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

decline_reason

Status
colourGreen
titleОбязательноОБОВ'ЯЗКОВИЙ

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

hash

Status
colourGreen
titleОбязательно
Зашифрованная подпись для проверки достоверности
ОБОВ'ЯЗКОВИЙ

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

Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    client_pass.
    trans_id.
    strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)
Info

Внимание! Если при запросе Увага! Якщо в запиті на оплату не был указан було вказано email, то при проверке hash в подписи Callback следует указать пустое значение для email.перевірці hash вкажіть пусте значення email.Зашифрованная подпись для проверки достоверности коллбека

...

При оплаті з 3DS
Status
colourRed
titleасинхронний режим

Проміжна відповідь
Status
colourRed
titleасинхронний режим

Expand
titleResponse при успешной отправке запроса на обработку оплатыуспішній відправці запиту на оплату
Code Block
languagejson
{
  "action":"SALE",
  "result":"ACCEPTED",
  "trans_id":"03346-89211- 86461",
  "order_id":"ORDER-12345",
  "trans_date":"2012-04-03 16:02:01"
}

Параметр

Опис

action
SALE

Status
result
colour
ACCEPTED
Green

order_id 

Transaction ID in the Client’s system

trans_id

Transaction ID in the Payment Platform

trans_date 

Transaction date in the Payment Platform

...

titleОБОВ'ЯЗКОВИЙ

SALE

result

Status
colour

...

array ( 2 'action' => 'SALE', 3 'result' => 'REDIRECT', 4 'status' => '3DS', 5 'order_id' => '
Expand
titleCallback для редіректу платника на перевірку 3DS
Code Block
languagephp

Green
title

...

ОБОВ'ЯЗКОВИЙ

ACCEPTED

order_id

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

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

trans_id

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

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

trans_date

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

Дата транзакції. Час в UTC

Проміжний редірект платника на 3DS
Status
colourRed
titleасинхронний режим

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

...

Параметры
Описание
action
 Status
colour
...
 Expand
titleCallback при успішному списанні
 Code Block
languagephp
array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'recurring_token' => '01e00c2b39bb3b933723307c442efd02',
  'card_token' => '8ef3111ac1093f6ccb817acef7f0845601d0994689a5f57949f94b0d086c7fe2',
  'hash' => '********************************',
)
При невдалій оплаті з 3DS 
 Status
colourRed
titleасинхронний режим
array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '4092002',
  'trans_id' => '28076-29879-99538',
  'trans_date' => '2020-02-03 20:49:47',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)
 Expand
titleCallback при невдалому списанні
 Code Block
languagephp
Green
title
...
ОБОВ'ЯЗКОВИЙ
SALE
result
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
REDIRECT
status
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
3DS
order_id
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
ID транзакції в системі мерчанта
trans_id
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
ID транзакції в платіжній системі
trans_date
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Дата транзакції. Час в UTC
redirect_url
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
URL для редіректу на 3DS
redirect_params
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Дані для 3DS
redirect_method
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Метод відправки параметрів 3DS (POST/GET)
hash
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Зашифрований підпис для перевірки достовірності коллбека
 Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)
 Info
Увага! Якщо в запиті на оплату не було вказано email, то при перевірці hash вкажіть пусте значення email.
При успішній оплаті з 3DS 
 Status
colourRed
titleасинхронний режим
 Expand
titleCallback при успішному списанні
 Code Block
languagephp
array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'recurring_token' => '01e00c2b39bb3b933723307c442efd02',
  'card_token' => '8ef3111ac1093f6ccb817acef7f0845601d0994689a5f57949f94b0d086c7fe2',
  'hash' => '********************************',
)
Параметри
Опис
action
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
SALE
result
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
SUCCESS
status
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
SETTLED
PENDING якщо оплата в холді
order_id
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
ID транзакції в системі мерчанта
trans_id
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
ID транзакції в платіжній системі
trans_date
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Дата транзакції. Час в UTC
descriptor
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Опис
auth_code
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Код авторизації
amount
 Status
colourYellow
titleОПЦІЯ
Сума
ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
 Status
colourYellow
titleОПЦІЯ
10 додаткових полів
MID
 Status
colourYellow
titleОПЦІЯ
Унікальний ідентифікатор термінала в платіжній системі.
card
 Status
colourYellow
titleОПЦІЯ
Маска картки в форматі ХХХХХХ****ХХХХ
card_hash
 Status
colourYellow
titleОПЦІЯ
Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку.
Цей параметр дозволить вам в вашій системі:
  • Прив'язати картку до клієнта.
  • Перевірити, чи не використовував інший клієнт цю ж картку.
  • Перевірити, які кредити, товари та послуги погашаються цією карткою.
  • Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.
brand
 Status
colourYellow
titleОПЦІЯ
'brand' => 'VISA'
'brand' => 'MASTER'
'brand" => 'PROSTIR'
fee_type
 Status
colourYellow
titleОПЦІЯ
Ознака як буде списуватись комісія з мерчанта:
  • ACT - по актам.
  • TRANSACTION - потранзакційно.
fee
 Status
colourYellow
titleОПЦІЯ
Сума комісії з мерчанта в ГРН
currency
 Status
colourYellow
titleОПЦІЯ
Валюта
hash
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Зашифрований підписк для перевірки достовірності коллбека
 Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    client_pass.
    trans_id.
    strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)
 Info
Увага! Якщо в запиті на оплату не було вказано email, то при перевірці hash вкажіть пусте значення email.
При невдалій оплаті з 3DS 
 Status
colourRed
titleасинхронний режим
 Expand
titleCallback при невдалому списанні
 Code Block
languagephp
array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '4092002',
  'trans_id' => '28076-29879-99538',
  'trans_date' => '2020-02-03 20:49:47',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)
Параметри
Опис
action
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
SALE
result
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
DECLINED
status
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
DECLINED
order_id
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
ID транзакції в системі мерчанта
trans_id
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
ID транзакції в платіжній системі
trans_date
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Дата транзакції. Час в UTC
amount
 Status
colourYellow
titleопція
Сума
ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
 Status
colourYellow
titleопція
10 додаткових полів
MID
 Status
colourYellow
titleопція
Унікальний ідентифікатор термінала в платіжній системі.
card
 Status
colourYellow
titleопція
Маска картки в форматі ХХХХХХ****ХХХХ
card_hash
 Status
colourYellow
titleопція
Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку.
Цей параметр дозволить вам в вашій системі:
  • Прив'язати картку до клієнта.
  • Перевірити, чи не використовував інший клієнт цю ж картку.
  • Перевірити, які кредити, товари та послуги погашаються цією карткою.
  • Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.
brand
 Status
colourYellow
titleопція
'brand' => 'VISA'
'brand' => 'MASTER'
'brand" => 'PROSTIR'
fee_type
 Status
colourYellow
titleопція
Ознака як буде списуватись комісія з мерчанта:
  • ACT - по актам.
  • TRANSACTION - потранзакційно.
fee
 Status
colourYellow
titleопція
Сума комісії з мерчанта в ГРН
currency
 Status
colourYellow
titleопція
Валюта
decline_reason
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Причина відмови в оплаті
hash
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
Зашифрований підписк для перевірки достовірності коллбека
 Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    client_pass.
    trans_id.
    strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)
 Info
Увага! Якщо в запиті на оплату не було вказано email, то при перевірці hash вкажіть пусте значення email.Зашифрованная подпись для проверки достоверности коллбека
...
При помилці в запиті
 Expand
titleResponse при помилці в запиті
 Code Block
languagejson
{
  "result":"ERROR",
  "error_message":"Error description"
}