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

На этой странице приведено описание основных операций cистемы диспетчеризации Procard.Pay

К основным операциям относятся:

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

  • HOLD – блокировка средств на карте клиента в рамках двух-стадийной оплаты

  • COMPLETE – списание средств с карты клиента в рамках двух-стадийной оплаты

  • VERIFY - операция проверки карты

  • REVERSE – возврат / частичный возврат средств он-лайн

  • REFUND – возврат / частичный возврат средств офф-лайн

Операция PURCHASE / HOLD на платежной странице процессинга

Production URL: https://pay.procard.ua/api/

Для осуществления операции на платежной странице процессинга торговцу необходимо выполнить переход на страницу процессингового центра с POST данными:


На этой странице:

Параметр

Описание

Значение

Параметр

Описание

Значение

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

Операция 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 запрещен

 

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