API документация


Готовые модули для приема платежей.

Управление кошельком





Прием платежей





Перевод платежа



Запросы необходимо отправлять методом POST на url https://www.ooopay.org/cashin_v1.php

m ID магазина
order_id Номер заказа магазина
должен быть уникальным
amount Сумма перевода
to Номер счета получателя (WM1234xxxx)
description Описание платежа
currency RUR или USD
wmid Если производятся операции с участием Webmoney, передача WMID клиента обязательна
action send_money
sign Подпись, формируется из параметров m.order_id.amount.to.description.secret и шифруется md5
пример на php: md5($m.$order_id.$amount.$to.$description.$secret);
Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc></desc>
  <answer>
    <payment_id>1</payment_id>
    <order_id>15</order_id>
    <amount>13.23</amount>
  </answer>
</document>



Выставление счета



Запросы необходимо отправлять методом POST на url https://www.ooopay.org/cashin_v1.php

m ID магазина
order_id Номер заказа магазина
должен быть уникальным
amount Сумма перевода
to Номер счета получателя (WM1234xxxx) или телефон или email
description Описание платежа
currency RUR,USD,EUR
action new_bill
sign Подпись, формируется из параметров m.order_id.to.amount.currency.secret и шифруется md5
пример на php: md5($m.$order_id.$to.$amount.$currency.$secret);
Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc></desc>
  <answer>
    <bill_id>123</bill_id>
  </answer>
</document>



Вывод средств



Запросы необходимо отправлять методом POST на url https://www.ooopay.org/cashin_v1.php

m ID магазина
order_id Номер заказа магазина
должен быть уникальным
amount Сумма перевода
cur_id id валюты *
to Номер счета/кошелек получателя
description Описание платежа
currency RUR,USD,EUR (Валюта кошелька, с которого
будет произведена оплата)
action cash_out
sign Подпись, формируется из параметров m.order_id.amount.cur_id.to.description.secret и шифруется md5
пример на php: md5($m.$order_id.$amount.$cur_id.$to.$description.$secret);
* доступные валюты:
114 - Payeer RUR
116 - Bitcoin
109 - OOOPAY EUR
87 - OOOPAY USD
1 - Webmoney WMR
2 - Webmoney WMZ
63 - QIWI кошелек
45 - Яндекс.Деньги
69 - Perfect Money EUR
64 - Perfect Money USD
82 - Мобильный Платеж Мегафон Столичный филиал
137 - Мобильный Платеж МегаФон Северо-Западный филиал
138 - Мобильный Платеж МегаФон Сибирский филиал
139 - Мобильный Платеж МегаФон Кавказский филиал
140 - Мобильный Платеж МегаФон Поволжский филиал
141 - Мобильный Платеж МегаФон Уральский филиал
142 - Мобильный Платеж МегаФон Дальневосточный филиал
143 - Мобильный Платеж МегаФон Центральный филиал
83 - Мобильный Платеж Билайн
84 - Мобильный Платеж МТС
94 - VISA/MASTERCARD
132 - Мобильный Платеж Tele2
70 - PayPal

Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc></desc>
  <answer>
    <payment_id>1</payment_id>
    <order_id>15</order_id>
    <amount>13.23</amount>
  </answer>
</document>

Поскольку некоторые операции выполняются с задержкой, рекомендуется в настройках API указать Cashout URL, на который будет отправлено уведомление об успешной оплате. Сообщение будет отправлено методом POST со следующими данными:
m ID магазина
payment_id Номер операции OOOPay, полученный при отправке запроса
status Статус платежа
sign Подпись, формируется из параметров m.payment_id.status.secret и шифруется md5
пример на php: md5($m.$payment_id.$status.$secret);

Возможные статусы:
PAYED - оплачен
CANCELED - отменен

Оплата онлайн услуг



Запросы необходимо отправлять методом POST на url https://www.ooopay.org/cashin_v1.php

Получить список направлений

m ID магазина
action get_service_ids
sign Подпись, формируется из параметров m.secret и шифруется md5
пример на php: md5($m.$secret);
Пример запроса:

