|
Рус
|
Технология приема оплат
|
<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-а полностью совпадает со структурой результата возвращаемого через автоматизированный интерфейс
|
||||||||||||||||||||
