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

Промежуточный редирект плательщика на 3DS (синхронный режим)

Промежуточный Response при наличии 3DS проверки

{
  "action": "SALE",
  "result": "REDIRECT",
  "status": "3DS",
  "trans_id": "03346-89225-87891",
  "order_id": "ORDER-12345",
  "trans_date": "2012-04-0316: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, на который должен быть перенаправлен плательщик
`redirect_params` ОБЯЗАТЕЛЬНО	Массив определенных параметров 3DS
`redirect_method` ОБЯЗАТЕЛЬНО	`POST` Метод передачи параметров

Промежуточный 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 при успешном списании

{
  "action": "SALE",
  "result": "SUCCESS",
  "status": "SETTLED",
  "trans_id": "03346-89217-70541",
  "order_id": "ORDER-12345",
  "descriptor": "test",
  "trans_date": "2012-04-03 16:02:01"
}

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`SUCCESS`
`status` ОБЯЗАТЕЛЬНО	`SETTLED` `PENDING` только когда было указано `auth` = `Y`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`descriptor` ОБЯЗАТЕЛЬНО	Это строка, которую владелец кредитной карты увидит в выписка из банка. В большинстве случаев это веб-сайт поддержки клиентов.
`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` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

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 при неуспешном списании

{
  "action": "SALE",
  "result": "DECLINED",
  "status": "DECLINED",
  "trans_id": "03346-89214-54141",
  "order_id": "ORDER-12345",
  "trans_date": "2012-04-0316:02:01",
  "decline_reason": "Declined by processing"
}

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`DECLINED`
`status` ОБЯЗАТЕЛЬНО	`DECLINED`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`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` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`decline_reason` ОБЯЗАТЕЛЬНО	Причина, по которой транзакция была отклонена

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

Промежуточный ответ з 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` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC

При успешной оплате (асинхронный режим):