Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

При оплаті з 3DS

...

Status
colourBlue
titleсинхронний режим

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

action
Обязательно
Expand
titleПромежуточный Response при наличии 3DS проверкиResponse для редіректу платника на перевірку 3DS (варіант з GET)
Code Block
languagejson
{
  "action": "SALE",
  "result": "REDIRECT",
  "status": "3DS",
  "transorder_id": "03346PLS-89225-8789117817174",
  "ordertrans_id": "ORDER42780-17679-1234505524",
  "trans_date": "20122024-0410-031601 16:0256:0207",
  "redirect_url": "https:\/\/server_3ds.com/3ds.phpasecg.ua\/api\/v2\/brw\/challenge\/init?txid=cd4545b6-6bbc-4d17",
  "redirect_params": {
    "PaReq": "bc5865698ae46de4eba4c51f0359a714"null,
    "MDredirect_method": "111111111111111111111GET",
    "TermUrl": "https://term_url.com/3ds/67c14e5?trans_id=03346-89225-87891&hash=8b98db60fb3c24c14a6d7075241da38b"
  },
  "redirect_method": "POST"
}

Параметры

Описание

Status
colourGreen
title

}

Параметри

Опис

action

Status
colourGreen
titleОБОВ'ЯЗКОВИЙ

SALE

result

Status
colourGreen
title

Обязательно

ОБОВ'ЯЗКОВИЙ

REDIRECT

status

Status
colourGreen
title

Обязательно

ОБОВ'ЯЗКОВИЙ

3DS

order_id

Status
colourGreen
title

Обязательно

ОБОВ'ЯЗКОВИЙ

Ордер ID

транзакции

в

системе

системі мерчанта

trans_id

Status
colourGreen
title

Обязательно

ОБОВ'ЯЗКОВИЙ

Ордер ID

транзакции

в

платежной системе

платіжній системі

trans_date

Status
colourGreen
title

Обязательно

ОБОВ'ЯЗКОВИЙ

Дата

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

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

redirect_url

Status
colourGreen
title

Обязательно

ОБОВ'ЯЗКОВИЙ

URL

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

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

redirect_params

Status
colourGreen
title

ОбязательноМассив определенных параметров

ОБОВ'ЯЗКОВИЙ

Дані для 3DS

redirect_method

Status
colourGreen
title

Обязательно

POST

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

ОБОВ'ЯЗКОВИЙ

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

action
Expand
titleПромежуточный Callback при наличии проверки 3DSResponse для редіректу платника на перевірку 3DS (варіант з POST)
Code Block
languagephpjson
array{
(   '"action' => 'SALE'": "SALE",
  '"result' => 'REDIRECT'": "REDIRECT",
  '"status' => '3DS'": "3DS",
  'order"trans_id' => '6b51033e-3e58-42e0-8ec3-88c97388018b'": "03346-89225-87891",
  'trans"order_id' => '28738-47774-55067'": "ORDER-12345",
  '"trans_date' => '2020-04-20 12:12:57'": "2012-04-0316:02:02",
  '"redirect_url' => '": "https://acs.privatbank.ua/pPaReqMC.jsp'server_3ds.com/3ds.php",
  '"redirect_params' =>": {
    "PaReq": "bc5865698ae46de4eba4c51f0359a714",
array  (  "MD": "111111111111111111111",
   'PaReq' => 'eJxVUllu2zAQvYqg/4qUIlFUMGYgxykaoEqN2j4AIxGxUi2Olsb+K/qTG+S3VygKpGhRtL0CdaMMHWUDSHDeLJw3Cxxty8L6rJo2r6uJ7TrUtlSV1lleXUzs1fLtG24fCViuG6VmC5X2jRKQqLaVF8rKs4k9lx/VlRvw8ID7YRhFYcgDHrmeF/KQc8apG/jcFjCP0U/AmElgIscD8gjxyyZdy6oTINOr6emZwCgWcCAjhFI1pzPBXB66jAF5gFDJUolpPF29P1k4xx8SZxUD2Sshrfuqa3aCUx/II4C+KcS66zbtISGbQnZ1VeSVctK6BGJsQJ6ZzHsjtfjXNs9EMouv8e7w0uQy3p4t6HWy/IT4ZALEeEAmOyU86lHqe9RyvUM8QQRkrwdZGhKmcoplPQDYmBzxaDGGlwrAdjc4jZ2IOJqeEKjtpq4UemALn2TIVJsK/U3fDV/0nf4x3OL7b7jRf/Uv/dvS//Uf/X34Otzqn9a5PO8L1Zq6nV4iQxMK5Lni43dmEmmHTfZdN2CMMz/wzTj2OsMgx356B5TtKRgAxESRcdJk3BKUXm3PPfYf2CM=',
      'TermUrl' => 'https://secure.platononline "TermUrl": "https://term_url.com/3ds/4de0025?operation_type=purchase&67c14e5?trans_id=2873803346-4777489225-55067&hash=***************************************************
    )87891&hash=8b98db60fb3c24c14a6d7075241da38b"
  },
  '"redirect_method' => 'POST',
  'hash' => '********************************',
)

