Перейти к концу метаданных
Переход к началу метаданных

 

Данное API позволяет производить пополнения карт физических лиц с банковского счета ТСП. Пополнение возможно любых карт, выпущенных Украинскими Банками.

В системе предусмотрено  два варианта обработки пополнений:

  • пополнение по номеру карты

  • пополнение с использованием токена

Пополнение по номеру карты  выполняется в одно действие. В запросе ТСП может передать номер карты, либо ранее полученный токен. Если переданы оба параметра, возникнет ошибка обработки запроса.

Регламент зачисления средств на карту - мгновенно, возможны случаи когда средства поступают в течение суток - это зависит от внутреннего  регламента зачисления средств Банка эмитента, выпустившего данную карту.

Для проверки валидность карты и ее состояния, рекомендуется использовать тип запроса Verify.


Параметры запроса

Запрос c необходимыми параметрами формируется на стороне торговца и передается методом POST по протоколу HTTP на URL https://api.wayforpay.com/api

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

Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров merchantAccount, orderReference, amount, currency, cardBeneficiary, rec2Token разделенных “;” (точка с запятой) в кодировке UTF-8

 

Параметр

Описание

Обязательное

transactionType

Тип запроса, принимает значение P2P_CREDIT

да

merchantAccount

Уникальный идентификатор продавца.

да

merchantAuthType

Тип авторизации: simpleSignature (по умолчанию)

нет

orderReference

Уникальный номер заказа в системе торговца

да

amount

Сумма перевода

да

currency

Валюта перевода: UAH

да

cardBeneficiary

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

да

rec2Token

Токен карты получателя

да

merchantSignature

Подпись заказа

да

apiVersion

Версия протокола.Значение по-умолчанию: 1

да

serviceUrl

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

нет

recipientFirstName

Имя получателя

нет

recipientLastName

Фамилия получателя

нет

recipientPhone

Телефон получателя

нет

recipientEmail

E-mail Получателя

нет

 

Параметры ответа

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

Строка, подлежащая HMAC_MD5, генерируется путем конкатенации параметров merchantAccount, orderReference, amount, currency, authCode, transactionStatus, reasonCode разделенных “;” (точка с запятой) в кодировке UTF-8

 

 

Параметр

Описание

Пример

merchantAccount

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

test_merchant

orderReference

Уникальный номер заказа в системе торговца

1212dd1

merchantSignature

hash_hmac

 

amount

Сумма заказа

100

currency

Валюта заказа

UAH

authCode

код авторизации - присваивается банком

324567

cardPan

маскированный номер карты

42****4242

cardType

типа карты: Visa/MasterCard

Visa

issuerBankName

Имя Банка карты

PrivatBank

createdDate

дата создания запроса в psp (UTC)

123456789

processingDate

дата процессирования транзакции (UTC)

12345678

transactionStatus

статус транзакции

Approved

reason

Причина отказа

Ok

reasonCode

Код отказа

1100

 

Пример запроса и ответа

Запрос:
Ответ:

 

  • Нет меток