Versions Compared

Old Version 5

changes.mady.by.user Tech Platon

Saved on

compared with

New Version Current

changes.mady.by.user Tech Platon

Saved on

Key

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

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

...

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

...

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

...

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

...

Expand
titleResponse для редіректу платника на перевірку 3DS (варіант з GET)
language
Code Block
json
{
  "action":"APPLEPAY",
  "result":"REDIRECT",
  "status":"3DS",
  "transorder_id":"03346-89225- 87891PLS-17817174",
  "ordertrans_id":"ORDER42780-17679-1234505524",
  "trans_date":"20122024-0410-0301 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,
      "MD"redirect_method":"111111111111111111111GET",
      "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)

Expand
titleПромежуточный Callback при наличии проверки 3DS
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='
}

Параметри

Опис

action

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

APPLEPAY

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ОБОВ'ЯЗКОВИЙ

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

Описание
Expand
titleResponse для редіректу платника на перевірку 3DS (варіант з POST)
Code Block
languagejson
{
  "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' => '"TermUrl":"https://secureterm_url.platononline.com/3ds/4de0025?operation_type=purchase&67c14e5?trans_id=2873803346-4777489225-5506787891&hash=***************************************************
    )8b98db60fb3c24c14a6d7075241da38b"
    },
  '"redirect_method' => 'POST',
  'hash' => '********************************',
)

Параметры

":"POST"
}

Параметри

Опис

action

Status
colourGreen
title

Обязательно

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

SALE

APPLEPAY

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

ОбязательноСтрока параметров
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

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

Дані для 3DS

redirect_method

Status
colourGreen
title

Обязательно

POST

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

hash

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

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

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

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

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

Note

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

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

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

resultstatus
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Обязательно

SALE

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

trans_id

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

SUCCESS

order_id

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

trans_date

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

SETTLED

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

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

redirect_url

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

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

trans_id

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

redirect_params

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

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

trans_date

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

redirect_method

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

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

descriptor
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

GET

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

hash

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

Note

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

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

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ОБОВ'ЯЗКОВИЙ

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ОБОВ'ЯЗКОВИЙ

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

hash

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

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

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

Увага! Якщо в запиті на оплату не було вказано email, то при перевірці hash вкажіть пусте значення email.

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

Note

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

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

Параметри

Опис

action

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

SALE

result

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

SUCCESS

status

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

SETTLED

PENDING якщо оплата в холді

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

ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

Info

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

ОПЦІЯ

Сума

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

Status
colourYellow
title

ОПЦИОНАЛЬНО

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

  • ACT - по актам.

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

Info

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

ОПЦІЯ

10 додаткових полів

MID

Status
colourYellow
titleОПЦІЯ

Унікальний ідентифікатор термінала в платіжній системі.

card

Status
colourYellow
title

ОПЦИОНАЛЬНО

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

Info

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

currency

decline_reason

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

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

hash

ОПЦІЯ

Маска картки в форматі ХХХХХХ****ХХХХ

card_hash

Status
colourYellow
title

опционально

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

Info

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

ОПЦІЯ

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

Цей параметр дозволить вам в вашій системі:

  • Прив'язати картку до клієнта.

  • Перевірити, чи не використовував інший клієнт цю ж картку.

  • Перевірити, які кредити, товари та послуги погашаються цією карткою.

  • Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.

brand

Status
colour

Green

Yellow
title

Обязательно

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

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

ОПЦІЯ

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

fee_type

Status
colourYellow
titleОПЦІЯ

Ознака як буде списуватись комісія з мерчанта:

  • ACT - по актам.

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

fee

Status
colourYellow
titleОПЦІЯ

Сума комісії з мерчанта в ГРН

currency

Status
colourYellow
titleОПЦІЯ

Валюта

hash

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

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

Code Block
languagephp
md5(
  strtoupper(
    strrev(email).
    client_pass.
substr(card,-4)
   trans_id.
)
   strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)
Info
Внимание! Если при запросе

Увага! Якщо в запиті на оплату не

был указан

було вказано email, то при

проверке hash в подписи Callback следует указать пустое значение для

перевірці hash вкажіть пусте значення email.

При невдалій оплаті з 3DS

...

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