POST cashin_v1.php HTTP/1.1
Host: www.ooopay.org
Параметры
m=1&action=get_service_ids&sign=md5('1'.'supersecret')

Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc></desc>
  <answer>
    <service id="mts">MTS</service>
    <service id="bee">Beeline</service>
    <service id="mgf">Megafone</service>
  </answer>
</document>

Получить список необходимых полей

m ID магазина
service_id ID направления
action get_service_fields
sign Подпись, формируется из параметров m.service_id.secret и шифруется md5
пример на php: md5($m.$service_id.$secret);
Пример запроса:

POST cashin_v1.php HTTP/1.1
Host: www.ooopay.org
Параметры
m=1&service_id=2&action=get_service_fields&sign=md5('1'.'2'.'supersecret')

Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc></desc>
  <answer>
    <name>phone</name>
    <caption>Номер телефона</caption>
    <type>text</type>
    <required>1</required>
    <min_length>10</min_length>
    <max_length>10</max_length>
    <is_number>1</is_number>
    <tab_order>0</tab_order>
    <regexp>NULL</regexp>
    <min_com>10</min_com> - Минимальная комиссия в рублях!
  </answer>
</document>

Выполнить перевод онлайн платежа

m ID магазина
order_id Номер заказа магазина
должен быть уникальным
amount Сумма перевода
service_id id направления
phone, number, type... обязательные поля, полученные методом get_service_fields
currency RUR,USD,EUR
action payonline
sign Подпись, формируется из параметров m.order_id.amount.service_id.currency.secret и шифруется md5
пример на php: md5($m.$order_id.$amount.$service_id.$currency.$secret);
Пример запроса:

POST cashin_v1.php HTTP/1.1
Host: www.ooopay.org
Параметры
m=1&order_id=13&amount=2&service_id=2&account=9261231212¤cy=RUR&action=payonline&sign=md5('1'.'13'.'2'.'2'.'RUR'.'supersecret')

Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc></desc>
  <answer>
    <payment_id>1</payment_id>
    <order_id>15</order_id>
    <amount>13.23</amount>
  </answer>
</document>



Проверка состояния платежа



Запросы необходимо отправлять методом POST на url https://www.ooopay.org/cashin_v1.php

Проверить статус платежа можно по id или order_id

m ID магазина
id Номер заказа www.ooopay.org
order_id Номер заказа магазина
только для получения деталей операции по переводу средств
direction Направление перевода
1-перевод средств
2-получение средств
3-вывод средств
action p_status
sign Подпись, формируется из параметров m.id.order_id.secret и шифруется md5
пример на php: md5($m.$id.$order_id.$secret);
Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc></desc>
  <answer>
    <payment_id>1</payment_id>
    <order_id>15</order_id>
    <amount>13.23</amount>
    <status>PAYED</status>
  </answer>
</document>

Возможные статусы:
NEW - новый
PAYED - оплачен
COMPLETED - выплачен
CANCELED - отменен


Проверка баланса



Запрос необходимо отправлять методом POST на url https://www.ooopay.org/cashin_v1.php

m ID магазина
action balance
sign Подпись, формируется из параметров m.secret и шифруется md5
пример на php: md5($m.$secret);
Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc></desc>
  <answer>
    <USD>32.84</USD>
    <RUR>638.86</RUR>
    <EUR>26.23</EUR>
  </answer>
</document>



Проверка привязки WMID



Запросы необходимо отправлять методом POST на url https://www.ooopay.org/cashin_v1.php

m ID магазина
wmid WMID
c4w_id Номер счета получателя в системе OOOPAY
action check_wmid
sign Подпись, формируется из параметров m.wmid.c4w_id.secret и шифруется md5
пример на php: md5($m.$wmid.$c4w_id.$secret);
Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc>wmid confirmed</desc>
  <answer></answer>
</document>



Получение данных CashPassport



Для получения данных необходимо открыть в новом окне пользователю форму авторизации на ooopay.org https://www.ooopay.org/ap_login.php?m=3&r=12345&c=2&s=YGDS6JBHF , где
m ID магазина
r случайное число или номер заказа, этот параметр будет передан обратно вместе с CashPassport данными
с Номер валюты
s Подпись, формируется из параметров m.r.secret и шифруется md5
пример на php: md5($m.$r.$secret);
Возможные валюты:
1 - Сбербанк
2 - Альфабанк
3 - ВТБ24
4 - Связной-Банк

