Page Comparison

...

Expand

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

Code Block

language	json

{
  "action":"APPLEPAY",
  "result":"REDIRECT",
  "status":"3DS",
  "trans_id":"03346-89225- 87891",
  "order_id":"ORDER-12345",
  "trans_date":"2012-04-03 16:02:02",
  "redirect_url":"https://server_3ds.com/3ds.php",
  "redirect_params":
    {
      "PaReq":"bc5865698ae46de4eba4c51f0359a714",
      "MD":"111111111111111111111",
      "TermUrl":"https://term_url.com/3ds/67c14e5?trans_id=03346-89225-87891&hash=8b98db60fb3c24c14a6d7075241da38b"
    },
  "redirect_method":"POST"
}

ПараметрПараметри

Опис

action

Status

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

APPLEPAY

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	Проміжний Callback при наявності 3DS

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 для редіректу на 3DS

redirect_params

Status

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

Дані для 3DS

redirect_method

Status

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

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

hash

Status

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

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

Code Block

language	php

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

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

...

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

Сума

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

Status

colour	Yellow
title	опція

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

MID

Status

colour	Yellow
title	опція

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

card

Status

colour	Yellow
title	опція

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

card_hash

Status

colour	Yellow
title	опція

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

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

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

brand

Status

colour	Yellow
title	опція

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

fee_type

Status

colour	Yellow
title	опція

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

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

fee

Status

colour	Yellow
title	опція

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

currency

Status

colour	Yellow
title	опція

Валюта

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

...

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

...

Expand

title	Callback для редіректу платника на перевірку 3DS

Code Block

language	php

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

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)

hash

Status

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

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

Code Block

language	php

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

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

...

Expand

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

Code Block

language	php

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

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

SALE

result

Status

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

SUCCESS

status

Status

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

SETTLED

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

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

Сума

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

Status

colour	Yellow
title	ОПЦІЯ

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

MID

Status

colour	Yellow
title	ОПЦІЯ

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

card

Status

colour	Yellow
title	ОПЦІЯ

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

card_hash

Status

colour	Yellow
title	ОПЦІЯ

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

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

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

brand

Status

colour	Yellow
title	ОПЦІЯ

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

fee_type

Status

colour	Yellow
title	ОПЦІЯ

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

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

fee

Status

colour	Yellow
title	ОПЦІЯ

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

currency

Status

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

...

Expand

title	Callback при невдалому списанні

Code Block

language	php

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

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

Сума

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

Status

colour	Yellow
title	опція

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

MID

Status

colour	Yellow
title	опція

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

card

Status

colour	Yellow
title	опція

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

card_hash

Status

colour	Yellow
title	опція

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

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

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

brand

Status

colour	Yellow
title	опція

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

fee_type

Status

colour	Yellow
title	опція

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

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

fee

Status

colour	Yellow
title	опція

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

currency

Status

colour	Yellow
title	опція

Валюта

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

...

Versions Compared

Old Version 11

New Version 12

Key