| Tip |
|---|
На этой странице приведено описание дополнительных cистемы диспетчеризации Procard.Pay |
К дополнительным операциям относятся:
PAYMENTSPLIT – расщепление платежа на нескольких получателей
RECPAYMENT – регулярное списание средств с карты – рекуррентный платеж
CHECK – проверка состояния операций PURCHASE / HOLD / COMPLETE
Операция PAYMENTSPLIT – оплата на платежной странице процессинга с расщеплением платежа
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 вызове | |
split | Признак расщепления платежа | 0 - не расщеплять |
1 - расщеплять | ||
split_rules | Массив с правилами расщепления который содержит в себе идентификаторы субмерчанта и суммы. | |
Сумма расщеплений должна совпадать с суммой платежа. | ||
Пример: | ||
split_rules[0][sub_merchant_id]=test1&split_rules[0][amount]=100.00&split_rules[1][sub_merchant_id]=test2&split_rules[1][amount]=50.00&.......&split_rules[n][sub_merchant_id]=testn&split_rules[n][amount]=10.00 | ||
approve_url | URL для переадресации в случае, если платеж успешен | |
decline_url | URL для переадресации в случае, если платеж не успешен | |
cancel_url | URL для переадресации в случае, если пользователь отказался совершить оплату | |
callback_url | URL на который придёт информация о результате выполнения платежа |
Рекуррентные платежи RECPAYMENT (оплата по токену)
Production url: https://pay.procard.ua/api/
Для совершения рекуррентного платежа необходимо отправить POST запрос со следующими параметрами:
Параметр | Описание | Значения |
operation | Тип операции | RECPAYMENT |
merchant_id | Идентификатор торговца |
|
amount | Сумма операции. | Пример 500.00 |
recurring_token | Токен полученный от ПС |
|
order_id | Уникальный номер заказа в системе торговца |
|
description | Назначение платежа |
|
currency_iso | Валюта. На данный момент только UAH |
|
auth_type | Тип авторизации | 1 – Покупка (PURCHASE), |
secure_type | Идентификатор проверки 3DS | 1 – операция без 3DS, |
signature | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца. |
|
Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, recurring_token, currency_iso, description разделенных “;” (точка с запятой) в кодировке UTF-8. |
| |
Порядок параметров при конкатенации важен! |
|
В ответ возвращается JSON со следующими параметрами:
Название | Параметры |
status | APPROVED - успешно, |
DECLINED - операция не успешна | |
code | Код ответа (Список кодов ответа см. ниже) |
signature |
Пример:
Запрос
| Code Block | ||
|---|---|---|
| ||
{"operation": "RecPayment", "amount": "100.00", "order_id": "12345678", "signature": "", "add_params": {}, "description": "Описание", "merchant_id": "merchant_id", "currency_iso": "UAH", "recurring_token": "", "auth_type":"1", "secure_type":"2"} |
Ответ
| Code Block | ||
|---|---|---|
| ||
{"status": "3ds",
"code": 0,
"d3_acs_url": "http://acs.url",
"d3_md": "*****************",
"d3_pareq": "***********"} |
Операция CHECK
Production URL: https://pay.procard.ua/check
Для проверки статуса операции необходимо отправить POST запрос со следующими параметрами:
Параметр | Описание | Значения |
operation | Тип операции | CHECK |
merchant_id | Идентификатор торговца |
|
order_id | Это уникальный номер операции которая была отправлена в запросе P2PCREDIT,P2PDEBIT или VERIFY |
|
signature | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца. |
|
Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id разделенных “;” (точка с запятой) в кодировке UTF-8. | ||
Порядок параметров при конкатенации важен! |
В ответ возвращается JSON со следующими параметрами:
Параметр | Описание | Значения |
reasoneCode | Код ответа. (Список кодов ответа см. ниже) |
|
reason | Описание ответа |
|
merchant_id | Идентификатор торговца |
|
amount | Сумма |
|
phone | Номер телефона |
|
createdDate | дата платежа |
|
cardPan | Маскированный номер карты |
|
cardType | Тип карты |
|
transactionId | Идентификатор транзакции |
|
message | Текстовое сообщение с результатом запроса |
|
datetime | Дата создания операции на сервере |
|
fee | Комиссия платежа |
|
transactionStatus | Статус операции(Справочник см ниже) |
|
signature |
| Filter by label (Content by label) | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|