Versions Compared

Old Version 2

changes.mady.by.user Tech Platon

Saved on

compared with

New Version 3

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

Проміжний Callback при наявності перевірки
Expand
titleПроміжний Response при наявності перевірки Response для редіректу платника на перевірку 3DS
title
Code Block
languagejson
{
  "action":"SALE",
  "result":"REDIRECT",
  "status":"3DS",
  "ordertrans_id":"6b51033e03346-3e58-42e0-8ec3-88c97388018b89225- 87891",
  "transorder_id":"28738ORDER-47774-5506712345",
  "trans_date":"20202012-04-2003 1216:1202:5702",
  "redirect_url":"https:\/\/acs.privatbank.ua\/pPaReqMC.jspserver_3ds.com/3ds.php",
  "redirect_params":
    {
      "PaReq":"eJxVUllu2zAQvYqg\/4qUIlFUMGYgxykaoEqN2j4AIxGxUi2Olsb+K\/qTG+S3VygKpGhRtL0CdaMMHWUDSHDeLJw3Cxxty8L6rJo2r6uJ7TrUtlSV1lleXUzs1fLtG24fCViuG6VmC5X2jRKQqLaVF8rKs4k9lx\/VlRvw8ID7YRhFYcgDHrmeF\/KQc8apG\/jcFjCP0U\/AmElgIscD8gjxyyZdy6oTINOr6emZwCgWcCAjhFI1pzPBXB66jAF5gFDJUolpPF29P1k4xx8SZxUD2Sshrfuqa3aCUx\/II4C+KcS66zbtISGbQnZ1VeSVctK6BGJsQJ6ZzHsjtfjXNs9EMouv8e7w0uQy3p4t6HWy\/IT4ZALEeEAmOyU86lHqe9RyvUM8QQRkrwdZGhKmcoplPQDYmBzxaDGGlwrAdjc4jZ2IOJqeEKjtpq4UemALn2TIVJsK\/U3fDV\/0nf4x3OL7b7jRf\/Uv\/dvS\/\/Uf\/X34Otzqn9a5PO8L1Zq6nV4iQxMK5Lni43dmEmmHTfZdN2CMMz\/wzTj2OsMgx356B5TtKRgAxESRcdJk3BKUXm3PPfYf2CM=",bc5865698ae46de4eba4c51f0359a714",
      "TermUrlMD":"https:\/\/secure.platononline.com\/3ds\/4de0025?operation_type=purchase&"111111111111111111111",
      "TermUrl":"https://term_url.com/3ds/67c14e5?trans_id=2873803346-4777489225-55067&hash=*****************************************************************************"
  }
}

Параметры

Описание

action

SALE

result

REDIRECT

status

3DS

order_id

Уникальный ордер ID транзакции в системе мерчанта

trans_id

Уникальный ордер ID транзакции в системе Platon

trans_date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

redirect_url

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

redirect_params

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

Expand
87891&hash=8b98db60fb3c24c14a6d7075241da38b"
    },
  "redirect_method":"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 для редіректу на 3DS

redirect_params

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

Дані для 3DS

redirect_method

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

Метод відправки параметрів 3DS (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=',
      'TermUrl' => 'https://secure.platononline.com/3ds/4de0025?operation_type=purchase&trans_id=28738-47774-55067&hash=***************************************************
    ),
  'redirect_method' => 'POST',
  'hash' => '********************************',
)
Параметры

Параметри

Описание

status

Опис

action

SALE

result

REDIRECT

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

SALE

result

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

REDIRECT

status

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

3DS

order_id

Уникальный ордер ID транзакции в системе

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

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

trans_id

Уникальный ордер ID транзакции в системе Platon

trans_date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

redirect_url

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

redirect_params

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

redirect_method

Метод передачи параметров (POST/GET)

hash

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

...

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

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

trans_date

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

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

redirect_url

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

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

redirect_params

Status
colour

...

Code Block
languagejson
{
  "action":"SALE",
  "result":"ACCEPTED",
  "order_id":"4385302",
  "trans_id":"28261-34099-19648",
  "trans_date":"2020-02-25 06:50:09"
}

...

Параметр

...

Описание

...

action

...

SALE

...

result

...

ACCEPTED

...

order_id

...

Уникальный ордер ID транзакции в системе мерчанта

...

trans_id

...

Уникальный ордер ID транзакции в системе Platon

...

trans_date

...

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

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

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

Green
title

...

Note

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

...

titleCallback при успішній оплаті з 3DS
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

...

SALE

...

result

...

SUCCESS

...

status

...

SETTLED (PENDING, если в запросе было указано auth = Y)

...

order_id

...

Уникальный ордер ID транзакции в системе мерчанта

...

trans_id

...

Уникальный ордер ID транзакции в системе Platon

...

trans_date

...

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

...

descriptor

...

NULL

...

recurring_token

...

Зашифрованный токен карты для последующих транзакций по rc_token

...

card_token

...

Зашифрованный токен карты для последующих транзакций по card_token

...

card_hash

...

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

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

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

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

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

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

Info

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

...

hash

...

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

Code Block
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 відсутній.

...

titleCallback при невдалій оплаті з 3DS
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

...

SALE

...

result

...

DECLINED

...

status

...

DECLINED

...

order_id

...

Уникальный ордер ID транзакции в системе мерчанта

...

trans_id

...

Уникальный ордер ID транзакции в системе Platon

...

trans_date

...

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

...

descriptor

...

NULL

...

decline_reason

...

Причина отмены транзакции

...

hash

...

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

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

...

titleResponse про прийняття запиту на обробку

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

Дані для 3DS

