При оплаті з 3DS СИНХРОННИЙ РЕЖИМ

Проміжний редірект платника на 3DS СИНХРОННИЙ РЕЖИМ

Response для редіректу платника на перевірку 3DS

{
  "action":"APPLEPAY",
  "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` ОБОВ'ЯЗКОВИЙ	APPLEPAY
`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)

Проміжний Callback при наявності 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 (
      '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. strrev(payment_token) ) ) Увага! Якщо в запиті на оплату не було вказано `email`, то при перевірці `hash` вкажіть пусте значення `email`.

При успішній оплаті з 3DS СИНХРОННИЙ РЕЖИМ

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

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

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` только когда было указано `auth` = `Y`
`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` ОПЦІЯ	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`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 відсутній.

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

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` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`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` в подписи Callback следует указать пустое значение для `email`.

При оплаті з 3DS АСИНХРОННИЙ РЕЖИМ

Проміжна відповідь АСИНХРОННИЙ РЕЖИМ

Response при успешной отправке запроса на обработку оплаты

{
  "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`	Transaction ID in the Client’s system
`trans_id`	Transaction ID in the Payment Platform
`trans_date`	Transaction date in the Payment Platform

Проміжний редірект платника на 3DS АСИНХРОННИЙ РЕЖИМ

Callback для редіректу платника на перевірку 3DS

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)

При успішній оплаті з 3DS АСИНХРОННИЙ РЕЖИМ

Callback при успішному списанні

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 АСИНХРОННИЙ РЕЖИМ

Callback при невдалому списанні

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

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

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

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

Callback / Response - APPLEPAY з 3DS