3.5. Операции P2P-переводов
На этой странице приведено описание операций P2P-переводов cистемы диспетчеризации Procard.Pay
К операциям P2P-переводов относятся:
P2PCredit – прямое зачисление средств на карту
P2PDebit – прямое списание средств с карты
GetBalance - получение сведений о балансе подлимитных операций
Операция P2PCredit
Test url https://pay-test.procard-ltd.com/api (production url клиент получает в проектном журнале)
Для пополнения карты необходимо отправить POST запрос со следующими параметрами:
На этой странице:
Параметр | Описание | Значения |
|---|---|---|
operation | Тип операции | P2PCredit |
merchant_id | Идентификатор торговца |
|
order_id | Это уникальный номер операции. Генерируется на стороне мерчанта. Он должен быть уникальным на протяжении всей работы. |
|
amount | Сумма операции, должна быть дробным числом, c двумя знаками после запятой. | Пример: 100.50 |
card_number | Номер карты получателя. |
|
token | Токен, можно использовать вместо карты получателя |
|
currency_iso | Валюта операции. | Пример: UAH |
add_params [SenderAccount] | Уникальный номер электронного кошелька / счета плательщика |
|
add_params [SenderName] | Данные, позволяющие определить лицо, которое заключило договор с получателем о поставке товаров, выполнение работ, оказание услуг, предоставление кредита ФИО плательщика |
|
add_params [ResidentCountry] | Место жительства плательщика |
|
add_params [SenderPostalCode] | Место жительства плательщика |
|
add_params [ResidentCityInLatin] | Место жительства плательщика |
|
add_params [Address] | Место жительства плательщика |
|
add_params [passportNumber] | Номер паспорта плательщика |
|
add_params [identityNumber] | ИНН плательщика / ЕГРПОУ плательщика |
|
add_params [SenderBirthday] | Дата рождения плательщика |
|
add_params [SenderBirth\_locality] | Место рождения плательщика |
|
add_params [ResidentCountry] | Место нахождения плательщика |
|
add_params [SenderPostalCode] | Почтовый индекс отправителя |
|
add_params [ResidentCityInLatin] | Город отправителя латиницей |
|
add_params [Address] | Адресс отправителя |
|
add_params [RecipientAccount] | Уникальный номер электронного кошелька / счета получателя |
|
add_params [RecipientName] | ФИО получателя |
|
add_params [Descript] | Назначение платежа |
|
add_params [PayerAccount] | Уникальный номер электронного платежного средства плательщика |
|
add_params [VisaPurchaseIdentifier] | Идентификатор Visa Request to Pay |
|
signature | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием Private_key торговца. |
|
| Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, card_number, currency_iso разделенных “;” (точка с запятой) в кодировке UTF-8. |
|
| Порядок параметров при конкатенации важен! |
|
В ответ возвращается JSON со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
code | Код ответа. (Список кодов ответа см. ниже) |
|
message | Текстовое сообщение с результатом запроса |
|
status | Статусы операции |
|
| APPROVED - перевод успешен |
|
| DECLINED - Перевод не успешен |
|
| ON-PAYMENT - Заявка на перевод в обработке, необходимо дополнительно запросить статус |
|
transactionID | Идентификатор транзакции в платежной системе |
|
approvalCode | Код авторизации |
|
signature |
|
|
Операция P2PDebit
Test url https://pay-test.procard-ltd.com/api (production url клиент получает в проектном журнале)
Для списания средств с карты необходимо переадресовать пользователя на страницу платежного шлюза методом POST со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
operation | Тип операции | P2PDebit |
merchant_id | Идентификатор торговца |
|
order_id | Это уникальный номер операции. Генерируется на стороне мерчанта. Он должен быть уникальным на протяжении всей работы. |
|
amount | Сумма операции, должна быть дробным числом, c двумя знаками после запятой. | Пример: 100.50 |
currency_iso | Валюта операции. На данный момент доступна только “UAH” |
|
description | Назначение платежа |
|
approve_url | URL на который будет перенаправлен пользователь в случае успешной операции |
|
decline_url | URL на который будет перенаправлен пользователь в случае не успешной операции |
|
cancel_url | URL на который будет перенаправлен пользователь в случае отмены операции |
|
add_params [SenderAccount] | Уникальный номер электронного кошелька / счета плательщика |
|
add_params [SenderName] | Данные, позволяющие определить лицо, которое заключило договор с получателем о поставке товаров, выполнение работ, оказание услуг, предоставление кредита ФИО плательщика |
|
add_params [ResidentCountry] | Место жительства плательщика |
|
add_params [SenderPostalCode] | Место жительства плательщика |
|
add_params [ResidentCityInLatin] | Место жительства плательщика |
|
add_params [Address] | Место жительства плательщика |
|
add_params [passportNumber] | Номер паспорта плательщика |
|
add_params [identityNumber] | ИНН плательщика / ЕГРПОУ плательщика |
|
add_params [SenderBirthday] | Дата рождения плательщика |
|
add_params [SenderBirth\_locality] | Место рождения плательщика |
|
add_params [ResidentCountry] | Место нахождения плательщика |
|
add_params [SenderPostalCode] | Почтовый индекс отправителя |
|
add_params [ResidentCityInLatin] | Город отправителя латиницей |
|
add_params [Address] | Адресс отправителя |
|
add_params [RecipientAccount] | Уникальный номер электронного кошелька / счета получателя |
|
add_params [RecipientName] | ФИО получателя |
|
add_params [Descript] | Назначение платежа |
|
add_params [PayerAccount] | Уникальный номер электронного платежного средства плательщика |
|
add_params [SenderAccount] | Уникальный номер электронного кошелька / счета плательщика |
|
signature | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца. |
|
| Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, currency_iso, description, approve_url, decline_url, cancel_url разделенных “;” (точка с запятой) в кодировке UTF-8. |
|
| Порядок параметров при конкатенации важен! |
|
Операция получения баланса GetBalance
Test url https://pay-test.procard-ltd.com/api (production url клиент получает в проектном журнале)
Для получения сведений о балансе необходимо отправить POST запрос со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
operation | Тип операции | GetBalance |
merchant_id | Идентификатор торговца |
|
date | Дата и время запроса в произвольном формате |
|
signature | В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца. |
|
| Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, data разделенных “;” (точка с запятой) в кодировке UTF-8. |
|
| Порядок параметров при конкатенации важен! |
|
В ответ возвращается JSON со следующими параметрами:
Параметр | Описание | Значения |
|---|---|---|
mk_deposit | Лимит Mastercard |
|
visa_deposit | Лимит Visa |
|
mk_available | Доступный остаток Mastercard |
|
visa_available | Доступный остаток Visa |
|
signature |
|
|
Copyright © 2015-2021 PROCARD