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

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

Expand

title	Response для редіректу платника на перевірку 3DS (варіант з GET)

Code Block

{
  "action":"SALE",
  "result":"REDIRECT",
  "status":"3DS",
  "order_id":"PLS-17817174",
  "trans_id":"42780-17679-05524",
  "trans_date":"2024-10-01 16:56:07",
  "redirect_url":"https:\/\/asecg.ua\/api\/v2\/brw\/challenge\/init?txid=cd4545b6-6bbc-4d17",
  "redirect_params":null,
  "redirect_method":"GET"
}

Параметри

Опис

action

Status

colour	Green
title	ОБОВ'ЯЗКОВИЙ

SALE

result

Status

colour	Green
title	ОБОВ'ЯЗКОВИЙ

REDIRECT

status

Status

colour	Green
title	ОБОВ'ЯЗКОВИЙ

3DS

order_id

Status

colour	Green
title	ОБОВ'ЯЗКОВИЙ

Ордер ID в системі мерчанта

trans_id

Status

colour	Green
title	ОБОВ'ЯЗКОВИЙ

Ордер ID в платіжній системі

trans_date

Status

colour	Green
title	ОБОВ'ЯЗКОВИЙ

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

redirect_url

Status

colour	Green
title	ОБОВ'ЯЗКОВИЙ

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

redirect_params

Status

colour	Green
title	ОБОВ'ЯЗКОВИЙ

Дані для 3DS

redirect_method

Status

colour	Green
title	ОБОВ'ЯЗКОВИЙ

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

Expand

title	Response для редіректу платника на перевірку 3DS (варіант з POST)

Code Block

language	json

{
  "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

Status

colour	Green
title	Обязательно

SALE

result

Status

colour	Green
title	Обязательно

REDIRECT

status

Status

colour	Green
title	Обязательно

3DS

order_id

Status

colour	Green
title	Обязательно

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

trans_id

Status

colour	Green
title	Обязательно

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

trans_date

Status

colour	Green
title	Обязательно

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

redirect_url

Status

colour	Green
title	Обязательно

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

redirect_params

Status

colour	Green
title	Обязательно

Массив определенных параметров 3DS

redirect_method

Status

colour	Green
title	Обязательно

POST

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

Expand

title	Проміжний Callback при наявності перевірки 3DS (варіант з GET)

Code Block

language	php

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

colour	Green
title	Обязательно

SALE

result

Status

colour	Green
title	Обязательно

REDIRECT

status

Status

colour	Green
title	Обязательно

3DS

order_id

Status

colour	Green
title	Обязательно

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

trans_id

Status

colour	Green
title	Обязательно

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

trans_date

Status

colour	Green
title	Обязательно

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

redirect_url

Status

colour	Green
title	Обязательно

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

redirect_params

Status

colour	Green
title	Обязательно

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

redirect_method

Status

colour	Green
title	Обязательно

GET

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

hash

Status

colour	Green
title	Обязательно

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

Code Block

language	php

md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)

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

Expand

title	Проміжний Callback при наявності перевірки 3DS (варіант з POST)

Code Block

language	php

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

colour	Green
title	Обязательно

SALE

result

Status

colour	Green
title	Обязательно

REDIRECT

status

Status

colour	Green
title	Обязательно

3DS

order_id

Status

colour	Green
title	Обязательно

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

trans_id

Status

colour	Green
title	Обязательно

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

trans_date

Status

colour	Green
title	Обязательно

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

redirect_url

Status

colour	Green
title	Обязательно

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

redirect_params

Status

colour	Green
title	Обязательно

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

redirect_method

Status

colour	Green
title	Обязательно

POST

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

hash

Status

colour	Green
title	Обязательно

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

Code Block

language	php

md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)

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

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

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

Expand

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

Code Block

language	php

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

colour	Green
title	Обязательно

SALE

result

Status

colour	Green
title	Обязательно

SUCCESS

status

Status

colour	Green
title	Обязательно

SETTLED

PENDING только когда было указано auth = Y

order_id

Status

colour	Green
title	Обязательно

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

trans_id

