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

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

{
  "action":"SALE",
  "result":"REDIRECT",
  "status":"3DS",
  "trans_id":"03346-89225- 87891",
  "order_id":"ORDER-12345",
  "trans_date":"2012-04-03 16: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` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`REDIRECT`
`status` ОБОВ'ЯЗКОВИЙ	`3DS`
`order_id` ОБОВ'ЯЗКОВИЙ	Ордер ID в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	Ордер ID в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`redirect_url` ОБОВ'ЯЗКОВИЙ	URL для редіректу на 3DS
`redirect_params` ОБОВ'ЯЗКОВИЙ	Дані для 3DS
`redirect_method` ОБОВ'ЯЗКОВИЙ	Метод відправки параметрів 3DS (POST/GET)

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 для редіректу на 3DS
`redirect_params` ОБОВ'ЯЗКОВИЙ	Дані для 3DS
`redirect_method` ОБОВ'ЯЗКОВИЙ	Метод відправки параметрів 3DS (POST/GET)
`hash` ОБОВ'ЯЗКОВИЙ	Зашифрований підпис для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.

При успішній оплаті з 3DS синхронний режим

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

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` ОБОВ'ЯЗКОВИЙ	`SETTLED` `PENDING` якщо оплата в холді
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`descriptor` ОБОВ'ЯЗКОВИЙ	Опис
`auth_code` ОБОВ'ЯЗКОВИЙ	Код авторизації
`amount` ОПЦІЯ	Сума
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦІЯ	10 додаткових полів
`MID` ОПЦІЯ	Унікальний ідентифікатор термінала в платіжній системі.
`card` ОПЦІЯ	Маска картки в форматі ХХХХХХ****ХХХХ
`card_hash` ОПЦІЯ	Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку. Цей параметр дозволить вам в вашій системі: Прив'язати картку до клієнта. Перевірити, чи не використовував інший клієнт цю ж картку. Перевірити, які кредити, товари та послуги погашаються цією карткою. Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.
`brand` ОПЦІЯ	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'`
`fee_type` ОПЦІЯ	Ознака як буде списуватись комісія з мерчанта: `ACT` - по актам. `TRANSACTION` - потранзакційно.
`fee` ОПЦІЯ	Сума комісії з мерчанта в ГРН
`currency` ОПЦІЯ	Валюта
`hash` ОБОВ'ЯЗКОВИЙ	Зашифрований підписк для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.

При невдалій оплаті з 3DS синхронний режим

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

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`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` опція	10 додаткових полів
`MID` опція	Унікальний ідентифікатор термінала в платіжній системі.
`card` опція	Маска картки в форматі ХХХХХХ****ХХХХ
`card_hash` опція	Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку. Цей параметр дозволить вам в вашій системі: Прив'язати картку до клієнта. Перевірити, чи не використовував інший клієнт цю ж картку. Перевірити, які кредити, товари та послуги погашаються цією карткою. Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.
`brand` опція	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'`
`fee_type` опція	Ознака як буде списуватись комісія з мерчанта: `ACT` - по актам. `TRANSACTION` - потранзакційно.
`fee` опція	Сума комісії з мерчанта в ГРН
`currency` опція	Валюта
`decline_reason` ОБОВ'ЯЗКОВИЙ	Причина відмови в оплаті
`hash` ОБОВ'ЯЗКОВИЙ	Зашифрований підписк для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.Зашифрованная подпись для проверки достоверности коллбека

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

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

{
  "action":"SALE",
  "result":"ACCEPTED",
  "trans_id":"03346-89211- 86461",
  "order_id":"ORDER-12345",
  "trans_date":"2012-04-03 16:02:01"
}

Параметри	Опис

Параметри	Опис
`action` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`ACCEPTED`
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC

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

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` Обязательно	`SALE`
`result` Обязательно	`REDIRECT`
`status` Обязательно	`3DS`
`order_id` Обязательно	ID транзакции в системе мерчанта
`trans_id` Обязательно	ID транзакции в платежной системе
`trans_date` Обязательно	Дата транзакции в платежной системе. Время UTC
`redirect_url` Обязательно	URL, на который должен быть перенаправлен плательщик
`redirect_params` Обязательно	Строка параметров
`redirect_method` Обязательно	`GET` Метод передачи параметров
`hash` Обязательно	Зашифрованная подпись для проверки достоверности коллбека `md5( strtoupper( strrev(email). CLIENT_PASS. strrev(payment_token) ) )` Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

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` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`REDIRECT`
`status` ОБОВ'ЯЗКОВИЙ	`3DS`
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`redirect_url` ОБОВ'ЯЗКОВИЙ	URL для редіректу на 3DS
`redirect_params` ОБОВ'ЯЗКОВИЙ	Дані для 3DS
`redirect_method` ОБОВ'ЯЗКОВИЙ	Метод відправки параметрів 3DS (POST/GET)
`hash` ОБОВ'ЯЗКОВИЙ	Зашифрований підпис для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.

При успішній оплаті з 3DS асинхронний режим

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` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`SUCCESS`
`status` ОБОВ'ЯЗКОВИЙ	`SETTLED` `PENDING` якщо оплата в холді
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`descriptor` ОБОВ'ЯЗКОВИЙ	Опис
`auth_code` ОБОВ'ЯЗКОВИЙ	Код авторизації
`amount` ОПЦІЯ	Сума
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦІЯ	10 додаткових полів
`MID` ОПЦІЯ	Унікальний ідентифікатор термінала в платіжній системі.
`card` ОПЦІЯ	Маска картки в форматі ХХХХХХ****ХХХХ
`card_hash` ОПЦІЯ	Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку. Цей параметр дозволить вам в вашій системі: Прив'язати картку до клієнта. Перевірити, чи не використовував інший клієнт цю ж картку. Перевірити, які кредити, товари та послуги погашаються цією карткою. Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.
`brand` ОПЦІЯ	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'`
`fee_type` ОПЦІЯ	Ознака як буде списуватись комісія з мерчанта: `ACT` - по актам. `TRANSACTION` - потранзакційно.
`fee` ОПЦІЯ	Сума комісії з мерчанта в ГРН
`currency` ОПЦІЯ	Валюта
`hash` ОБОВ'ЯЗКОВИЙ	Зашифрований підписк для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.

При невдалій оплаті з 3DS асинхронний режим

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` ОБОВ'ЯЗКОВИЙ	`SALE`
`result` ОБОВ'ЯЗКОВИЙ	`DECLINED`
`status` ОБОВ'ЯЗКОВИЙ	`DECLINED`
`order_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в системі мерчанта
`trans_id` ОБОВ'ЯЗКОВИЙ	ID транзакції в платіжній системі
`trans_date` ОБОВ'ЯЗКОВИЙ	Дата транзакції. Час в UTC
`amount` опція	Сума
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` опція	10 додаткових полів
`MID` опція	Унікальний ідентифікатор термінала в платіжній системі.
`card` опція	Маска картки в форматі ХХХХХХ****ХХХХ
`card_hash` опція	Унікальне зашифроване значення номера картки, яке повертатиметься в колбеку під час оплати, верифікації, погашення та виплати коштів на картку. Цей параметр дозволить вам в вашій системі: Прив'язати картку до клієнта. Перевірити, чи не використовував інший клієнт цю ж картку. Перевірити, які кредити, товари та послуги погашаються цією карткою. Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.
`brand` опція	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'`
`fee_type` опція	Ознака як буде списуватись комісія з мерчанта: `ACT` - по актам. `TRANSACTION` - потранзакційно.
`fee` опція	Сума комісії з мерчанта в ГРН
`currency` опція	Валюта
`decline_reason` ОБОВ'ЯЗКОВИЙ	Причина відмови в оплаті
`hash` ОБОВ'ЯЗКОВИЙ	Зашифрований підписк для перевірки достовірності коллбека `md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) )` Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.Зашифрованная подпись для проверки достоверности коллбека

При помилці в запиті

{
  "result":"ERROR",
  "error_message":"Error description"
}

Документація

Callback / Response - SALE з 3DS

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

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

При успішній оплаті з 3DS синхронний режим

При невдалій оплаті з 3DS синхронний режим

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

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

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

При успішній оплаті з 3DS асинхронний режим

При невдалій оплаті з 3DS асинхронний режим

При помилці в запиті