Versions Compared

Key

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

...

Expand
titleResponse для редіректу платника на перевірку 3DS
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":"https://term_url.com/3ds/67c14e5?trans_id=03346-89225-87891&hash=8b98db60fb3c24c14a6d7075241da38b"
    },
  "redirect_method":"POST"
}

Параметр

Опис

action

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

APPLEPAY

result

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

REDIRECT

status

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

3DS

order_idTransaction ID in the Client’s system

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

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

trans_idTransaction ID in the Payment Platform

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

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

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

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

Параметры

Описание

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)

hash

Status
colourGreen
titleОбязательно
Зашифрованная подпись для проверки достоверности
ОБОВ'ЯЗКОВИЙ

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

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

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

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

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

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

...