3.4. Дополнительные операции
На этой странице приведено описание дополнительных cистемы диспетчеризации Procard.Pay
К дополнительным операциям относятся:
PaymentSplit – расщепление платежа на нескольких получателей
RecPayment – регулярное списание средств с карты – рекуррентный платеж
Check – проверка состояния операций Purchase / Hold / Complete
Операция PaymentSplit – оплата на платежной странице процессинга с расщеплением платежа
Test url https://pay-test.procard-ltd.com/api (production url клиент получает в проектном журнале)
Для оплаты на платежной странице процессинга с расщеплением платежа необходимо выполнить редирект на страницу процессингового центра, с 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 вызове |
|
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 (оплата по токену)
Test url https://pay-test.procard-ltd.com/api (production url клиент получает в проектном журнале)
Для совершения рекуррентного платежа необходимо отправить 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 |
|
Пример:
Запрос
{"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"}
Ответ
{"status": "3ds",
"code": 0,
"d3_acs_url": "http://acs.url",
"d3_md": "*****************",
"d3_pareq": "***********"}
Операция Check
Test url https://pay-test.procard-ltd.com/api/check (production url клиент получает в проектном журнале)
Для проверки статуса операции необходимо отправить 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 |
|
|
Copyright © 2015-2021 PROCARD