Параметры

Описание

Status
": "POST"
}

Параметры

Описание

action

Status
colourGreen
titleОбязательно

SALE

result

Status
colourGreen
titleОбязательно

REDIRECT

status

Status
colourGreen
titleОбязательно

3DS

order_id

Status
colourGreen
titleОбязательно

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

trans_id

Status
colourGreen
titleОбязательно

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

trans_date

Status
colourGreen
titleОбязательно

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

redirect_url

Status
colourGreen
titleОбязательно

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

redirect_params

Status
colourGreen
titleОбязательно

Строка

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

redirect_method

Status
colourGreen
titleОбязательно

POST

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

hash

Status
colourGreen
titleОбязательно

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

Expand
titleПроміжний Callback при наявності перевірки 3DS (варіант з GET)
Expand
titleResponse при успешном списании
Code Block
languagephp
md5(
array 
strtoupper
(
  
strrev(email). CLIENT_PASS. strrev(payment_token) ) )
Info

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

При успішній оплаті з 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' => '
Code Block
languagejson
{
  "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' => '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' => '********************************',
)
Code Block
languagephp

Параметры

Описание

action

Status
colourGreen
titleОбязательно

SALE

result

Status
colourGreen
titleОбязательно

SUCCESS

REDIRECT

status

Status
colourGreen
titleОбязательно

SETTLED

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

3DS

order_id

Status
colourGreen
titleОбязательно

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

trans_id

Status
colourGreen
titleОбязательно

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

trans_date

Status
colourGreen
titleОбязательно

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

descriptoramount

redirect_url

Status
colourGreen
titleОбязательно

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

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

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

redirect_params

Status
colour

Yellow

Green
title

опционально

Обязательно

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

Info

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

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

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

redirect_method

Status
colour

Yellow

Green
title

опциональноMID

Обязательно

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

Info

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

GET

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

hash

Status
colour

Yellow

Green
title

ОПЦИОНАЛЬНО

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

Info

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

card

Status
colourYellow
titleОПЦИОНАЛЬНО

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

Info

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

card_hash

Status
colourYellow
titleОПЦИОНАЛЬНО

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

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

  • Привязать карту под клиента.

  • Проверить не использовал ли другой клиент эту же карту.

  • Проверить какие кредиты, товары и услуги погашаются данной картой.

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

Info

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

brand

Status
colourYellow
titleОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

Info

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

fee_type

Status
colourYellow
titleОПЦИОНАЛЬНО

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

  • ACT - по актам.

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

Info

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

fee

Status
colourYellow
titleОПЦИОНАЛЬНО

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

Info

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

currency

Status
colourYellow
titleопционально

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

Info

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

Expand
titleCallback при успешном списании

Обязательно

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

Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)
Info

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

Expand
titleПроміжний Callback при наявності перевірки 3DS (варіант з POST)
Code Block
languagephp
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
colourGreen
titleОбязательно

SALE

result

Status
colourGreen
titleОбязательно

SUCCESS

REDIRECT

status

Status
colourGreen
titleОбязательно

SETTLED

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

3DS

order_id

Status
colourGreen
titleОбязательно

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

trans_id

