3.4. Дополнительные операции

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

К дополнительным операциям относятся:

  • PAYMENTSPLIT – расщепление платежа на нескольких получателей

  • RECPAYMENT – регулярное списание средств с карты – рекуррентный платеж

  • CHECK – проверка состояния операций PURCHASE / HOLD / COMPLETE

Операция PAYMENTSPLIT – оплата на платежной странице процессинга с расщеплением платежа

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 вызове

 

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),
2 – Предавторизация (HOLD)
По умолчанию – 1

secure_type

Идентификатор проверки 3DS

1 – операция без 3DS,
2 – операция с 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

 

Пример:

  • Запрос

1 2 3 4 5 6 7 8 9 10 11 {"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"}
  • Ответ

1 2 3 4 5 {"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