Status

colour	Green
title	Обязательно

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

trans_date

Status

colour	Green
title	Обязательно

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

descriptor

Status

colour	Green
title	Обязательно

Это строка, которую владелец кредитной карты увидит в выписка из банка.

В большинстве случаев это веб-сайт поддержки клиентов.

auth_code

Status

colour	Green
title	Обязательно

Код авторизации от банка

amount

Status

colour	Yellow
title	опционально

Сумма транзакции

Info
Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.

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

Status

colour	Yellow
title	опционально

10 дополнительных полей

Info
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.

MID

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

card

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Маска карты в формате ХХХХХХ****ХХХХ

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

card_hash

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту.

Этот параметр даст вам возможность в вашей системе:

Привязать карту под клиента.
Проверить не использовал ли другой клиент эту же карту.
Проверить какие кредиты, товары и услуги погашаются данной картой.
Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

brand

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee_type

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Признак каким образом взимается комиссия:

ACT - по актам.
TRANSACTION - потранзакционно.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

currency

Status

colour	Yellow
title	опционально

Валюта операции

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

hash

Status

colour	Green
title	Обязательно

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

Code Block

language	php

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

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

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

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

Expand

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

Code Block

language	php

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

colour	Green
title	Обязательно

SALE

result

Status

colour	Green
title	Обязательно

DECLINED

status

Status

colour	Green
title	Обязательно

DECLINED

order_id

Status

colour	Green
title	Обязательно

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

trans_id

Status

colour	Green
title	Обязательно

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

trans_date

Status

colour	Green
title	Обязательно

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

amount

Status

colour	Yellow
title	опционально

Сумма транзакции

Info
Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.

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

Status

colour	Yellow
title	опционально

10 дополнительных полей

Info
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.

MID

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

card

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Маска карты в формате ХХХХХХ****ХХХХ

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

card_hash

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту.

Этот параметр даст вам возможность в вашей системе:

Привязать карту под клиента.
Проверить не использовал ли другой клиент эту же карту.
Проверить какие кредиты, товары и услуги погашаются данной картой.
Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

brand

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee_type

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Признак каким образом взимается комиссия:

ACT - по актам.
TRANSACTION - потранзакционно.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

currency

Status

colour	Yellow
title	опционально

Валюта операции

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

decline_reason

Status

colour	Green
title	Обязательно

Причина, по которой транзакция была отклонена

hash

Status

colour	Green
title	Обязательно

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

Code Block

language	php

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

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

...

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

Промежуточный ответ
Status
colour Red
title асинхронний режим

Expand

title	Response о принятии запроса в обработку

Code Block

language	json

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

Параметры

Описание

action

Status

colour	Green
title	Обязательно

SALE

result

Status

colour	Green
title	Обязательно

ACCEPTED

order_id

Status

colour	Green
title	Обязательно

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

trans_id

Status

colour	Green
title	Обязательно

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

trans_date

Status

colour	Green
title	Обязательно

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

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

Expand

title	Проміжний Callback при наявності перевірки 3DS (варіант з GET)

Code Block

language	php

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

colour	Green
title	Обязательно

SALE

result

Status

colour	Green
title	Обязательно

REDIRECT

status

Status

colour	Green
title	Обязательно

3DS

order_id

Status

colour	Green
title	Обязательно

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

trans_id

Status

colour	Green
title	Обязательно

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

trans_date

Status

colour	Green
title	Обязательно

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

redirect_url

Status

colour	Green
title	Обязательно

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

redirect_params

Status

colour	Green
title	Обязательно

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

redirect_method

Status

colour	Green
title	Обязательно

GET

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

hash

Status

colour	Green
title	Обязательно

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

Code Block

language	php

md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)

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

Expand

title	Промежуточный Callback при наличии проверки 3DS (варіант з POST)

Code Block

language	php

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

colour	Green
title	Обязательно

SALE

result

Status

colour	Green
title	Обязательно

REDIRECT

status

Status

colour	Green
title	Обязательно

3DS

order_id

Status

colour	Green
title	Обязательно

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

trans_id

Status

