3.1. Основные операции

operation

Тип операции

• Purchase

merchant_id

Идентификатор торговца

amount

Сумма операции

Пример 500.00

signature

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца.

Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, currency_iso, description разделенных “;” (точка с запятой) в кодировке UTF-8.

Порядок параметров при конкатенации важен!

order_id

Уникальный номер операции на стороне торговца. Если операция дублируется - торговец получает ошибку.

currency_iso

Валюта платежа.

UAH

description

Назначение платежа. Выводится на платежной странице, при вводе платежных реквизитов. Отображается в выписке по счету и реестрах

add_params

Массив с дополнительными параметрами. Дополнительные параметры потом возвращаются мерчанту в CALLBACK вызове

approve_url

URL для переадресации в случае, если платеж успешен

decline_url

URL для переадресации в случае, если платеж не успешен

cancel_url

URL для переадресации в случае, если пользователь отказался совершить оплату

callback_url

URL на который придёт информация о результате выполнения платежа

phone

Номер телефона клиента

Не обязательный

redirect

true / false - по умолчанию true, если параметр стоит true, тогда клиент не будет получать переадресацию, а получит URL платежной страницы

Не обязательный

auth_type

Тип авторизации

Не обязательный
1 – Покупка (PURCHASE),
2 – Предавторизация (HOLD)
По умолчанию – 1

operation

Тип операции

• Complete

merchant_id

Идентификатор торговца

order_id

Это уникальный номер операции которая была отправлена в запросе PURCHASE

amount

Сумма списания

Пример 500.00

signature

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца.

Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id , amount разделенных “;” (точка с запятой) в кодировке UTF-8.

Порядок параметров при конкатенации важен!

code

Код ответа. (Список кодов ответа см. ниже)

message

Текстовое сообщение с результатом запроса

signature

operation

Тип операции

Verify

merchant_id

Идентификатор торговца

order_id

Это уникальный номер операции. Генерируется на стороне мерчанта. Он должен быть уникальным на протяжении всей работы.

approve_url

URL на который будет перенаправлен пользователь в случае успешной операции

decline_url

URL на который будет перенаправлен пользователь в случае не успешной операции

cancel_url

URL на который будет перенаправлен пользователь в случае отмены операции

signature

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца.

Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, recurring_token, currency_iso, description разделенных “;” (точка с запятой) в кодировке UTF-8.

Порядок параметров при конкатенации важен!

operation

Тип операции

Reverse

merchant_id

Идентификатор торговца

order_id

Это уникальный номер операции по которой необходимо выполнить реверс.

Примечание: реверс операции P2PCREDIT запрещен

amount

Сумма операции
Если сумма операции опущена то возвращается полная сумма операции

Пример 500.00

signature

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца.

Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id разделенных “;” (точка с запятой) в кодировке UTF-8.

Порядок параметров при конкатенации важен!

code

Код ответа. (Список кодов ответа см. ниже)

message

Текстовое сообщение с результатом запроса

signature

operation

Тип операции

Refund

merchant_id

Идентификатор торговца

order_id

Это уникальный номер операции которая была отправлена в запросе P2PCREDIT, P2PDEBIT или VERIFY

amount

Сумма операции
Если сумма операции опущена то возвращается полная сумма операции

Пример 500.00

signature

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца.

Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id разделенных “;” (точка с запятой) в кодировке UTF-8.

Порядок параметров при конкатенации важен!

code

Код ответа. (Список кодов ответа см. ниже)

message

Текстовое сообщение с результатом запроса

signature