3.5. Операции P2P-переводов

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

К операциям P2P-переводов относятся:

  • P2PCREDIT – прямое зачисление средств на карту

  • P2PDEBIT – прямое списание средств с карты

  • GETBALANCE - получение сведений о балансе подлимитных операций

Операция P2PCREDIT

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

Для пополнения карты необходимо отправить POST запрос со следующими параметрами:


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

Параметр

Описание

Значения

Параметр

Описание

Значения

operation

Тип операции

P2PCREDIT

merchant_id

Идентификатор торговца

 

order_id

Это уникальный номер операции. Генерируется на стороне мерчанта. Он должен быть уникальным на протяжении всей работы.

 

amount

Сумма операции, должна быть дробным числом, c двумя знаками после запятой.

Пример: 100.50

card_number

Номер карты получателя.

 

token

Токен, можно использовать вместо карты получателя

 

currency_iso

Валюта операции. На данный момент доступна только “UAH”

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 [SenderName]

Полное наименование плательщика

 

add_params [ResidentCountry]

Место нахождения плательщика

 

add_params [SenderPostalCode]

Место нахождения плательщика

 

add_params [ResidentCityInLatin]

Место нахождения плательщика

 

add_params [Address]

Место нахождения плательщика

 

add_params [identityNumber]

ЕГРПОУ плательщика

 

add_params [RecipientAccount]

Уникальный номер электронного кошелька / счета получателя

 

add_params [RecipientName]

ФИО получателя

 

add_params [RecipientName]

Полное наименование получателя

 

add_params [PayerAccount]

Уникальный номер электронного платежного средства плательщика

 

add_params [Descript]

Назначение платежа

 

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

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

Для списания средств с карты необходимо переадресовать пользователя на страницу платежного шлюза методом 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 [SenderName]

Полное наименование плательщика

 

add_params [ResidentCountry]

Место нахождения плательщика

 

add_params [SenderPostalCode]

Место нахождения плательщика

 

add_params [ResidentCityInLatin]

Место нахождения плательщика

 

add_params [Address]

Место нахождения плательщика

 

add_params [identityNumber]

ЕГРПОУ плательщика

 

add_params [RecipientAccount]

Уникальный номер электронного кошелька / счета получателя

 

add_params [RecipientName]

ФИО получателя

 

add_params [RecipientName]

Полное наименование получателя

 

add_params [PayerAccount]

Уникальный номер электронного платежного средства плательщика

 

signature

В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе SHA-512 контрольная подпись с использованием private_key торговца.

 

 

Строка, подлежащая SHA-512, генерируется путем конкатенации параметров merchant_id, order_id, amount, currency_iso, description, approve_url, decline_url, cancel_url разделенных “;” (точка с запятой) в кодировке UTF-8.

 

 

Порядок параметров при конкатенации важен!

 

Операция получения баланса GETBALANCE

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

Для получения сведений о балансе необходимо отправить 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