colour	Green
title	Обязательно

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

trans_date

Status

colour	Green
title	Обязательно

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

redirect_url

Status

colour	Green
title	Обязательно

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

redirect_params

Status

colour	Green
title	Обязательно

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

redirect_method

Status

colour	Green
title	Обязательно

POST

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

hash

Status

colour	Green
title	Обязательно

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

Code Block

language	php

md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)

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

При успешной оплате
Status
colour Red
title асинхронний режим

Expand

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

Code Block

language	php

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

colour	Green
title	Обязательно

SALE

result

Status

colour	Green
title	Обязательно

SUCCESS

status

Status

colour	Green
title	Обязательно

SETTLED

PENDING только когда было указано auth = Y

order_id

Status

colour	Green
title	Обязательно

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

trans_id

Status

colour	Green
title	Обязательно

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

trans_date

Status

colour	Green
title	Обязательно

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

descriptor

Status

colour	Green
title	Обязательно

Это строка, которую владелец кредитной карты увидит в выписка из банка.

В большинстве случаев это веб-сайт поддержки клиентов.

auth_code

Status

colour	Green
title	Обязательно

Код авторизации от банка

amount

Status

colour	Yellow
title	опционально

Сумма транзакции

Info
Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.

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

Status

colour	Yellow
title	опционально

10 дополнительных полей

Info
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.

MID

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

card

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Маска карты в формате ХХХХХХ****ХХХХ

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

card_hash

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту.

Этот параметр даст вам возможность в вашей системе:

Привязать карту под клиента.
Проверить не использовал ли другой клиент эту же карту.
Проверить какие кредиты, товары и услуги погашаются данной картой.
Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

brand

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee_type

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Признак каким образом взимается комиссия:

ACT - по актам.
TRANSACTION - потранзакционно.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

currency

Status

colour	Yellow
title	опционально

Валюта операции

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

hash

Status

colour	Green
title	Обязательно

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

Code Block

language	php

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

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

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

Expand

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

Code Block

language	php

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

colour	Green
title	Обязательно

SALE

result

Status

colour	Green
title	Обязательно

DECLINED

status

Status

colour	Green
title	Обязательно

DECLINED

order_id

Status

colour	Green
title	Обязательно

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

trans_id

Status

colour	Green
title	Обязательно

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

trans_date

Status

colour	Green
title	Обязательно

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

amount

Status

colour	Yellow
title	опционально

Сумма транзакции

Info
Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.

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

Status

colour	Yellow
title	опционально

10 дополнительных полей

Info
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.

MID

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

card

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Маска карты в формате ХХХХХХ****ХХХХ

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

card_hash

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту.

Этот параметр даст вам возможность в вашей системе:

Привязать карту под клиента.
Проверить не использовал ли другой клиент эту же карту.
Проверить какие кредиты, товары и услуги погашаются данной картой.
Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

brand

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee_type

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Признак каким образом взимается комиссия:

ACT - по актам.
TRANSACTION - потранзакционно.

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

fee

Status

colour	Yellow
title	ОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

currency

Status

colour	Yellow
title	опционально

Валюта операции

Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

decline_reason

Status

colour	Green
title	Обязательно

Причина, по которой транзакция была отклонена

hash

Status

colour	Green
title	Обязательно

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

Code Block

language	php

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

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

...

При ошибке в запросе

Expand

title	Response в случая ошибки в запросе

Code Block

language	json

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

Versions Compared

Old Version 1

New Version Current

Key

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

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

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

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

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

Промежуточный ответ
Status
colour Red
title асинхронний режим

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

При успешной оплате
Status
colour Red
title асинхронний режим

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

При ошибке в запросе

Page Comparison

Versions Compared

Old Version 1

New Version Current

Key

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

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

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

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

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

Промежуточный ответ StatuscolourRedtitleасинхронний режим

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

При успешной оплате StatuscolourRedtitleасинхронний режим

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

При ошибке в запросе

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

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

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

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

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

Промежуточный ответ
Status
colour Red
title асинхронний режим

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

При успешной оплате
Status
colour Red
title асинхронний режим

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