API поповнення моб. операторів

Запит P2_PHONE дозволяє здійснювати поповнення номерів українських мобільних операторів.

Результатом обробки запиту є зарахування коштів на баланс номера мобільного оператора.

Параметри запиту

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

З метою підтвердження валідності даних повинно бути згенеровано і передано в запиті HMAC_MD5 контрольний підпис з використанням SecretKey торговця.

Рядок, що підлягає HMAC_MD5, генерується шляхом конкатенації парамаетров merchantAccount, orderReference, amount, currency, phone розділених ";" (крапка з комою) в кодуванні UTF-8

Параметр

Опис

Обов'язкове

 

transactionType

P2_PHONE

так

merchantAuthType

Тип авторизації. Може приймати одне з наступних значень

- SimpleSignature (за замовчуванням)

ні

merchantSignature

Підпис запиту

так

merchantAccount

Ідентифікатор продавця. Дане значення присвоюється Вам з боку WayForPay

так

orderReference

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

так

orderDate

Дата розміщення замовлення

так

currency

Валюта поповнення

так

amount

Сума замовлення

так

phone

Номер телефону для поповнення

так

apiVersion

Версія протоколу. Значення за замовчуванням: 1

так

serviceUrl

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

ні

Параметри відповіді

З метою підтвердження валідності даних повинно бути згенеровано і передано в запиті HMAC_MD5 контрольний підпис з використанням SecretKey торговця.
Рядок, що підлягає HMAC_MD5, генерується шляхом конкатенації параметрів merchantAccount, orderReference, amount, currency, phone, transactionStatus, reasonCode розділених ";" (крапка з комою) в кодуванні UTF-8

Параметр

Опис

Приклад

merchantAccount

Ідентифікатор продавця

test_merchant

orderReference

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

1212dd1

merchantSignature

hash_hmac

 

amount

Сума замовлення

100

currency

Валюта поповнення

 

phone

Номер телефону який поповнюється

380633333333

createdDate

Дата створення запиту в psp (UTC)

123456789

processingDate

Дата процесування транзакції (UTC)

12345678

transactionStatus

Статус транзакції

Approved

reason

Причина відмови

Ok

reasonCode

Код відмови

1100

paymentSystem

Платіжна система, через яку був здійснений платіж.

card

Приклад запиту і відповіді

{
"transactionType":"P2_PHONE",
"merchantAccount":"test_merch_n1",
"merchantAuthType":"SimpleSignature",
"merchantSignature":"60c5d743b71f79abe48c7183ada4b451",
"apiVersion":1,
"orderReference":"myOrder1",
"amount":10,
"currency":"UAH",
"phone":"380633333333"
}

 

Приклад запиту на serviceUrl

{
"merchantAccount":"test_merch_n1",
"orderReference":"DH783023",
"merchantSignature":"",
"amount":10,
"currency":"UAH",
"createdDate":12345678,
"processingDate":12345678,
"transactionStatus":"Approved",
"reason":1100,
"reasonCode":""
}

Приклад коректної відповіді від мерчанта

Система WayForPay очікує отримати від сервера торгівця таку відповідь:

{
"orderReference":"DH783023",
"status":"accept",
"time":1415379863,
"signature":""
}

 

З метою підтвердження валідності даних повинно бути згенеровано і передано в запиті HMAC_MD5 контрольний підпис з використанням SecretKey торговця.

Рядок, що підлягає HMAC_MD5, генерується шляхом конкатенації параметрів orderReference, status, time розділених ";" (крапка з комою) в кодуванні UTF-8

Повідомлення мерчанта про статус транзакції
Для авторизованих і перевірених замовлень (а також при зміні статусу замовлення) серевер WayForPay направляє на serviceUrl запит (HTTP_POST) включає в себе дані замовлення. Дана інформація доповнюється контрольної підписом HMAC_MD5.

У разі, якщо WayForPay НЕ отримає коректну відповідь від сервера торговця, то система буде направляти запити на протязі 4-х діб або до отримання правильної відповіді.