| Tip |
|---|
На этой странице приведено описание основных операций cистемы диспетчеризации Procard.Pay |
К основным операциям относятся:
PURCHASE – операция покупки с использованием карты
HOLD – блокировка средств на карте клиента в рамках двух-стадийной оплаты
COMPLETE – списание средств с карты клиента в рамках двух-стадийной оплаты
VERIFY - операция проверки карты
REVERSE – возврат / частичный возврат средств он-лайн
REFUND – возврат / частичный возврат средств офф-лайн
Операция PURCHASE / HOLD на платежной странице процессинга
Production URL: https://pay.procard.ua/api/
Для осуществления операции на платежной странице процессинга торговцу необходимо выполнить переход на страницу процессингового центра с POST данными:
На этой странице:
| Table of Contents |
|---|
Параметр | Описание | Значение |
|---|---|---|
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 | Тип авторизации | Не обязательный |
Операция COMPLETE
Production URL: https://pay.procard.ua/api
Для завершения операции предавторизации (HOLD) необходимо отправить POST запрос со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
operation | Тип операции | COMPLETE |
merchant_id | Идентификатор торговца |
|
order_id | Это уникальный номер операции которая была отправлена в запросе PURCHASE |
|
amount | Сумма списания | Пример 500.00 |
signature | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца. |
|
Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id , amount разделенных “;” (точка с запятой) в кодировке UTF-8. | ||
Порядок параметров при конкатенации важен! |
В ответ возвращается JSON со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
code | Код ответа. (Список кодов ответа см. ниже) |
|
message | Текстовое сообщение с результатом запроса |
|
signature |
Операция VERIFY
Production URL: https://pay.procard.ua/api/
Для проверки карты необходимо отправить / переадресовать пользователя на страницу платежного шлюза методом POST со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
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. | ||
Порядок параметров при конкатенации важен! |
Операция REVERSE
Production URL: https://pay.procard.ua/api/reverse
Для осуществления возврата средств необходимо отправить POST запрос со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
operation | Тип операции | REVERSE |
merchant_id | Идентификатор торговца |
|
order_id | Это уникальный номер операции которая была отправлена в запросе P2PCREDIT, P2PDEBIT или VERIFY |
|
amount | Сумма операции | Пример 500.00 |
signature | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца. |
|
Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id разделенных “;” (точка с запятой) в кодировке UTF-8. |
| |
Порядок параметров при конкатенации важен! |
В ответ возвращается JSON со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
code | Код ответа. (Список кодов ответа см. ниже) |
|
message | Текстовое сообщение с результатом запроса |
|
signature |
Операция REFUND (офф-лайн операция!)
Production URL: https://pay.procard.ua/api/refund
Для осуществления возврата средств необходимо отправить POST запрос со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
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. |
| |
Порядок параметров при конкатенации важен! |
В ответ возвращается JSON со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
code | Код ответа. (Список кодов ответа см. ниже) |
|
message | Текстовое сообщение с результатом запроса |
|
signature |
| Filter by label (Content by label) | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|