Status
colourGreen
titleОбязательно

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

trans_date

Status
colourGreen
titleОбязательно

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

descriptorauth_code

redirect_url

Status
colourGreen
titleОбязательно

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

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

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

redirect_params

Status
colourGreen
titleОбязательно

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

amount

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

redirect_method

Status
colour

Yellow

Green
title

опционально

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

Info

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

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

Status
colourYellow
titleопционально

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

Info

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

MID

Status
colourYellow
titleОПЦИОНАЛЬНО

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

Info

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

card

Status
colourYellow
titleОПЦИОНАЛЬНО

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

Info

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

card_hash

Status
colourYellow
titleОПЦИОНАЛЬНО

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

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

  • Привязать карту под клиента.

  • Проверить не использовал ли другой клиент эту же карту.

  • Проверить какие кредиты, товары и услуги погашаются данной картой.

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

Info

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

brand

Status
colourYellow
titleОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

Info

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

fee_type

Status
colourYellow
titleОПЦИОНАЛЬНО

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

  • ACT - по актам.

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

Info

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

fee

Status
colourYellow
titleОПЦИОНАЛЬНО

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

Info

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

currency

Status
colourYellow
titleопционально

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

Info

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

hash

Обязательно

POST

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

hash

Status
colourGreen
titleОбязательно

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

Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    CLIENT_PASS.
    strrev(payment_token)
  )
)
Info

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

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

Note

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

