Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

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

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

 Response при успешном списании
{
  "action": "SALE",
  "result": "SUCCESS",
  "status": "SETTLED",
  "trans_id": "03346-89217-70541",
  "order_id": "ORDER-12345",
  "descriptor": "test",
  "trans_date": "2012-04-03 16:02:01"
}

Параметры

Описание

action
ОБЯЗАТЕЛЬНО

SALE

result
ОБЯЗАТЕЛЬНО

SUCCESS

status
ОБЯЗАТЕЛЬНО

SETTLED

PENDING только когда было указано auth = Y

order_id
ОБЯЗАТЕЛЬНО

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

trans_id
ОБЯЗАТЕЛЬНО

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

trans_date
ОБЯЗАТЕЛЬНО

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

descriptor
ОБЯЗАТЕЛЬНО

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

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

amount
ОПЦИОНАЛЬНО

Сумма транзакции

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

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
ОПЦИОНАЛЬНО

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

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

MID
ОПЦИОНАЛЬНО

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

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

card
ОПЦИОНАЛЬНО

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

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

card_hash
ОПЦИОНАЛЬНО

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

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

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

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

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

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

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

brand
ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

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

fee_type
ОПЦИОНАЛЬНО

Признак каким образом взимается комиссия:

  • ACT - по актам.

  • TRANSACTION - потранзакционно.

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

fee
ОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

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

currency
ОПЦИОНАЛЬНО

Валюта операции

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

 Callback при успешном списании
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
ОБЯЗАТЕЛЬНО

SALE

result
ОБЯЗАТЕЛЬНО

SUCCESS

status
ОБЯЗАТЕЛЬНО

SETTLED

PENDING только когда было указано auth = Y

order_id
ОБЯЗАТЕЛЬНО

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

trans_id
ОБЯЗАТЕЛЬНО

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

trans_date
ОБЯЗАТЕЛЬНО

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

descriptor
ОБЯЗАТЕЛЬНО

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

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

auth_code
ОБЯЗАТЕЛЬНО

Код авторизации от банка

amount
ОПЦИОНАЛЬНО

Сумма транзакции

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

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
ОПЦИОНАЛЬНО

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

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

MID
ОПЦИОНАЛЬНО

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

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

card
ОПЦИОНАЛЬНО

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

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

card_hash
ОПЦИОНАЛЬНО

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

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

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

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

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

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

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

brand
ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

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

fee_type
ОПЦИОНАЛЬНО

Признак каким образом взимается комиссия:

  • ACT - по актам.

  • TRANSACTION - потранзакционно.

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

fee
ОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

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

currency
ОПЦИОНАЛЬНО

Валюта операции

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

hash
ОБЯЗАТЕЛЬНО

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