redirect_method

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

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

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

Note

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

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 якщо оплата в холді

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

Note

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

Expand
titleCallback при невдалій оплаті
Code Block
languagephp
array (
  'action' => 'SALE',
  'result' => 'REDIRECTDECLINED',
  'status' => '3DSDECLINED',
  'order_id' => '6b51033e-3e58-42e0-8ec3-88c97388018b1_691201',
  'trans_id' => '2873831176-4777465336-5506700444',
  'trans_date' => '20202021-0401-2027 1216:1255:5733',
  'redirectdecline_urlreason' => 'https://acs.privatbank.ua/pPaReqMC.jsp',
  'redirect_params' => 
    array (
      'PaReq' => 'eJxVUllu2zAQvYqg/4qUIlFUMGYgxykaoEqN2j4AIxGxUi2Olsb+K/qTG+S3VygKpGhRtL0CdaMMHWUDSHDeLJw3Cxxty8L6rJo2r6uJ7TrUtlSV1lleXUzs1fLtG24fCViuG6VmC5X2jRKQqLaVF8rKs4k9lx/VlRvw8ID7YRhFYcgDHrmeF/KQc8apG/jcFjCP0U/AmElgIscD8gjxyyZdy6oTINOr6emZwCgWcCAjhFI1pzPBXB66jAF5gFDJUolpPF29P1k4xx8SZxUD2Sshrfuqa3aCUx/II4C+KcS66zbtISGbQnZ1VeSVctK6BGJsQJ6ZzHsjtfjXNs9EMouv8e7w0uQy3p4t6HWy/IT4ZALEeEAmOyU86lHqe9RyvUM8QQRkrwdZGhKmcoplPQDYmBzxaDGGlwrAdjc4jZ2IOJqeEKjtpq4UemALn2TIVJsK/U3fDV/0nf4x3OL7b7jRf/Uv/dvS//Uf/X34Otzqn9a5PO8L1Zq6nV4iQxMK5Lni43dmEmmHTfZdN2CMMz/wzTj2OsMgx356B5TtKRgAxESRcdJk3BKUXm3PPfYf2CM=',
      'TermUrl' => 'https://secure.platononline.com/3ds/4de0025?operation_type=purchase&trans_id=28738-47774-55067&hash=***************************************************
    ),
  'redirect_method' => 'POST',
  'hash' => '********************************',
)

Параметры

Описание

action

SALE

result

REDIRECT

status

3DS

order_id

Уникальный ордер ID транзакции в системе мерчанта

trans_id

Уникальный ордер ID транзакции в системе Platon

trans_date

Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)

redirect_url

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

redirect_params

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

redirect_method

Метод передачи параметров (POST/GET)

hash

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

...

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

...

При оплаті з 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
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)

Параметри

Опис

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.
    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' => '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асинхронний режим

action
Expand
titleCallback при успішній оплатіневдалому списанні
Code Block
languagephp
array (
  'action' => 'SALE',
  'result' => 'SUCCESSDECLINED',
  'status' => 'SETTLEDDECLINED',
  'order_id' => '43853234092002',
  'trans_id' => '2826128076-4778929879-2857899538',
  'trans_date' => '2020-02-2503 0720:1249:5847',
  'descriptor' => NULL,
  'recurring_tokendecline_reason' => '01e00c2b39bb3b933723307c442efd02',Declined by  'card_token' => '8ef3111ac1093f6ccb817acef7f0845601d0994689a5f57949f94b0d086c7fe2'processing',
  'hash' => '********************************',
)

Параметр

Описание

Параметри
Опис
action
 Status
colourGreen
titleОБОВ'ЯЗКОВИЙ
SALE
result
SUCCESS
 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
SALE
result
DECLINED
status
DECLINED
order_id
Уникальный ордер ID транзакции в системе мерчанта
trans_id
Уникальный ордер ID транзакции в системе Platon
trans_date
Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
descriptor
NULL
decline_reason
Причина отмены транзакции
hash
Зашифрованная подпись для проверки достоверности коллбека
code
 Status
SETTLED (PENDING, если в запросе было указано auth = Y)
order_id
Уникальный ордер ID транзакции в системе мерчанта
trans_id
Уникальный ордер ID транзакции в системе Platon
trans_date
Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
descriptor
NULL
recurring_token
Зашифрованный токен карты для последующих транзакций по rc_token
card_token
Зашифрованный токен карты для последующих транзакций по card_token
card_hash
Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту.
Этот параметр даст вам возможность в вашей системе:
  • Привязать карту под клиента.
  • Проверить не использовал ли другой клиент эту же карту.
  • Проверить какие кредиты, товары и услуги погашаются данной картой.
  • Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией.
 Info
Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
hash
Зашифрованная подпись для проверки достоверности коллбека
 Code Block
md5(
  strtoupper(
    strrev(email).
    client_pass.
    trans_id.
    strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)
 Info
Внимание! Если при запросе на оплату не был указан email, то при проверке hash в подписи Callback следует указать пустое значение для email.
При невдалій оплаті 
 Status
colourRed
titleасинхронний режим
Внимание! Если при запросе на оплату не был указан email, то при проверке hash в подписи Callback следует указать пустое значение для email.
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,
0,6).
      substr(card,-4)
    )
  )
)
 Info
-4)
    )
  )
)
 Info
Увага! Якщо в запиті на оплату не було вказано email, то при перевірці hash вкажіть пусте значення email.Зашифрованная подпись для проверки достоверности коллбека
...
При помилці в запиті
 Expand
titleResponse при помилці в запиті
 Code Block
languagejson
{
  "result":"ERROR",
  "error_message":"Error description"
}