После авторизации пользователя, на Ваш Cash Pasport Result url методом POST будут отправлены следующие данные:
m ID магазина
r случайное число или номер заказа, этот параметр будет передан обратно вместе с CashPassport данными
с Номер валюты
data Данные CashPassport
s Подпись, формируется из параметров m.r.c.secret и шифруется md5
пример на php: md5($m.$r.$c.$secret);
Данные CashPassport могут содержать следующие значения:
card_number - Номер карты
card_expire - Срок действия карты
account_number - Номер счета
name - ФИО
unk - УНК (ВТБ24)


Проверка валидности кошелька OOOPAY



Запросы необходимо отправлять методом POST на url https://www.ooopay.org/cashin_v1.php

m ID магазина
c4w_id Номер счета получателя в системе OOOPAY
action check_purse
sign Подпись, формируется из параметров m.c4w_id.secret и шифруется md5
пример на php: md5($m.$c4w_id.$secret);
Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc>user found</desc>
  <answer>
    <partner>true</partner>
  </answer>
</document>

</document>



Прием платежей



Форму для приема платежей надо отправлять методом GET на url https://www.ooopay.org/page/payments/ со следующими параметрами:

m ID магазина
amount Сумма платежа
order_id Номер заказа
lang язык интерфейса (en, ru), необязательно
currency Валюта приема магазина (USD, EUR, RUR)
sign Подпись запроса, формируется следующим образом: md5(m.amount.order_id.currency.секретный ключ)
pcur Опционально - выбранная валюта для совершения платежа
email Опционально - Email покупателя
После завершения платежа, наш сервис уведомит Ваш сайт методом POST по RESULT URL (указывается в настройках API), со следуюшими параметрами:
m ID магазина
amount Сумма платежа
order_id Номер заказа
payment_id Номер платежа в OOOPay
currency Валюта платежа
sign Подпись запроса, формируется следующим образом: md5(m.order_id.amount.секретный ключ)


Доступные валюты:
1 - OOOPay (комиссия 0.50%)
2 - VISA/MASTERCARD USD (комиссия 3.40%)
3 - VISA/MASTERCARD RUB (комиссия 3.90%)
4 - VISA/MASTERCARD EUR (комиссия 3.90%)
5 - QIWI кошелек (комиссия 5.00%)
6 - Яндекс.Деньги (комиссия 5.00%)
7 - WebMoney (комиссия 2.00%)
9 - FREE-KASSA (комиссия 5.00%)
10 - VISA/MASTERCARD RUB (комиссия 2.80%)
11 - VISA/MASTERCARD USD+ (комиссия 0.00%)
12 - Bitcoin (комиссия 4.00%)
13 - BTC-E (комиссия 5.00%)
14 - Litecoin (комиссия 10.00%)
16 - VISA/MASTERCARD UAH (комиссия 2.80%)


Выставление счета



Запросы необходимо отправлять методом POST на url https://www.ooopay.org/cashin_v1.php

m ID магазина
order_id Номер заказа магазина
должен быть уникальным
amount Сумма перевода
to Номер счета получателя (WM1234xxxx) или телефон или email
description Описание платежа
currency RUR,USD,EUR
action bill_payment
sign Подпись, формируется из параметров m.order_id.to.amount.currency.secret и шифруется md5
пример на php: md5($m.$order_id.$to.$amount.$currency.$secret);
Ответ в xml:

<?xml version="1.0"?>
<document>
  <error>0</error>
  <desc></desc>
  <answer>
    <bill_id>123</bill_id>
  </answer>
</document>



Примеры скриптов



Примеры на php: скачать


Ошибки



Account disabled - Аккаунт отключен
sign error - Подпись неверна
Amount error - Сумма неверна
Incorrect WMID - WMID указан неверно
merchant not found or not activated - Магазин не найден или отключен
need verification - Необходимо пройти верификацию
low amount - Недостаточно средств на балансе
Service not found - Услуга не найдена
user not found - Пользователь не найден
empty payee - Не указан получатель
payee not found - Получатель не найден
can not pay for itself - Перевод самому себе запрещен
wrogn currency - Валюта оплаты неверна
order not found - Заказ не найден
same order_id already exist - Такой номер заказа уже существует