Versions Compared

Old Version 1

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
Code Block
languagejson
{
  "action":"APPLEPAY",
  "result":"SUCCESS",
  "status":"SETTLED",
  "order_id":"ORDER-12345",
  "trans_id":"03346-89217- 70541",
  "descriptor":"test",
  "trans_date":"2012-04-03 16:02:01",
  "recurring_token":"a1a6de416405ada72bb47a49176471dc"
} 
Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.

trans_id

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

Опис

action

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

APPLEPAY

result
SUCCESSPENDING/SETTLED; only PENDING when auth=Y

Status

status

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

SUCCESS

status

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

SETTLED

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

order_idTransaction ID in the Client’s system

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

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

ext1 - ext10

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

Info

Transaction ID in the Payment Platform

trans_date 

Transaction date in the Payment Platform 

descriptor

This is a string which the owner of the credit card will see in the statement from the bank. In most cases, this is the Customers support web-site.

recurring_token

RC_TOKEN

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

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

trans_date

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

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

descriptor

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

Опис

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

Status
colourYellow
titleОПЦІЯ

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

auth_code
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

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

MIDcard

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

MID

Status
colourYellow
titleОПЦІЯ

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

card

Status
colourYellow
title

ОПЦИОНАЛЬНО

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

Info

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

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

ОПЦІЯ

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

card_hash

Status
colourYellow
title

ОПЦИОНАЛЬНО

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

Info

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

card_hash

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

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

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

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

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

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

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

ОПЦІЯ

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

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

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

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

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

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

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

опционально

ОПЦІЯ

Валюта

операцииhash

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

...

array ( 'action' => 'SALE',
Expand
titleResponse при невдалому списанні без 3DS
Code Block
languagejson
{
  "action":"APPLEPAY",
  "result":"DECLINED",
  "status":"DECLINED",
  "order_id":"ORDER-12345",
  "trans_id":"03346- 89214-54141",
  "trans_date":"2012-04-03 16:02:01",
  "decline_reason":"Declined by processing"
}
Code Block
languagephp

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

ОписаниеОпис

action

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

APPLEPAY

result

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

DECLINED

status
DECLINED

Status

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

decline_reason

The reason why the transaction was declined 

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

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

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

order_id

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

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

trans_id

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

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

trans_date

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

Опис

decline_reason

Status
colourGreen
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

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

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

Info

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

card

MID

Status
colourYellow
titleопція

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

card

Status
colourYellow
title

ОПЦИОНАЛЬНО

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

Info

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

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

опція

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

card_hash

Status
colourYellow
title

ОПЦИОНАЛЬНО

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

Info

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

card_hash

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

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

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

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

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

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

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

опція

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

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

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

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

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

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

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.

перевірці hash вкажіть пусте значення email.Зашифрованная подпись для проверки достоверности коллбека

...

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

...

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

Проміжна відповідь
Status
colourRed
titleасинхронний режим

Expand
titleCallback при успішному списанніResponse при успішній відправці запиту на обробку
Code Block
languagephpjson
array{
(   'action' => 'SALE'"action":"SALE",
  'result' => 'SUCCESS'"result":"ACCEPTED",
  'status' => 'SETTLED'"trans_id":"03346-89211- 86461",
  '"order_id' => '4385323',
  'trans_id' => '28261-47789-28578'":"ORDER-12345",
  '"trans_date' => '2020-02-25 07:12:58',
  'descriptor' => NULL,
  'recurring_token' => '01e00c2b39bb3b933723307c442efd02',
  'card_token' => '8ef3111ac1093f6ccb817acef7f0845601d0994689a5f57949f94b0d086c7fe2":"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 при успішному списанні
Code Block
languagephp
array (
  'action' => 'SALE',
  'hashresult' => '********************************',
)

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

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