Callback / Response - APPLEPAY з 3DS

При оплаті з 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`	Transaction ID in the Client’s system
`trans_id`	Transaction ID in the Payment Platform
`trans_date`	Transaction date in the Payment Platform
`redirect_url`	URL to which the Client should redirect the Customer
`redirect_params`	Array of specific 3DS parameters
`redirect_method`	The method of transferring parameters (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, на который должен быть перенаправлен плательщик
`redirect_params` ОБЯЗАТЕЛЬНО	Строка параметров
`redirect_method` ОБЯЗАТЕЛЬНО	`POST` Метод передачи параметров
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). CLIENT_PASS. strrev(payment_token) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `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` в подписи Callback следует указать пустое значение для `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"
}