md5(
  strtoupper(
    strrev(email).
    client_pass.
    trans_id.
    strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)

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

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

 Response при неуспешном списании
{
  "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
ОБЯЗАТЕЛЬНО

SALE

result
ОБЯЗАТЕЛЬНО

DECLINED

status
ОБЯЗАТЕЛЬНО

DECLINED

order_id
ОБЯЗАТЕЛЬНО

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

trans_id
ОБЯЗАТЕЛЬНО

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

amount
ОПЦИОНАЛЬНО

Сумма транзакции

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

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
ОПЦИОНАЛЬНО

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

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

MID
ОПЦИОНАЛЬНО

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

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

card
ОПЦИОНАЛЬНО

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

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

card_hash
ОПЦИОНАЛЬНО

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

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

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

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

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

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

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

brand
ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

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

fee_type
ОПЦИОНАЛЬНО

Признак каким образом взимается комиссия:

  • ACT - по актам.

  • TRANSACTION - потранзакционно.

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

fee
ОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

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

currency
ОПЦИОНАЛЬНО

Валюта операции

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

trans_date
ОБЯЗАТЕЛЬНО

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

decline_reason
ОБЯЗАТЕЛЬНО

Причина, по которой транзакция была отклонена

 Callback при неуспешном списании
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
ОБЯЗАТЕЛЬНО

SALE

result
ОБЯЗАТЕЛЬНО

DECLINED

status
ОБЯЗАТЕЛЬНО

DECLINED

order_id
ОБЯЗАТЕЛЬНО

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

trans_id
ОБЯЗАТЕЛЬНО

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

trans_date
ОБЯЗАТЕЛЬНО

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

amount
ОПЦИОНАЛЬНО

Сумма транзакции

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

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
ОПЦИОНАЛЬНО

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

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

MID
ОПЦИОНАЛЬНО

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

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

card
ОПЦИОНАЛЬНО

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

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

card_hash
ОПЦИОНАЛЬНО

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

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

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

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

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

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

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

brand
ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

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

fee_type
ОПЦИОНАЛЬНО

Признак каким образом взимается комиссия:

  • ACT - по актам.

  • TRANSACTION - потранзакционно.

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

fee
ОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

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

currency
ОПЦИОНАЛЬНО

Валюта операции

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

decline_reason
ОБЯЗАТЕЛЬНО

Причина, по которой транзакция была отклонена

hash
ОБЯЗАТЕЛЬНО

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

md5(
  strtoupper(
    strrev(email).
    client_pass.
    trans_id.
    strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)

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

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

Промежуточный ответ (асинхронный режим)

 Response о принятии запроса в обработку
{
  "action": "SALE",
  "result": "ACCEPTED",
  "trans_id": "03346-89211-86461",
  "order_id": "ORDER-12345",
  "trans_date": "2012-04-03 16:02:01"
}

Параметры

Описание

action
ОБЯЗАТЕЛЬНО

SALE

result
ОБЯЗАТЕЛЬНО

ACCEPTED

order_id
ОБЯЗАТЕЛЬНО

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

trans_id
ОБЯЗАТЕЛЬНО

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

trans_date
ОБЯЗАТЕЛЬНО

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

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

 Callback при успешном списании
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
ОБЯЗАТЕЛЬНО

SALE

result
ОБЯЗАТЕЛЬНО

SUCCESS

status
ОБЯЗАТЕЛЬНО

SETTLED

PENDING только когда было указано auth = Y

order_id
ОБЯЗАТЕЛЬНО

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

trans_id
ОБЯЗАТЕЛЬНО

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

trans_date
ОБЯЗАТЕЛЬНО

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

descriptor
ОБЯЗАТЕЛЬНО

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

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

auth_code
ОБЯЗАТЕЛЬНО

Код авторизации от банка

amount
ОПЦИОНАЛЬНО

Сумма транзакции

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

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
ОПЦИОНАЛЬНО

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

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

MID
ОПЦИОНАЛЬНО

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

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

card
ОПЦИОНАЛЬНО

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

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

card_hash
ОПЦИОНАЛЬНО

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

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

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

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

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

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

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

brand
ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

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

fee_type
ОПЦИОНАЛЬНО

Признак каким образом взимается комиссия:

  • ACT - по актам.

  • TRANSACTION - потранзакционно.

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

fee
ОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

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

currency
ОПЦИОНАЛЬНО

Валюта операции

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

hash
ОБЯЗАТЕЛЬНО

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

md5(
  strtoupper(
    strrev(email).
    client_pass.
    trans_id.
    strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)

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

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

 Callback при неуспешном списании
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
ОБЯЗАТЕЛЬНО

SALE

result
ОБЯЗАТЕЛЬНО

DECLINED

status
ОБЯЗАТЕЛЬНО

DECLINED

order_id
ОБЯЗАТЕЛЬНО

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

trans_id
ОБЯЗАТЕЛЬНО

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

trans_date
ОБЯЗАТЕЛЬНО

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

amount
ОПЦИОНАЛЬНО

Сумма транзакции

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

ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9, ext10
ОПЦИОНАЛЬНО

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

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

MID
ОПЦИОНАЛЬНО

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

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

card
ОПЦИОНАЛЬНО

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

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

card_hash
ОПЦИОНАЛЬНО

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

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

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

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

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

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

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

brand
ОПЦИОНАЛЬНО

'brand' => 'VISA'

'brand' => 'MASTER'

'brand" => 'PROSTIR'

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

fee_type
ОПЦИОНАЛЬНО

Признак каким образом взимается комиссия:

  • ACT - по актам.

  • TRANSACTION - потранзакционно.

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

fee
ОПЦИОНАЛЬНО

Сумма комиссии с мерчанта по транзакции в ГРН

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

currency
ОПЦИОНАЛЬНО

Валюта операции

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

decline_reason
ОБЯЗАТЕЛЬНО

Причина, по которой транзакция была отклонена

hash
ОБЯЗАТЕЛЬНО

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

md5(
  strtoupper(
    strrev(email).
    client_pass.
    trans_id.
    strrev(
      substr(card,0,6).
      substr(card,-4)
    )
  )
)

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

При ошибке в запросе (асинхронный режим):

 Response в случая ошибки в запросе
{
  "result": "ERROR",
  "error_message": "Error description"
}
  • No labels