Интеграция с вашим сервисом
Мерчант: создание заявок обмена с вашего сайта и уведомления о статусе.

Создать заявку
Используйте метод public/exchanger/order/create.
| Название | Описание | Тип |
|---|---|---|
routeId | id направления | ObjectID |
partner | код партнёра | STRING |
amount | сумма | FLOAT |
fromValues[0][key] | ключ поля | ObjectID |
fromValues[0][value] | значение поля | STRING |
toValues[0][key] | ключ поля | STRING |
toValues[0][value] | значение поля | STRING |
routeValues[0][key] | ключ поля | ObjectID |
routeValues[0][value] | значение поля | STRING |
lang | язык (ru, en, uk) | STRING |
agreement | согласие с правилами | BOOLEAN |
hideOutData | скрыть реквизиты получателя | BOOLEAN |
clientCallbackUrl | куда вернуть клиента после завершения заявки: ?status=success или ?status=error | STRING |
ipnUrl | URL уведомления о смене статуса заявки | STRING |
ipnSecret | строка для подписи уведомления | STRING |
Авторизация по API-ключу описана в личном кабинете, все методы — в документации API.
IPN — уведомление о смене статуса
Чтобы получать уведомления, при создании заявки передайте дополнительные параметры:
clientCallbackUrl— клиент увидит кнопку возврата на ваш сайт и попадёт на этот URL;hideOutData— скрыть данные получателя;ipnUrl— HTTP/HTTPS-адрес вашего сервера для уведомлений;ipnSecret— случайная строка для подписи уведомления.
- Уведомление отправляется методом POST,
Content-Type: application/x-www-form-urlencoded. - Уведомление отправляется один раз.
- Доставка не гарантируется: если сервер не ответил, повтора не будет.
Поля уведомления
| Поле | Тип | Описание |
|---|---|---|
orderUID | Number | uid заявки |
orderId | String(ObjectId) | id заявки |
newStatus | String | текущий статус заявки |
inAmount | String(number) | сумма, которую отдаёт клиент |
outAmount | String(number) | сумма, которую получает клиент |
xml_from | String | код отдаваемой валюты |
xml_to | String | код получаемой валюты |
timestamp | Number | unix-время уведомления |
toValues | Array([{key,name,value}]) | реквизиты заявки |
Статусы
| Статус | Описание |
|---|---|
new | новая заявка |
waitPayment | ожидаем платёж от пользователя |
errorPayment | ошибка платежа пользователя |
inProgress | в обработке (ожидает оператора или оплату) |
inProgressPayout | в очереди на выплату: платёж принят |
errorPayout | ошибка выплаты |
hold | заявка заморожена |
done | заявка выплачена |
returned | платёж возвращён отправителю |
deleted | заявка удалена (отменена) |
Проверка подписи
sha256(orderId:newStatus:inAmount:outAmount:xml_from:xml_to:timestamp:ipnSecret)
const stringForHash = orderId + ":" + newStatus + ":" + inAmount + ":" + outAmount + ":" + xml_from + ":" + xml_to + ":" + timestamp + ":" + ipnSecret;
// пример строки: 5d8e6002b80b7b4cd75a6424:inProgress:2:317.42:ETH:WMZ:1571328406072:SECRET123
const hash = crypto.createHash('sha256').update(stringForHash).digest('hex');
// пример: af3acf947e6f0e0f2c267e300b8582e504dba12d1f2d058652b7414163c09f48Контроль и оплата
- Если создавать заявки с авторизацией по API-ключу, все они будут видны в вашем личном кабинете.
- Сохраните UID и secret заявки: по ним можно открыть заявку вручную.
- Страница оплаты для клиента:
// схема https://111obmen.com/{lang}/payment/{order-uid}/{order-secret}/ // пример https://111obmen.com/ru/payment/1409/dGqwF2M2eBPaSN1G5ljMS1cb/ - Либо обычная страница заявки, как её видят все клиенты: та же схема, но
/order/вместо/payment/. - Метод создания умеет возвращать платёжные данные, чтобы показать оплату на вашем сайте. Важно: при предоплате после оплаты переведите заявку из
waitPaymentвinProgress.