|
Укр
|
Технологія прийому оплат
|
<FORM ACTION="https://www.portmone.com.ua/ Сторінка_виклику " method="POST"> <INPUT TYPE="HIDDEN" NAME="PAYEE_ID" VALUE="ВАШ_PAYEE_ID"> <INPUT TYPE="HIDDEN" NAME="SHOPORDERNUMBER" VALUE="TEST-123-456"> <INPUT TYPE="HIDDEN" NAME="BILL_AMOUNT" VALUE="50.35"> <INPUT TYPE="HIDDEN" NAME="EMAIL" VALUE="test@test.com"> <INPUT TYPE="HIDDEN" NAME="DESCRIPTION" VALUE="Оплата замовлення"> <INPUT TYPE="HIDDEN" NAME="SUCCESS_URL" VALUE="http://test.com.ua/Success.html"> <INPUT TYPE="HIDDEN" NAME="FAILURE_URL" VALUE="http://test.com.ua/Failure.html"> <INPUT TYPE="HIDDEN" NAME="LANG" VALUE="en"> <INPUT TYPE="submit" NAME="submit" VALUE="Оплатити"> </FORM"> |
Опис параметрів:
| Параметр | Опис |
|---|---|
| PAYEE_ID | Ідентифікатор магазина. Присвоюється Portmone.com кожному магазину індивідуально |
| SHOPORDERNUMBER | Номер сплачуваного замовлення (рахунку) в Інтернет-магазині |
| BILL_AMOUNT | Сума замовлення (оплати). Розмірність — гривня. Дробова частина відокремлена символом крапки «.» |
| DESCRIPTION | Коментар до замовлення / призначення оплати (н-р специфікація замовлення) |
| Email адреса клієнта. Не обов’язкові параметри. Може використовуватись для додаткової ідентифікації замовлення | |
| SUCCESS_URL | Адреса Інтернет-магазину, на який буде повернений клієнт після успішної авторизації карти. Під час виклику цієї адреси в якості параметра буде переданий методом POST параметр SHOPORDERNUMBER - номер оплачуваного замовлення |
| FAILURE_URL | Адреса Інтернет-магазину, на який буде повернений клієнт після виклику цієї адреси в якості параметра буде переданий методом POST параметр SHOPORDERNUMBER - номер оплачуваного замовлення неуспішної авторизації карти |
| LANG | Мова інтерфейсу. Підтримується: en - Англійська, ru - Російська, uk - Українська |
Підтвердження авторизації
Підтвердження транзакції, в залежності від рішення магазина і його технічних можливостей, забезпечується трьома способами:
- Online-запитом на сайті www.portmone.com у форматі XML (рекомендуеться)
- В вигляді виписки на сайті www.portmone.com
- В вигляді email повідомлення
Підтвердження транзакції online-запитом
Після проведення успішної авторизації клієнт переводиться на сайт Інтернет-магазину на адресу, яка була вказана магазином в запиті в параметрі SUCCESS_URL. Під час виклику цієї адреси як параметр буде переданий методом POST параметр SHOPORDERNUMBER — номер оплачуваного замовлення.
Для підтвердження авторизації платіжної карти магазину необхідно викликати на сайті Portmone.com посилання з вказівкою ряду параметрів. Приклад виклику:
|
https://www.portmone.com.ua/Сторінка_виклику?PAYEE_ID=ВАШ_PAYEE_ID&LOG=ВАШ_LOGIN& PASS=ВАШ_ПАРОЛЬ&STATUS=PAYED&SHOPORDERNUMBER=НОМЕР_ЗАМОВЛЕННЯ |
Опис параметрів:
| Параметр | Опис |
|---|---|
| PAYEE_ID | Ідентифікатор магазину. Привласнюється Portmone.com кожному магазину індивідуально |
| LOG | Логін для Інтернет-магазину. Привласнюється Portmone.com кожному магазину індивідуально |
| PASS | Пароль для Інтернет-магазину. Привласнюється Portmone.com кожному магазину індивідуально |
| STATUS | Статус замовлення. Може приймати значення PAYED — Сплачено, CREATED — Створено, REJECTED — Відмінено. |
| SHOPORDERNUMBER | Номер оплачуваного замовлення (рахунку) в Інтернет-магазині |
Запит поверне XML структуру з реквізитами даної транзакції
|
<?xml version="1.0" encoding="windows-1251" standalone="yes"?> <portmoneresult count="Кількість об’єктів"> <request> <shopordernumber>Параметр, що приймається SHOPORDERNUMBER</shopordernumber> <payee_id> Параметр, що приймається PAYEE_ID</payee_id> <status> Параметр, що приймається STATUS</status> </request> <orders> <order> <shopordernumber>Номер замовлення</shopordernumber> <pay_date>Дата замовлення</pay_date> <description>Коментарі</description> <bill_amount>Сума</bill_amount> <error_code>Код помилки</error_code> <error_message>Розшифровка коду помилки</error_ message> <status>Статус</status> <pay_order_number>Номер платіжного доручення</pay_order_number> <pay_order_date>Дата платіжного доручення</pay_order_date> </order> </orders> </portmoneresult> |
Опис параметрів:
| Параметр | Опис |
|---|---|
| SHOPORDERNUMBER | Номер оплачуваного замовлення (рахунку) в Інтернет-магазині |
| PAY_DATE | Дата оплати замовлення |
| BILL_AMOUNT | Сума замовлення (оплати). Розмірність - гривня. Дробова частина відокремлена символом крапки "." |
| DESCRIPTION | Коментар до замовлення / призначення оплати (н-р специфікація замовлення) |
| ERROR_CODE | Код помилки. У випадку успішної оплати повертається '000', в випадку неуспішної - код помилки авторизації картки |
| ERROR_MESSAGE | Розшифровка коду помилки |
| STATUS | Статус замовлення. Може приймати значення PAYED - Сплачено, CREATED - створено, REJECTED - відмінено. |
| PAY_ORDER_NUMBER | Номер платіжного доручення, яким банк перераховує гроші в Інтернет-магазин. Параметр не обов'язковий. Заповнюється тільки після того, як банк у встановлені терміни перераховує платіж. Використовується для автоматичної прив'язки грошей до замовлень. |
| PAY_ORDER_DATE | Дата платіжного доручення, яким банк перераховує гроші в Інтернет-магазин. Параметр не обов'язковий. Заповнюється тільки після того, як банк у встановлені терміни перераховує платіж. Використовується для автоматичної прив'язки грошей до замовлень. |
Отриману структуру XML необхідно обробити — перевірити, щоб статус замовлення був дійсно сплачений, що сума авторизації дійсно відповідає сумі замовлення.
Отримання виписок на сайті
Для отримання виписки на сайті платіжного шлюзу необхідно зайти по адресу Вхід для Інтернет-магазину
Отримання виписок з результатами авторизації по e-mail
Виписки розсилаються магазинам відразу ж після успішної авторизації карти. Виписки розсилаються двома email-ами, один в форматі XML (для автоматичної обробки), а інший в текстовому вигляді для повідомлення.
Формат XML-email-а повністю співпадає з структурою результату, який повертається через автоматизований інтерфейс
|
||||||||||||||||||||
