О компании
Новости
Обзор возможностей
Тарифы
Карта OOOPAY MasterCard
API документация
Прием платежей на сайте
Модули для приема платежей
Обменники
Подключить обменный пункт
Массовые платежи
Депозиты «Мой сейф»
CashPassport
e-Voucher
Партнерам
Вопросы и ответы
Реферальная программа
API документация
Готовые модули для приема платежей.
Управление кошельком
- Перевод платежа
- Вывод средств
- Оплата онлайн услуг
- Проверка платежа
- Проверка баланса
- Проверка привязки WMID
- Получение данных CashPassport
- Проверка валидности кошелька OOOPAY
- Выставление счета
- Примеры скриптов
Прием платежей
Перевод платежа
Запросы необходимо отправлять методом 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 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 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
157 - VISA/MASTERCARD UAH-
136 - ADVCASH USD
150 - ADVCASH RUB
162 - QIWI KZT
123 - QIWI USD
161 - QIWI EUR
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 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 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 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); |
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 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 покупателя |
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 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 - Такой номер заказа уже существует