Versions Compared

Key

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

...

Опис
Expand
titleResponse для редіректу платника на перевірку 3DS (варіант з GET)
language
Code Block
json
{
  "action":"APPLEPAY",
  "result":"REDIRECT",
  "status":"3DS",
  "transorder_id":"03346-89225- 87891PLS-17817174",
  "ordertrans_id":"ORDER42780-17679-1234505524",
  "trans_date":"20122024-0410-0301 16:0256:0207",
  "redirect_url":"https:\/\/server_3ds.com/3ds.phpasecg.ua\/api\/v2\/brw\/challenge\/init?txid=cd4545b6-6bbc-4d17",
  "redirect_params":null,
    {
      "PaReq":"bc5865698ae46de4eba4c51f0359a714",
      "MD":"111111111111111111111",
      "TermUrl":"https://term_url.com/3ds/67c14e5?trans_id=03346-89225-87891&hash=8b98db60fb3c24c14a6d7075241da38b"
    },
  "redirect_method":"POST"
}

Параметри

"redirect_method":"GET"
}

Параметри

Опис

action

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

APPLEPAY

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)

Expand
titleПроміжний Callback при наявності 3DSResponse для редіректу платника на перевірку 3DS (варіант з POST)
Code Block
languagephpjson
array{
(   'action' => 'SALE'"action":"APPLEPAY",
  'result' => 'REDIRECT'"result":"REDIRECT",
  'status' => '3DS'"status":"3DS",
  'order_id' => '6b51033e-3e58-42e0-8ec3-88c97388018b'"trans_id":"03346-89225- 87891",
  'trans_id' => '28738-47774-55067'"order_id":"ORDER-12345",
  '"trans_date' => '2020":"2012-04-2003 1216:1202:57'02",
  '"redirect_url' => '":"https://acs.privatbank.ua/pPaReqMC.jsp'server_3ds.com/3ds.php",
  '"redirect_params' => 
":
    {
      "PaReq":"bc5865698ae46de4eba4c51f0359a714",
   array (  "MD":"111111111111111111111",
    'PaReq' => 'eJxVUllu2zAQvYqg/4qUIlFUMGYgxykaoEqN2j4AIxGxUi2Olsb+K/qTG+S3VygKpGhRtL0CdaMMHWUDSHDeLJw3Cxxty8L6rJo2r6uJ7TrUtlSV1lleXUzs1fLtG24fCViuG6VmC5X2jRKQqLaVF8rKs4k9lx/VlRvw8ID7YRhFYcgDHrmeF/KQc8apG/jcFjCP0U/AmElgIscD8gjxyyZdy6oTINOr6emZwCgWcCAjhFI1pzPBXB66jAF5gFDJUolpPF29P1k4xx8SZxUD2Sshrfuqa3aCUx/II4C+KcS66zbtISGbQnZ1VeSVctK6BGJsQJ6ZzHsjtfjXNs9EMouv8e7w0uQy3p4t6HWy/IT4ZALEeEAmOyU86lHqe9RyvUM8QQRkrwdZGhKmcoplPQDYmBzxaDGGlwrAdjc4jZ2IOJqeEKjtpq4UemALn2TIVJsK/U3fDV/0nf4x3OL7b7jRf/Uv/dvS//Uf/X34Otzqn9a5PO8L1Zq6nV4iQxMK5Lni43dmEmmHTfZdN2CMMz/wzTj2OsMgx356B5TtKRgAxESRcdJk3BKUXm3PPfYf2CM=', "TermUrl":"https://term_url.com/3ds/67c14e5?trans_id=03346-89225-87891&hash=8b98db60fb3c24c14a6d7075241da38b"
    },
 'TermUrl' => 'https://secure.platononline.com/3ds/4de0025?operation_type=purchase&trans_id=28738-47774-55067&hash=***************************************************
    ),
  'redirect_method' => 'POST "redirect_method":"POST"
}

Параметри

Опис

action

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

APPLEPAY

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)

Expand
titleПроміжний Callback при наявності 3DS (варіант з GET)
Code Block
languagephp
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 (),
  'redirect_method' => 'GET',
  'hash' => '********************************',
)

Параметры

Описание

action

Status
colourGreen
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, на который должен быть перенаправлен плательщик

redirect_params

Status
colourGreen
titleОбязательно

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

redirect_method

Status
colourGreen
titleОбязательно

GET

Метод передачи параметров

hash

Status
colourGreen
titleОбязательно

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

Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)
Info

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

Expand
titleПроміжний Callback при наявності 3DS (варіант з POST)
Code Block
languagephp
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

Status
colourGreen
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
colourBlue
titleсинхронний режим

Note

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

order_id
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' => '********************************',
)

Параметри

Опис

action

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

SALE

result

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

REDIRECT

status

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

3DS

',
)

Параметри

Опис

action

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

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

trans_id

SALE

result

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

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

trans_date

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

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

redirect_url

redirect_params

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

Дані для 3DS

redirect_method

SUCCESS

status

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

URL для редіректу на 3DS

hash

SETTLED

PENDING якщо оплата в холді

order_id

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

Метод відправки параметрів 3DS (POST/GET)

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

trans_id

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

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

Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)
Info

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

...

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

trans_date

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

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

descriptor

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

Опис

auth_code

Status
colour

...

Note

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

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' => '********************************',
)

Параметри

Опис

action

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

SALE

result

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

SUCCESS

status

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

SETTLED

PENDING якщо оплата в холді

order_id

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

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

trans_id

Green
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ОБОВ'ЯЗКОВИЙ

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

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

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
colourBlue
titleсинхронний режим

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

ОПЦІЯ

опція

Сума

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

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

Status
colourYellow
title

ОПЦІЯ

опція

Валюта

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

hash

MID

Status
colour

Green

Yellow
title

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

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

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

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

...

опція

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

card

Status
colourYellow
titleопція

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

card_hash

Status
colour

...

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

Yellow
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ОБОВ'ЯЗКОВИЙ

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

trans_dateПричина відмови в оплаті

hash

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Зашифрований підписк для перевірки достовірності коллбека

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асинхронний режим

Проміжна відповідь
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"
}
hash

Параметри

Опис

action

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

SALE

result

Status
colourGreen
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
titleПроміжний Callback при наявності перевірки 3DS (варіант з GET)
Code Block
languagephp
md5( strtoupper( strrev(email). client_pass. trans_id. strrev(
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 
substr
(
card
),
0,6).

  'redirect_method' 
substr(card,-4)
=> 'GET',
  'hash' 
) ) )
Info

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

...

=> '********************************',
)

Параметры

Описание

action

Status
colourGreen
titleОбязательно

SALE

result

Status
colourGreen
titleОбязательно

REDIRECT

status

Status
colour

...

Green
title

...

Обязательно

3DS

order_id

Status
colour

...

action
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"
}

Параметри

Опис

Green
title

...

result

SALE

Обязательно

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

trans_id

Status
colourGreen
titleОбязательно

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

trans_date

Status
colourGreen
titleОбязательно

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

redirect_url

Status
colourGreen
title

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

Обязательно

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

redirect_params

Status
colourGreen
title

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

ACCEPTED

order_idtrans_id

Обязательно

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

redirect_method

Status
colourGreen
title

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

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

Обязательно

GET

Метод передачи параметров

hash

Status
colourGreen
title

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

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

trans_date

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

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

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

Обязательно

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

Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)
Info

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

Expand
titleCallback для редіректу платника на перевірку 3DS (варіант з POST)
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
colourGreen
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.

...