Versions Compared

Key

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

...

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

Note

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

action
Expand
titleResponse Callback при успешном списании
Code Block
languagejsonphp
{array (
  "action": "SALE"'action' => 'SALE',
  "result": "SUCCESS"'result' => 'SUCCESS',
  "status": "SETTLED"'status' => 'SETTLED',
  "trans'order_id": "03346-89217-70541"' => '1_691201',
  "order'trans_id": "ORDER-12345"' => '31176-65336-00444',
  "descriptor": "test",
  "'trans_date": "2012-04-03' => '2021-01-27 16:02:01"
}

Параметры

Описание

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

Это строка, которую владелец кредитной карты увидит в выписка из банка.

В большинстве случаев это веб-сайт поддержки клиентов.

amount

auth_code

Status
colour

Yellow

Green
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

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

expand

hash

Status
colourGreen
title

Callback при успешном списании

Обязательно

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

Code Block
languagephp
array
md5(
  
'action' => 'SALE',
strtoupper(
    
'result' => 'SUCCESS',
strrev(email).
    
'status' => 'SETTLED',
client_pass.
    
'order
trans_id
'
.
=>
 
'1_691201',
   
'trans_id' => '31176-65336-00444',
strrev(
     
'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 следует указать пустое значение для email.

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

Причина, по которой транзакция была отклонена
Expand
titleResponse при неуспешном списании
Code Block
languagejson
{
  "action": "SALE",
  "result": "DECLINED",
  "status": "DECLINED",
  "trans_id": "03346-89214-54141",
  "order_id": "ORDER-12345",
  "trans_date": "2012-04-0316:02:01",
  "decline_reason": "Declined by processing"
}

Параметры

Описание

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 транзакции в платежной системе

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

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

trans_date

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

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

decline_reason

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

 substr(card,0,6).
      substr(card,-4)
    )
  )
)
Info

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

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

Note

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

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

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.

...