MID
Expand
titleCallback при успешном списании
Code Block
languagephp
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' => '********************************',
)
Expand
titleResponse при неуспешном списании
Code Block
languagejson
{
  "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

Status
colourGreen
titleОбязательно

SALE

result

Status
colourGreen
titleОбязательно

DECLINED

status

Status
colourGreen
titleОбязательно

DECLINED

order_id

Status
colourGreen
titleОбязательно

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

trans_id

Status
colourGreen
titleОбязательно

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

amount

Status
colourYellow
titleопционально

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

Info

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

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

Status
colourYellow
titleопционально

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

Info

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

Параметры

Описание

action

Status
colourGreen
titleОбязательно

SALE

result

Status
colourGreen
titleОбязательно

SUCCESS

status

Status
colourGreen
titleОбязательно

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

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

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

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

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

SETTLED

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

order_id

Status
colourGreen
titleОбязательно

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

trans_id

Status
colourGreen
titleОбязательно

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

trans_date

Status
colourGreen
titleОбязательно

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

descriptor

Status
colourGreen
titleОбязательно

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

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

auth_code

Status
colourGreen
titleОбязательно

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

amount

Status
colourYellow
titleопционально

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

Info

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

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

Status
colourYellow
titleопционально

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

Info

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

MID

Status
colourYellow
titleОПЦИОНАЛЬНО

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

Info

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

card

Status
colourYellow
titleОПЦИОНАЛЬНО

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

Info

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

card_hash

Status
colourYellow
titleОПЦИОНАЛЬНО

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

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

  • Привязать карту под клиента.

  • Проверить не использовал ли другой клиент эту же карту.

  • Проверить какие кредиты, товары и услуги погашаются данной картой.

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

Info

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

brand

Status
colourYellow
titleОПЦИОНАЛЬНО

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

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

Info

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

card

fee_type

Status
colourYellow
titleОПЦИОНАЛЬНО

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

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

  • ACT - по актам.

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

Info

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

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

fee

Status
colourYellow
titleОПЦИОНАЛЬНО

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

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

  • Привязать карту под клиента.

  • Проверить не использовал ли другой клиент эту же карту.

  • Проверить какие кредиты, товары и услуги погашаются данной картой.

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

    Info

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

    brand

    currency

    Status
    colourYellow
    title

    ОПЦИОНАЛЬНО

    опционально

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

    Info

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

    fee_type

    hash

    Status
    colour

    Yellow

    Green
    title

    ОПЦИОНАЛЬНО

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

    • ACT - по актам.

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

    Info

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

    fee

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    Info

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

    currency

    Status
    colourYellow
    titleопционально

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

    Info

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

    trans_date

    Status
    colourGreen
    titleОбязательно

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

    decline_reason

    Status
    colourGreen
    titleОбязательно

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

    Обязательно

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

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

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

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

    Note

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

    action
    Expand
    titleCallback при неуспешном списании
    Code Block
    languagephp
    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' => '********************************',
    )
    Expand
    titleResponse о принятии запроса в обработку
    Code Block
    languagejson
    {
      "action": "SALE",
      "result": "ACCEPTED",
      "trans_id": "03346-89211-86461",
      "order_id": "ORDER-12345",
      "trans_date": "2012-04-03 16:02:01"
    }

    Параметры

    Описание

    Параметры

    Описание

    action

    Status
    colourGreen
    titleОбязательно

    SALE

    result

    Status
    colourGreen
    titleОбязательно

    DECLINED

    status

    Status
    colourGreen
    titleОбязательно

    DECLINED

    order_id

    Status
    colourGreen
    titleОбязательно

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

    trans_id

    Status
    colourGreen
    titleОбязательно

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

    trans_date

    Status
    colourGreen
    titleОбязательно

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

    amount

    Status
    colourYellow
    titleопционально

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

    Info

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

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

    Status
    colourYellow
    titleопционально

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

    Info

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

    MID

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    Info

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

    card

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    Info

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

    card_hash

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

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

    • Привязать карту под клиента.

    • Проверить не использовал ли другой клиент эту же карту.

    • Проверить какие кредиты, товары и услуги погашаются данной картой.

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

    Info

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

    brand

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

    'brand' => 'VISA'

    'brand' => 'MASTER'

    'brand" => 'PROSTIR'

    Info

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

    fee_type

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    • ACT - по актам.

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

    Info

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

    fee

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    Info

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

    currency

    Status
    colourYellow
    titleопционально

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

    Info

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

    decline_reason

    Status
    colourGreen
    titleопционально

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

    Info

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

    decline_reason

    Status
    colourGreen
    titleОбязательно

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

    hash

    Status
    colourGreen
    titleОбязательно

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

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

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

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

    Промежуточный ответ з 3DS (асинхронный режим)

    Обязательно

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

    hash

    Status
    colourGreen
    titleОбязательно

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

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

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

    ...

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

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

    Expand
    titleResponse о принятии запроса в обработку
    Code Block
    languagejson
    {
      "action": "SALE",
      "result": "ACCEPTED",
      "trans_id": "03346-89211-86461",
      "order_id": "ORDER-12345",
      "trans_date": "2012-04-03 16:02:01"
    }

    Параметры

    Описание

    action

    Status
    colourGreen
    titleОбязательно

    SALE

    result

    Status
    colourGreen
    titleОбязательно

    ACCEPTED

    order_id

    Status
    colourGreen
    titleОбязательно

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

    trans_id

    Status
    colourGreen
    titleОбязательно

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

    trans_date

    Status
    colourGreen
    titleОбязательно

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

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

    Expand
    titleПроміжний Callback при наявності перевірки 3DS (варіант з GET)
    Code Block
    languagephp
    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
    colourGreen
    titleОбязательно

    SALE

    result

    Status
    colourGreen
    titleОбязательно

    REDIRECT

    status

    Status
    colourGreen
    titleОбязательно

    3DS

    order_id

    Status
    colourGreen
    titleОбязательно

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

    trans_id

    Status
    colourGreen
    titleОбязательно

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

    trans_date

    Status
    colourGreen
    titleОбязательно

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

    redirect_url

    Status
    colourGreen
    titleОбязательно

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

    redirect_params

    Status
    colourGreen
    titleОбязательно

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

    redirect_method

    Status
    colourGreen
    titleОбязательно

    GET

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

    hash

    Status
    colourGreen
    titleОбязательно

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

    Code Block
    languagephp
    md5(
      strtoupper(
        strrev(email).
        CLIENT_PASS.
        strrev(payment_token)
      )
    )
    Info

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

    resultorder_id
    Expand
    titleПромежуточный Callback при наличии проверки 3DS (варіант з POST)
    Code Block
    languagephp
    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
    colourGreen
    titleОбязательно

    SALE

    result

    Status
    colourGreen
    titleОбязательно

    REDIRECT

    status

    Status
    colourGreen
    titleОбязательно

    3DS

    order_id

    Status
    colourGreen
    titleОбязательно

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

    trans_id

    Status
    colourGreen
    titleОбязательно

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

    trans_date

    Status
    colourGreen
    titleОбязательно

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

    redirect_url

    Status
    colourGreen
    titleОбязательно

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

    redirect_params

    Status
    colourGreen
    titleОбязательно

    SALE

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

    redirect_method

    Status
    colourGreen
    titleОбязательно

    ACCEPTED

    POST

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

    hash

    Status
    colourGreen
    titleОбязательно

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

    trans_id

    Status
    colourGreen
    titleОбязательно

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

    trans_date

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

    Code Block
    languagephp
    md5(
      strtoupper(
        strrev(email).
        CLIENT_PASS.
        strrev(payment_token)
      )
    )
    Info

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

    При успешной оплате
    Status
    colour

    ...

    Red
    title

    ...

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

    ...

    асинхронний режим

    Expand
    titleCallback при успешном списании
    Code Block
    languagephp
    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
    colourGreen
    titleОбязательно

    SALE

    result

    Status
    colourGreen
    titleОбязательно

    SUCCESS

    status

    Status
    colourGreen
    titleОбязательно

    SETTLED

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

    order_id

    Status
    colourGreen
    titleОбязательно

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

    trans_id

    Status
    colourGreen
    titleОбязательно

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

    trans_date

    Status
    colourGreen
    titleОбязательно

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

    descriptor

    Status
    colourGreen
    titleОбязательно

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

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

    auth_code

    Status
    colourGreen
    titleОбязательно

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

    amount

    Status
    colourYellow
    titleопционально

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

    Info

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

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

    Status
    colourYellow
    titleопционально

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

    Info

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

    MID

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    Info

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

    card

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    Info

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

    card_hash

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

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

    • Привязать карту под клиента.

    • Проверить не использовал ли другой клиент эту же карту.

    • Проверить какие кредиты, товары и услуги погашаются данной картой.

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

    Info

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

    brand

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

    'brand' => 'VISA'

    'brand' => 'MASTER'

    'brand" => 'PROSTIR'

    Info

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

    fee_type

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    • ACT - по актам.

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

    Info

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

    fee

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    Info

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

    currency

    Status
    colourYellow
    titleопционально

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

    Info

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

    hash

    Status
    colourGreen
    titleОбязательно

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

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

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

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

    ...

    Status
    colourRed
    titleасинхронний режим

    Expand
    titleCallback при неуспешном списании
    Code Block
    languagephp
    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
    colourGreen
    titleОбязательно

    SALE

    result

    Status
    colourGreen
    titleОбязательно

    DECLINED

    status

    Status
    colourGreen
    titleОбязательно

    DECLINED

    order_id

    Status
    colourGreen
    titleОбязательно

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

    trans_id

    Status
    colourGreen
    titleОбязательно

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

    trans_date

    Status
    colourGreen
    titleОбязательно

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

    amount

    Status
    colourYellow
    titleопционально

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

    Info

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

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

    Status
    colourYellow
    titleопционально

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

    Info

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

    MID

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    Info

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

    card

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    Info

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

    card_hash

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

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

    • Привязать карту под клиента.

    • Проверить не использовал ли другой клиент эту же карту.

    • Проверить какие кредиты, товары и услуги погашаются данной картой.

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

    Info

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

    brand

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

    'brand' => 'VISA'

    'brand' => 'MASTER'

    'brand" => 'PROSTIR'

    Info

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

    fee_type

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    • ACT - по актам.

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

    Info

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

    fee

    Status
    colourYellow
    titleОПЦИОНАЛЬНО

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

    Info

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

    currency

    Status
    colourYellow
    titleопционально

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

    Info

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

    decline_reason

    Status
    colourGreen
    titleОбязательно

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

    hash

    Status
    colourGreen
    titleОбязательно

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

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

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

    ...

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

    Expand
    titleResponse в случая ошибки в запросе
    Code Block
    languagejson
    {
      "result": "ERROR",
      "error_message": "Error description"
    }