Note

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

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' => '********************************', )
Expand
titleResponse при успешной отправке запроса на обработку оплатыCallback при невдалій оплаті
Code Block
languagejsonphp
{array (
  "action":"SALE"'action' => 'SALE',
  "result":"ACCEPTED"'result' => 'DECLINED',
  "trans_id":"03346-89211- 86461"'status' => 'DECLINED',
  'order_id' => '1_691201',
  "order_id":"ORDER-12345"'trans_id' => '31176-65336-00444',
  "'trans_date":"2012-04-03' => '2021-01-27 16:02:01"
}
Параметр
55:33',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)
Expand
titleCallback при невдалому списанні
Code Block
languagephp

Параметри

Опис

action

SALE

Status

result

colour

ACCEPTED

Green

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

Expand
titleCallback для редіректу платника на перевірку 3DS
Code Block
languagephp
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 (асинхронний режим)

Expand
titleCallback при успішному списанні
Code Block
languagephp
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 (асинхронний режим)

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опція

Сума

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

Status
colourYellow
titleопція

10 додаткових полів

MID

Status
colourYellow
titleопція

Унікальний ідентифікатор термінала в платіжній системі.

card

Status
colourYellow
titleопція

Маска картки в форматі ХХХХХХ****ХХХХ

card_hash

Status
colourYellow
titleопція

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

Цей параметр дозволить вам в вашій системі:

  • Прив'язати картку до клієнта.

  • Перевірити, чи не використовував інший клієнт цю ж картку.

  • Перевірити, які кредити, товари та послуги погашаються цією карткою.

  • Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.

brand

Status
colourYellow
titleопція

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

fee_type

Status
colourYellow
titleопція

Ознака як буде списуватись комісія з мерчанта:

  • ACT - по актам.

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

fee

Status
colourYellow
titleопція

Сума комісії з мерчанта в ГРН

currency

Status
colourYellow
titleопція

Валюта

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 вкажіть пусте значення 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.

Expand
titleCallback для редіректу платника на перевірку 3DS (варіант з POST)
Code Block
languagephp
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)

Параметри

Опис

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ОБОВ'ЯЗКОВИЙ

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

hash

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

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

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

Увага! Якщо в запиті на оплату не було вказано email, то при перевірці hash вкажіть пусте значення email.

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

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

Параметри

Опис

action

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

SALE

result

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

SUCCESS

status

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

SETTLED

PENDING якщо оплата в холді

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ОПЦІЯ

Сума

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

Status
colourYellow
titleОПЦІЯ

10 додаткових полів

MID

Status
colourYellow
titleОПЦІЯ

Унікальний ідентифікатор термінала в платіжній системі.

card

Status
colourYellow
titleОПЦІЯ

Маска картки в форматі ХХХХХХ****ХХХХ

card_hash

Status
colourYellow
titleОПЦІЯ

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

Цей параметр дозволить вам в вашій системі:

  • Прив'язати картку до клієнта.

  • Перевірити, чи не використовував інший клієнт цю ж картку.

  • Перевірити, які кредити, товари та послуги погашаються цією карткою.

  • Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.

brand

Status
colourYellow
titleОПЦІЯ

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

fee_type

Status
colourYellow
titleОПЦІЯ

Ознака як буде списуватись комісія з мерчанта:

  • ACT - по актам.

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

fee

Status
colourYellow
titleОПЦІЯ

Сума комісії з мерчанта в ГРН

currency

Status
colourYellow
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 вкажіть пусте значення email.

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

Expand
titleCallback при невдалому списанні
Code Block
languagephp
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' => '********************************',
)

Параметри

Опис

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опція

Сума

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

Status
colourYellow
titleопція

10 додаткових полів

MID

Status
colourYellow
titleопція

Унікальний ідентифікатор термінала в платіжній системі.

card

Status
colourYellow
titleопція

Маска картки в форматі ХХХХХХ****ХХХХ

card_hash

Status
colourYellow
titleопція

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

Цей параметр дозволить вам в вашій системі:

  • Прив'язати картку до клієнта.

  • Перевірити, чи не використовував інший клієнт цю ж картку.

  • Перевірити, які кредити, товари та послуги погашаються цією карткою.

  • Відстежувати шахрайство, коли клієнт використовує ту ж картку з іншого облікового запису, наприклад, щоб знову скористатися акцією.

brand

Status
colourYellow
titleопція

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

fee_type

Status
colourYellow
titleопція

Ознака як буде списуватись комісія з мерчанта:

  • ACT - по актам.

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

fee

Status
colourYellow
titleопція

Сума комісії з мерчанта в ГРН

currency

Status
colourYellow
titleопція

Валюта

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 вкажіть пусте значення email.Зашифрованная подпись для проверки достоверности коллбека

...

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

Expand
titleResponse при помилці в запиті
Code Block
languagejson
{
  "result":"ERROR",
  "error_message":"Error description"
}