API базируется на технологии REST API. В системе используются ресурсо-ориентированные точки входа (endpoints), а все ответы, возвращаемые системой, имеют формат JSON.
\nВсе запросы к API должны осуществляться через HTTPS. Запросы с HTTP будут отклоняться.
\nAPI является асинхронным (незначительная часть запросов работает синхронно): на ваш запрос вы синхронно получите id платежа (запроса), а затем в асинхронном режиме получите callback-уведомление, включающее полученный ранее id платежа (запроса), а также статус операции и прочие данные по ней.
Для того, чтобы вы могли максимально протестировать API, вы можете использовать тестовое (stage) и боевое (prod) окружения. Запросы, создаваемые в тестовом окружении, никогда передаются в банковские информационные системы и, следовательно, не приводят к возникновению затрат.
Мерчант — юридическое или физическое лицо, принимающее денежные средства от клиентов или выплачивающее денежные средства.
\nМаркетплейс — мерчант (только юридическое лицо), который имеет возможность отправлять запросы на ввод/вывод средств от имени других мерчантов (саб-мерчантов).
\nСаб-мерчант — мерчант (юридическое или физическое лицо), средства на счет которого зачисляются (в случае приема платежей) или списываются (в случае выплат) по запросу от маркетплейса.
\nПараметр {{domain}} для тестового окружения принимает значение:
api-sandbox.mandarinpay.com
\nДля подключения тестового окружения Вам необходимо связаться с менеджерами MandarinPay и сообщить данные, необходимые для регистрации личного кабинета. В личном кабинете авторизационные данные можно найти, следуя инструкции.
\nПараметр {{domain}} для боевого окружения принимает значение:
api.mandarinpay.com
\nДанные тестовых карт для проверки работоспособности на тестовом окружении.
\nИнструмент HeartBeat осуществляет мониторинг транзакций и callback-уведомлений:
\nДля входа используйте MerchantID и Secret в качестве логина и пароля соответственно.
Запрос должен быть с заголовком Content-Type: application/json. Авторизация запросов к API происходит путем использования API Secret Key и вашего Merchant ID для формирования заголовка X-Auth следующего содержания: merchantId-SHA256(merchantId-requestId-secret)-requestId
requestId - уникальный номер запроса, представляющий из себя текущий таймстамп в миллисекундах, либо набор байт, сгенерированный криптографически-надёжным генератором случайных числел.
API запросы без заголовка или с некорректным заголовком, в том числе некорректным X-Auth, будут отклонены без создания транзакций.
Для проверки корректности расчета X-Auth можете воспользоваться данной утилитой.
Пример расчета Х-Auth на PHP:
<?php\nfunction gen_auth($merchantId, $secret)\n{\n $reqid = time() .\"_\". microtime(true) .\"_\". rand();\n $hash = hash(\"sha256\", $merchantId .\"-\". $reqid .\"-\". $secret);\n return $merchantId .\"-\".$hash .\"-\". $reqid;\n}\n?>\nMandarinPay использует стандартные HTTP коды для индикации успешности или неуспешности API запросов. \nВ общем случае, коды формата 2хх означают успешность, коды формата 4xx говорят о неуспешности запроса в связи с предоставленной информацией (отсутствие нужного формата, неверно сформированный заголовок и т.д.), коды в формате 5хх говорят о неисправности на стороне сервера MandarinPay (довольно редкий случай).
Примеры ответов
\nЗапрос обработан корректно, транзакция создана:\n200-OK
Для транзакции:
\n{\n \"id\": \"43913ddc000c4d3990fddbd3980c1725\",\n \"userWebLink\": \"https://secure.mandarinpay.com/Pay?transaction=0eb51e74-e704-4c36-b5cb-8f0227621518\",\n \"jsOperationId\": \"9874694yr87y73e7ey39ed80\"\n}\nДля привязки:
\n{\n \"id\": \"0eb51e74-e704-4c36-b5cb-8f0227621518\",\n \"userWebLink\": \"https://secure.mandarinpay.com/CardBindings/New?id=0eb51e74-e704-4c36-b5cb-8f0227621518\",\n \"jsOperationId\": \"binding-4994591t5-194t694159t-43t5345\"\n}\nЗапрос некорректен, транзакция не создана:\n400-Bad Request
{\n \"error\": \"Invalid request\"\n}\nПеречень полей и их описание
\nПосле получения прямого ответа существует три варианта развития событий:
\n1. Для использования платежной страницы
\nПеренаправить пользователя по ссылке, полученной в качестве userWebLink (см. в отдельной главе).
2. Для использования встроенной формы CustomPay
\nИспользовать значение из jsOperationId в качестве OperationId в соответствии с описанием (см. в отдельной главе).
3. Для запросов с асинхронным ответом
\nОжидать callback, значение id которого будет равно значению id, полученному в синхронном ответе.
Далее в описании запросов указано, выполняются ли они синхронно, или помимо синхронного ответа будет также асинхронный callback.
\nУведомления высылаются на CallbackUrl POST-запросом с Content-Type: application/x-www-urlencoded. Значение CallbackUrl необходимо передавать в составе соответствующего запроса к API.
Для подтверждения того, что уведомление пришло именно от системы MandarinPay, а также тот факт, что данные переданные в уведомлении не были искажены, необходимо проверять значение поля sign.
Поле sign представляет из себя SHA256-сумму от значений всех параметров уведомления, отсортированных алфавитно по именам и Secret, разделённых символом -.
ОБРАТИТЕ ВНИМАНИЕ\nВСЕ ПОЛЯ УВЕДОМЛЕНИЯ ДОЛЖНЫ БЫТЬ ОТСОРТИРОВАНЫ В АЛФАВИТНОМ ПОРЯДКЕ С ИСПОЛЬЗОВАНИЕМ СТАНДАРТНОГО АЛГОРИТМА СОРТИРОВКИ ВАШЕГО ЯЗЫКА ПРОГРАММИРОВАНИЯ!
\nДля проверки правильности расчета sign можете воспользоваться данной утилитой.
![\"screen\"](\"http://docs.mandarinbank.com/images/CheckSign.png\")
callback в поле (1);Secret в поле (2);Sign будет рассчитано автоматически в поле (3).В качестве ответа, обозначающего, что callback успешно обработан на вашей стороне, необходимо вернуть в MandarinPay ответ с HTTP-код 200 и телом OK.
Обратите внимание
\nЛюбой другой ответ будет означать, что callback не обработан. В этом случае MandarinPay повторяет отправку callback-запроса в течение 2 суток, или до получения ответа об успешной обработке (в зависимости от того, что наступит ранее).
\nВ зависимости от значения object_type уведомления бывают следующих видов:
\nОбратите внимание\nСостав полей в callback-уведомлении может меняться, для этих целей добавлена “соль”, поэтому важно использовать корректный обработчик и не хардкодить набор полей.
\nПеречень и описание полей, передаваемых в составе callback-уведомления
\nПример callback-уведомления об успешной оплате
\n3dsecure=true&action=pay&callbackUrl=http%3A%2F%2Fapi.example.com%2Fpayment%2Fcallback&card_expiration_month=09&card_expiration_year=2020&card_holder=CARD%20HOLDER&card_number=426101XXXXXX0981&cb_customer_creditcard_number=426101XXXXXX0981&cb_processed_at=2019-07-02T17%3A19%3A48.9263239Z&customer_email=payer%40example.com&customer_fullName=%20%20&destinationWallet=77da9a25-6375-4564-ae16-4b7cf67abcbd&email=payer%40example.com&gw_channel=psb&gw_id=21170999&merchantId=1155&object_type=transaction&orderActualTill=2019-07-02%2017%3A38%3A49%2B00%3A00&orderId=pmnt664-41-1562087929&payment_system=mandarinpayv1&price=200&returnUrl=http%3A%2F%2Fapi.example.com%2Fpayment%2Freturn&sourceWallet=None&status=success&transaction=9077846044464860b77f5bd21db014d1&transaction_rrn=918391478368&d6797d04-d688-4a55-8190-861224243701=fde5f8f3-f207-4006-abe6-ad2e1eaddab6&sign=9bb79a61ac033c9fa4ed9e34ff924125a4f591fb824aa116002d21c1f1a1d45c\nПример callback-уведомления о успешной выплате
\naction=payout&callbackUrl=http%3A%2F%2Fapi.example.com%2Fpayment%2Fcallback&card_number=479087XXXXXX7961&cb_customer_creditcard_number=479087XXXXXX7961&cb_processed_at=2019-07-02T13%3A23%3A46.1177446Z&customer_email=payer%40example.com&customer_fullName=%20%20&customer_phone=%2B79265115520&destinationWallet=None&email=payer%40example.com&gw_channel=psb_ng&gw_id=21161072&merchantId=1155&object_type=transaction&orderActualTill=2019-07-04%2013%3A23%3A43Z&orderId=pmnt331-6-1562073823&payment_system=mandarinpayv1&price=67.96&returnUrl=http%3A%2F%2Fapi.example.com%2Fpayment%2Freturn&sourceWallet=3cee651d-5f4a-4cc3-83b8-83646ae8a84b&status=success&transaction=d09cebe4b07c4171ae9a8f23d1b22eb8&transaction_rrn=918347529420&81476cc7-215f-4416-9649-174633cd71b0=9cce5a9a-06ac-4668-864f-99550d3fc6d2&sign=c96f954bf6ff5928e044d361eca5ab463aa135ff29423a2c5c81301880034773\nПример callback-уведомления об отсутствии оплаты в течение срока резервирования товара (ошибка)
\naction=pay&callbackUrl=http%3A%2F%2Fapi.example.com%2Fpayment%2Fcallback&customer_email=eagles%40chay.mobi&customer_fullName=%20%20&destinationWallet=77da9a25-6375-4564-ae16-4b7cf67abcbd&email=payer%40example.com&merchantId=1155&object_type=transaction&orderActualTill=2019-07-02%2019%3A28%3A43%2B00%3A00&orderId=pmnt664-41-1562094523&payment_system=mandarinpayv1&price=400&returnUrl=http%3A%2F%2Fapi.example.com%2Fpayment%2Freturn&sourceWallet=None&status=failed&transaction=1bc6f9c909c4403099ea4a512fa42fb0&2133d4e2-59b4-409e-af51-fd5b7479b708=2c004082-f99a-42a2-9deb-7326c6ab5737&sign=c3b32530a12e93f65b9a3ef76955bbc318ea22f6daa8aa4114b72d56d602b3e9\nПример проверки sign
\n<?php\nfunction check_sign($secret, $req)\n{\n $sign = $req['sign'];\n unset($req['sign']);\n $to_hash = '';\n if (!is_null($req) && is_array($req)) {\n ksort($req);\n $to_hash = implode('-', $req);\n }\n\n $to_hash = $to_hash .'-'. $secret;\n $calculated_sign = hash('sha256', $to_hash);\n return $calculated_sign == $sign;\n}\n\ncheck_sign(\"123\", $_POST);\n?>\nКаждый вызов API имеет ассоциируемый с ним идентификатор, который называется ID платежа (PaymentID) и передается в составе прямого ответа в качестве id. Он также присутствует в составе callback-уведомления в качестве значения transaction или card_binding.
ID платежа также доступен в таблице транзакций в вашем личном кабинете на сайте mandarinpay.com (на рисунке ниже) и в интерфейсе Heartbeat.
\nПри обращении в Службу поддержки по конкретному платежу наличие 'id' платежа существенно ускорит получение ответа.
\nПлатежная страница MandarinPay имеет адаптивный дизайн, содержит ваш логотип, а также информацию о платеже, переданную вами в API запросе.
\nДля работы с платежной страницей вам необходимо использовать перенаправление пользователя на страницу оплаты, полученную в параметре userWebLink синхронного ответа на ваш API запрос.
Встроенная форма оплаты CustomPay позволяет осуществить полноценную интеграцию в ваш интерфейс. При этом отсутствует требование к Вам по соответствию стандарту безопасности банковских карт PCI DSS.
\nCustomPay представляет собой форму с полями, которые на самом деле являются отдельными страницами в iframe-ах. Соответственно, вы можете стилизовать всё, что эти самые iframe-ы окружает.
\nЛогически такая форма состоит из 2 частей:
\nmandarinpay-field-card-number, mandarinpay-field-card-holder, mandarinpay-field-card-expiration и mandarinpay-field-card-cvv, внутрь этих div-ов будут помещены iframe-ы<script src=\"https://secure.mandarinpay.com/api/hosted.js\"></script>, затем вызвать mandarinpay.hosted.setup, передав ему селектор формы, а так же функции для вызова при успехе либо ошибке. В обработчике события нажатия на кнопку следует вызвать return mandarinpay.hosted.process(this); (вместо this можно использовать селектор формы).В качестве operationId необходимо передать значение, полученное в прямом ответе MandarinPay в поле jsOperationid.
По мере взаимодействия формы с пользователем div-ам могут быть присвоены классы mandarinpay-field-state-error, mandarinpay-field-state-focused и mandarinpay-field-state-valid.
Пример формы:\n
<form id=\"form-hosted-pay\">\n <div style=\"margin: 10px; padding: 10px; border: 1px solid gray\">\n Card Number:\n <div class=\"mandarinpay-field-card-number hosted-field\"><div class=\"glyphicon glyphicon-check\"></div></div>\n Card Holder:\n <div class=\"mandarinpay-field-card-holder hosted-field\"><div class=\"glyphicon glyphicon-check\"></div></div>\n Card Expiration:\n <div class=\"mandarinpay-field-card-expiration hosted-field\"><div class=\"glyphicon glyphicon-check\"></div></div>\n CVV:\n <div class=\"mandarinpay-field-card-cvv hosted-field\"><div class=\"glyphicon glyphicon-check\"></div></div>\n <br/>\n <a href=\"#\" onclick=\"return mandarinpay.hosted.process(this);\" class=\"btn btn-default\">Оплатить</a>\n </div>\n</form>\nИнициализация (подключение) скрипта:
\n<script>\nmandarinpay.hosted.setup(\"#form-hosted-pay\", {\n operationId: \"9874694yr87y73e7ey39ed80\",\n onsuccess: function(data) {\n alert(\"Success, id: \" + data.transaction.id);\n },\n onerror: function(data) {\n alert(\"Error: \" + data.error);\n }\n});\n</script>\nПо факту успешного проведения оплаты, скрипт вызывает функцию onsuccess (передавая id транзакции), при ошибке - функцию onerror.
CSS для полей:
\n.hosted-field\n{\n background: #f0f0f0;\n height: 40px;\n padding: 5px;\n border: 1px solid gray;\n border-radius: 10px;\n}\n\n.hosted-field {\n position: relative;\n}\n\n.hosted-field .glyphicon {\n visibility: hidden;\n position: absolute;\n right: 5px;\n top: 5px;\n color: green;\n float: right;\n}\n\n.mandarinpay-field-state-error\n{\n background: #fff0f0;\n border: 1px solid #900000;\n}\n\n.mandarinpay-field-state-focused\n{\n background: #ffffff;\n border: 1px solid yellowgreen;\n}\n\n.mandarinpay-field-state-valid {\n background: #c0ffc0 !important;\n border: 1px solid green !important;\n}\n\n.mandarinpay-field-state-valid .glyphicon{\n visibility: visible;\n}\nСтилизация осуществляется посредством добавления соответствующего поля в объект, передаваемый mandarinpay.hosted.setup. Для изменения доступны плейсхолдер и ряд CSS-стилей.
Для использования доступны:
\ncolor в формате #000000font-size с единицами px и ptfont-family (можно использовать запятые и кавычки)font-styleПример стилизации
\nmandarinpay.hosted.setup(\"#form-hosted-pay\",\n{\n onsuccess: function(data) {alert(\"Success, id: \" + data.transaction.id);},\n onerror: function(data) {alert(\"Error: \" + data.error);},\n fields:\n {\n \"card-number\": {\n settings: {\n placeholder: \"НОМЕР КАРТЫ\",\n styles: {\n \"font-size\": \"20px\",\n \"font-family\": \"Helvetica\",\n \"color\": \"#0000c0\"\n },\n placeholderStyles: {\n \"color\": \"pink\" \n },\n }\n }\n }\n});\nmerchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"body":{"mode":"raw","raw":"{\n \"type\": \"person\",\n \"person\": {\n \"phone\": \"{{mobile_phone}}\" \n }\n}"},"url":"https://{{domain}}/v1/wallets","description":"Запрос выполняется синхронно.
\nОтвет может содержать более широкий набор полей, чем в примере.
\nАккаунт необходимо создавать в случае, если с него планируются расходные операции на другие аккаунты, на банковские карты и прочие способы оплаты, а также приходные операции с других Аккаунтов, а также холдирования средств клиента.
\nИспользовать аккаунт как транзит, то есть для пополнения и одновременного перечисления на другой аккаунт не имеет смысла. В этом случае целесообразней напрямую совершать пополнение целевого аккаунта выбранным способом оплаты.
\nДля создания аккаунта физлица, необходимо указать номер его телефона. Остальная информация предоставляется во время идентификации.
\nСинхронный ответ содержит идентификатор аккаунта.
\nТело запроса:
\n","urlObject":{"protocol":"https","path":["v1","wallets"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"283d46c5-05bb-49ed-be50-7b50d9c6cf8b","name":"Создание аккаунта [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\n \"type\": \"person\",\n \"person\": {\n \"phone\": \"+71234567890\"\n }\n}"},"url":"https://api-sandbox.mandarinpay.com/v1/wallets"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 09:23:38 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"46"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"d1387389-b6c7-4a80-81a4-3960ed96cfd0\"\n}"}],"_postman_id":"731b3956-4a82-4359-8554-1cf1c36a60fb"},{"name":"Запрос баланса","id":"62db582c-2236-4514-a083-42d62430c715","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"X-Auth","value":"{{x_auth}}","type":"text","description":"merchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"url":"https://{{domain}}/v1/wallets/{{account_id}}/balance","description":"Запрос выполняется синхронно.
\nОтвет может содержать более широкий набор полей, чем в примере.
\nСинхронный ответ содержит баланс аккаунта.
\n","urlObject":{"protocol":"https","path":["v1","wallets","{{account_id}}","balance"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"412dad2d-af42-476f-8ddd-ca323c1d329b","name":"Баланс аккаунта после пополнения [Stage]","originalRequest":{"method":"GET","header":[{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"url":"https://api-sandbox.mandarinpay.com/v1/wallets/d1387389-b6c7-4a80-81a4-3960ed96cfd0/balance"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 09:58:57 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"12"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RUB\": 5000.0\n}"},{"id":"44f90d45-1f39-478b-88ea-a7aed29966f4","name":"Баланс нового аккаунта [Stage]","originalRequest":{"method":"GET","header":[{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"url":"https://api-sandbox.mandarinpay.com/v1/wallets/d1387389-b6c7-4a80-81a4-3960ed96cfd0/balance"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 09:38:15 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"12"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"RUB\": 0\n}"}],"_postman_id":"62db582c-2236-4514-a083-42d62430c715"}],"id":"ea094c49-b667-4650-a7cd-beab339c94dd","description":"Для получения средств, последующего вывода и другого использования электронных средств платежа (ЭСП), пользователь (ФЛ) должен иметь аккаунт.
\nПосле создания, аккаунт имеет уровень идентификации ЭСП 1 (владелец не идентифицирован).
\nДалее необходимо произвести упрощенную идентификацию владельца аккаунта с помощью API. После ее успешного окончания, аккаунт получает уровень ЭСП 2 (владелец упрощенно идентифицирован). Теперь на аккаунт можно принимать платежи с банковской карты, хранить и выводить средства на банковскую карту. При этом лимиты на сумму операций довольно строгие.
\nДля увеличения лимитов, владелец может пройти полную идентификацию. Для этого необходимо посетить офис расчетного банка в Москве. Аккаунт получает тип ЭСП 3 (владелец прошел полную идентификацию).
\n","event":[{"listen":"prerequest","script":{"id":"0df9610b-ed3e-4db4-93d7-971f464bbec5","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7f1188ea-c851-48cc-a4ae-8e9a34c20b1a","type":"text/javascript","exec":[""]}}],"_postman_id":"ea094c49-b667-4650-a7cd-beab339c94dd"},{"name":"Упрощенная идентификация аккаунта","item":[{"name":"Создание запроса на упрощенную идентификацию по паспорту и СНИЛС","event":[{"listen":"test","script":{"id":"d0d4b42d-53d5-402e-87bf-400b49f9b915","exec":["var jsonData = JSON.parse(responseBody);\r","pm.environment.set(\"session_id\", jsonData.sessionId);"],"type":"text/javascript"}}],"id":"671eae80-a86c-4c50-b652-ceb9d05c3f34","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"{{x_auth}}","type":"text","description":"merchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"body":{"mode":"raw","raw":"{\r\n\t\"phone\": \"{{mobile_phone}}\",\r\n\t\"firstName\": \"{{first_name}}\",\r\n\t\"patronymic\": \"{{patronymic}}\",\r\n\t\"lastName\": \"{{last_name}}\",\r\n\t\"passportSeries\": \"{{passport_series}}\",\r\n\t\"passportNumber\": \"{{passport_number}}\",\r\n\t\"snils\": \"{{snils}}\"\r\n}"},"url":"https://{{domain}}/v1/wallets/{{account_id}}/identification","description":"Запрос выполняется синхронно.
\nОтвет может содержать более широкий набор полей, чем в примере.
\nЗапрос содержит номер телефона, номер паспорта, ФИО и номер СНИЛС. В качестве значения accountId используется идентификатор созданного ранее аккаунта. \nВ случае успешной регистрации запроса Вам вернется идентификатор сессии sessionId, а на используемый номер телефона будет отправлено смс-сообщение с кодом для подтверждения номера телефона.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","wallets","{{account_id}}","identification"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"fcf3a743-9477-480b-aadf-de9b503f6904","name":"По паспорту и СНИЛС [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{ \n \"phone\": \"+71234567890\",\n \"firstName\": \"Иван\",\n \"patronymic\": \"Иванович\",\n \"lastName\": \"Иванов\",\n \"passportSeries\": \"1111\",\n \"passportNumber\": \"111111\",\n \"snils\": \"19033603123\"\n}"},"url":"https://api-sandbox.mandarinpay.com/v1/wallets/d1387389-b6c7-4a80-81a4-3960ed96cfd0/identification"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 11:50:21 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"sessionId\": \"0dae98e5-8274-42fe-9e65-a884087d4e9b\"\n}"}],"_postman_id":"671eae80-a86c-4c50-b652-ceb9d05c3f34"},{"name":"Создание запроса на упрощенную идентификацию по паспорту и ИНН","event":[{"listen":"test","script":{"id":"bde6b2d6-8622-4c06-9641-caa0dd55c55f","exec":["var jsonData = JSON.parse(responseBody);\r","pm.environment.set(\"session_id\", jsonData.sessionId);"],"type":"text/javascript"}}],"id":"1f5e0d83-d510-44d1-9df4-55888c5abc73","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"{{x_auth}}","type":"text","description":"merchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"body":{"mode":"raw","raw":"{\r\n\t\"phone\": \"{{mobile_phone}}\",\r\n\t\"firstName\": \"{{first_name}}\",\r\n\t\"patronymic\": \"{{patronymic}}\",\r\n\t\"lastName\": \"{{last_name}}\",\r\n\t\"passportSeries\": \"{{passport_series}}\",\r\n\t\"passportNumber\": \"{{passport_number}}\",\r\n\t\"inn\": \"{{inn}}\"\r\n}"},"url":"https://{{domain}}/v1/wallets/{{account_id}}/identification","description":"Запрос выполняется синхронно.
\nОтвет может содержать более широкий набор полей, чем в примере.
\nЗапрос содержит номер телефона, номер паспорта, ФИО и номер ИНН. В качестве значения accountId используется идентификатор созданного ранее аккаунта. \nВ случае успешной регистрации запроса Вам вернется идентификатор сессии sessionId, а на используемый номер телефона будет отправлено смс-сообщение с кодом для подтверждения номера телефона.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","wallets","{{account_id}}","identification"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"9f5768f1-03ba-4cfd-bc32-c5aa926d9e49","name":"По паспорту и ИНН [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\n \"phone\": \"+71234567890\",\n \"firstName\": \"Иван\",\n \"patronymic\": \"Иванович\",\n \"lastName\": \"Иванов\",\n \"passportSeries\": \"1111\",\n \"passportNumber\": \"111111\",\n \"inn\": \"501716749325\"\n}"},"url":"https://api-sandbox.mandarinpay.com/v1/wallets/d1387389-b6c7-4a80-81a4-3960ed96cfd0/identification"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 11:52:53 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"sessionId\": \"d0d57935-216b-408f-8747-2d6be10cf7d8\"\n}"}],"_postman_id":"1f5e0d83-d510-44d1-9df4-55888c5abc73"},{"name":"Подтверждение телефона","id":"4e989ab1-270e-4b77-98a6-073120b54af9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[{"key":"X-Auth","value":"{{x_auth}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"code\": \"{{sms_code}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{domain}}/v1/wallets/{{account_id}}/identification/{{session_id}}","description":"Запрос выполняется синхронно.
\nОтвет может содержать более широкий набор полей, чем в примере.
\nВ качестве значения accountId используется идентификатор созданного ранее аккаунта. В качестве значения sessionId используется полученный на предыдущем этапе sessionId.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","wallets","{{account_id}}","identification","{{session_id}}"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"724e3e62-bf6b-4acf-bd8f-387cd1aba955","name":"Подтверждение телефона [Stage]","originalRequest":{"method":"PUT","header":[{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"code\": \"123456\"\n}"},"url":"https://api-sandbox.mandarinpay.com/v1/wallets/d1387389-b6c7-4a80-81a4-3960ed96cfd0/identification/0dae98e5-8274-42fe-9e65-a884087d4e9b"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 12:01:54 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"104"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Accept"}],"cookie":[],"responseTime":null,"body":"{\r\n \"sessionId\": \"0dae98e5-8274-42fe-9e65-a884087d4e9b\"\r\n}"}],"_postman_id":"4e989ab1-270e-4b77-98a6-073120b54af9"},{"name":"Получение статуса идентификации","id":"bd6f62bc-e1e2-4521-826d-6e1449a1a6f5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Auth","value":"{{x_auth}}","type":"text"}],"url":"https://{{domain}}/v1/wallets/{{account_id}}/identification/{{session_id}}","description":"Запрос выполняется синхронно.
\nОтвет может содержать более широкий набор полей, чем в примере.
\nСинхронный ответ содержит следующую информацию:
\n","urlObject":{"protocol":"https","path":["v1","wallets","{{account_id}}","identification","{{session_id}}"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"ccb299b4-18cf-4b8c-bb98-3bff999b5559","name":"Проверка СМС-кода и персональных данных завершена успешно [Stage]","originalRequest":{"method":"GET","header":[{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"url":"https://api-sandbox.mandarinpay.com/v1/wallets/d1387389-b6c7-4a80-81a4-3960ed96cfd0/identification/0dae98e5-8274-42fe-9e65-a884087d4e9b"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 12:14:03 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"38"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Accept"}],"cookie":[],"responseTime":null,"body":"{\r\n\t\"phoneVerified\": true,\r\n\t\"phoneVerificationFinished\": true,\r\n\t\"personVerified\": true,\r\n\t\"personVerificationFinished\": true,\r\n\t\"personVerificationError\": null\r\n}"}],"_postman_id":"bd6f62bc-e1e2-4521-826d-6e1449a1a6f5"}],"id":"20eb0900-308d-49d8-8de4-86edcf2884ae","event":[{"listen":"prerequest","script":{"id":"91518178-8201-4de6-b8f3-9aa91ebe7018","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"27340cb9-2d86-4cf5-a525-d0fa44b2acad","type":"text/javascript","exec":[""]}}],"_postman_id":"20eb0900-308d-49d8-8de4-86edcf2884ae","description":""},{"name":"Привязка банковской карты","item":[{"name":"Привязка банковской карты","event":[{"listen":"test","script":{"id":"0cf6b782-48ee-4cbe-a966-e2ee22033450","exec":["var jsonData = JSON.parse(responseBody);\r","pm.environment.set(\"card_id\", jsonData.id);"],"type":"text/javascript"}}],"id":"b897a831-fe98-4d11-9276-9bdc8b452ee0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"{{x_auth}}","type":"text","description":"merchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"body":{"mode":"raw","raw":"{\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n }\n}"},"url":"https://{{domain}}/v1/card-bindings","description":"Запрос выполняется синхронно с дополнительным асинхронным ответом.
\nОтвет (как синхронный, так и асинхронный) может содержать более широкий набор полей, чем в примере.
\nТело запроса:
\n","urlObject":{"protocol":"https","path":["v1","card-bindings"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"cee7443f-79d1-470a-956f-1b91248eadd6","name":"Привязка банковской карты [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n }\n}"},"url":"https://api-sandbox.mandarinpay.com/v1/card-bindings"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 03 Jul 2019 13:09:07 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"Kestrel"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"4c9932c6-5e57-4807-9103-8c4083a06d23\",\n \"jsOperationId\": \"binding_4c9932c6-5e57-4807-9103-8c4083a06d23\",\n \"userWebLink\": \"https://secure.stage.psp.io/CardBindings/New?id=4c9932c6-5e57-4807-9103-8c4083a06d23\"\n}"}],"_postman_id":"b897a831-fe98-4d11-9276-9bdc8b452ee0"}],"id":"a8fe1b16-46ee-4a74-a936-bb7ba6d3d806","description":"Привязка карты (binding) используется для целей списания/зачисления на карту без участия пользователя, а также для проверки того, что пользователь имеет доступ к данной карте (списание контрольной суммы, проверка через 3DS).
\nПоддерживаются следующие разновидности привязок:
\nfull binding)payout-only)one-side binding)Все запросы отправляются на адрес:\nPOST https://{{domain}}/v1/transactions, где {{domain}} равен:
api-sandbox.mandarinpay.com - для тестовой среды (Stage);api.mandarinpay.com - для боевой среды (Prod)Транзакция будет осуществлена в асинхронном режиме. В результате запроса вам синхронно придет id транзакции, и асинхронно придет Callback-уведомление.
Полученные в синхронном ответе userWebLink используйте для работы с платежной страницей, а jsOperationId для работы через CustomPay.
Возможна ситуация, при которой привязка принудительно переводится в режим payout-only. Это происходит в случаях, когда от платежной системы приходит ответ с кодом, при котором дальнейшее проведение “автосписаний” невозможно. Такая привязка может быть использована для вывода средств на нее или для оплаты в интерактивном режиме (со вводом CVV/CVC-кода).
Перечень и описание возможных блоков и элементов запроса, а также обязательность их передачи приведены ниже:
\nБлок CUSTOMERINFO
\nДанный блок является ОБЯЗАТЕЛЬНЫМ
\nБлок URLS
\nБлок является НЕОБЯЗАТЕЛЬНЫМ
\nДанный блок позволяет передать ссылки для отправки callback-уведомления и возврата пользователя с платежной страницы.
\nБлок TARGET
\nБлок является НЕОБЯЗАТЕЛЬНЫМ
\nДанный блок предназначен для токенизации номера карты, используемой для того, чтобы не хранить в вашей системе номер карты. Данная операция осуществляется в синхронном режиме - в ответ вы получите id привязки.
merchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"{{order_id}}\",\n \"action\": \"pay\",\n \"price\": \"1000.00\",\n \"merchantFee\": \"130.00\",\n \"destinationWallet\": \"{{account_id}}\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n }\n}"},"url":"https://{{domain}}/v1/transactions","description":"Запрос выполняется синхронно с дополнительным асинхронным ответом.
\nОтвет (как синхронный, так и асинхронный) может содержать более широкий набор полей, чем в примере.
\nОдностадийная оплата предполагает, что денежные средства списываются с карты в рамках одного запроса.\nВ процессе оплаты клиент вводит данные карты.
\nВАЖНО!
\nВ примере ниже с карты плательщика будет списано 1000 рублей. Саб-мерчант получает 870 рублей.\nМаркетплейс получает 130 рублей в виде комиссии (комиссия учитывается внутри суммы к списанию), из которой 30 рублей будет списано как комиссия MandarinPay (согласно условиям договора).
\nТранзакция будет осуществлена в асинхронном режиме. В результате запроса вам синхронно придет id транзакции, и асинхронно придет callback-уведомление.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","transactions"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"9fe1d41e-578e-4b61-afcf-38f84701ed38","name":"Оплата картой [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"123321\",\n \"action\": \"pay\",\n \"price\": \"1000.00\",\n \"merchantFee\": \"130.00\",\n \"destinationWallet\": \"d1387389-b6c7-4a80-81a4-3960ed96cfd0\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n }\n}"},"url":"https://api-sandbox.mandarinpay.com/v1/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 13:48:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"205"},{"key":"Connection","value":"keep-alive"},{"key":"Via","value":"waitress"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"9ac3775a809442e58a5c4407be4e29df\",\n \"userWebLink\": \"https://secure.stage.psp.io/Pay/Select?transaction=9ac3775a809442e58a5c4407be4e29df\",\n \"jsOperationId\": \"9ac3775a809442e58a5c4407be4e29df\"\n}"}],"_postman_id":"7a843783-5bd3-4bda-a0f8-d03aa4b9296a"},{"name":"Одностадийное пополнение с привязанной карты","id":"e907616e-4a67-412b-a877-088a4e912187","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"description":"merchantId-SHA256(merchantId-requestId-secret)-requestId
\n","key":"X-Auth","type":"text","value":"{{x_auth}}"}],"body":{"mode":"raw","raw":"{\r\n\t\"payment\": {\r\n\t\t\"orderId\": \"{{order_id}}\",\r\n\t\t\"action\": \"pay\",\r\n\t\t\"price\": \"1000.00\",\r\n\t\t\"merchantFee\": \"130.00\",\r\n\t\t\"destinationWallet\": \"{{account_id}}\"\r\n\t},\r\n \"customValues\": [\r\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\r\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\r\n\t],\r\n \"metadata\": {\r\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\r\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\r\n },\r\n\t\"urls\": {\r\n\t\t\"callback\": \"http://...\",\r\n\t\t\"return\": \"http://...\"\r\n\t},\r\n\t\"target\": {\r\n\t\t\"card\": \"{{card_id}}\"\r\n\t}\r\n}\r\n"},"url":"https://{{domain}}/v1/transactions","description":"Запрос выполняется синхронно с дополнительным асинхронным ответом.
\nОтвет (как синхронный, так и асинхронный) может содержать более широкий набор полей, чем в примере.
\nОдностадийная оплата предполагает, что денежные средства списываются с карты в рамках одного запроса. Мерчант может запросить списание с определенной карты, передав id карты, ранее полученной в callback-уведомлении. Клиент при этом не вводит данные карты, а использует уже сохраненную.
ВАЖНО!
\nВ примере ниже с карты плательщика будет списано 1000 рублей. Саб-мерчант получает 870 рублей.\nМаркетплейс получает 130 рублей в виде комиссии (комиссия учитывается внутри суммы к списанию), из которой 30 рублей будет списано как комиссия MandarinPay (согласно условиям договора).
\nТранзакция будет осуществлена в асинхронном режиме. В результате запроса вам синхронно придет id транзакции, и асинхронно придет callback-уведомление.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","transactions"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"8433e793-0f81-4132-9e6d-abec949bd5a5","name":"Оплата привязанной картой [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"payment\": {\r\n\t\t\"orderId\": \"123321\",\r\n\t\t\"action\": \"pay\",\r\n\t\t\"price\": \"1000.00\",\r\n\t\t\"merchantFee\": \"130.00\",\r\n\t\t\"destinationWallet\": \"d1387389-b6c7-4a80-81a4-3960ed96cfd0\"\r\n\t},\r\n \"customValues\": [\r\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\r\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\r\n\t],\r\n \"metadata\": {\r\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\r\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\r\n },\r\n\t\"urls\": {\r\n\t\t\"callback\": \"http://...\",\r\n\t\t\"return\": \"http://...\"\r\n\t},\r\n\t\"target\": {\r\n\t\t\"card\": \"6b14cf1f-10af-45d0-946f-096d5dc57b64\"\r\n\t}\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.mandarinpay.com/v1/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 13:48:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"205"},{"key":"Connection","value":"keep-alive"},{"key":"Via","value":"waitress"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"9ac3775a809442e58a5c4407be4e29df\"\n}"}],"_postman_id":"e907616e-4a67-412b-a877-088a4e912187"},{"name":"Двухстадийное пополнение с карты (Блокировка)","event":[{"listen":"test","script":{"id":"9de1fd8e-4b3e-4c4b-acde-64fec454c393","exec":["var jsonData = JSON.parse(responseBody);\r","pm.environment.set(\"transaction_id\", jsonData.id);"],"type":"text/javascript"}}],"id":"9315049f-854b-4d8a-b75e-04afbaf909ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"key":"X-Auth","type":"text","value":"{{x_auth}}","description":"merchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"{{order_id}}\",\n \"action\": \"preauth\",\n \"price\": \"1000.00\",\n \"orderActualTill\": \"{{order_actual_till}}\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n }\n}"},"url":"https://{{domain}}/v1/transactions","description":"Запрос выполняется синхронно с дополнительным асинхронным ответом.
\nОтвет (как синхронный, так и асинхронный) может содержать более широкий набор полей, чем в примере.
\nДвухстадийная схема работы предполагает первичную блокировку (preAuth) денежных средств на банковской карте, а затем ее полное или частичное подтверждение (confirmAuth).\nВ случае отсутствия операции подтверждения списания денежных средств сумма будет автоматически разблокирована через определенное время (от 7 до 30 дней).\nТакже возможна операция принудительной разблокировки ВСЕЙ заблокированной суммы (reversal).\nДля блокировки денежных средств с карты в рамках двухстадийной схемы оплаты необходимо создать транзакцию с типом preauth.\nОбязательный параметр price хранит значение суммы, которая будет предавторизована (заблокирована) с карты плательщика. В процессе блокировки клиент вводит данные карты.
Транзакция будет осуществлена в асинхронном режиме. В результате запроса вам синхронно придет id транзакции, и асинхронно придет callback-уведомление.
\nПолученные в синхронном ответе userWebLink используйте для работы с платежной страницей, а jsOperationId для работы через CustomPay.\nПосле того как придёт callback-уведомления об успехе предавторизации, полученный в нём Id транзакции можно использовать для полного или частичного списания (action = pay), а также разблокировки (action = reversal) денежных средств через REST API в качестве значения для target/transaction.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","transactions"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"112b4d55-9fed-421b-92b1-a0338c193d9b","name":"Оплата картой 2-стадийная: блокировка средств [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"123322\",\n \"action\": \"preauth\",\n \"price\": \"1000.00\",\n \"orderActualTill\": \"2019-06-14 12:34:56+00:00\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n }\n}"},"url":"https://api-sandbox.mandarinpay.com/v1/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 13:58:58 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"205"},{"key":"Connection","value":"keep-alive"},{"key":"Via","value":"waitress"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"cc2173b900ed4c5a8b42d23cb74f03cf\",\n \"userWebLink\": \"https://secure.stage.psp.io/Pay/Select?transaction=cc2173b900ed4c5a8b42d23cb74f03cf\",\n \"jsOperationId\": \"cc2173b900ed4c5a8b42d23cb74f03cf\"\n}"}],"_postman_id":"9315049f-854b-4d8a-b75e-04afbaf909ef"},{"name":"! Двухстадийное пополнение с привязанной карты (Блокировка)","id":"4d6ca3b5-7b12-4a3d-8068-19a7f6c1537a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"description":"merchantId-SHA256(merchantId-requestId-secret)-requestId
\n","key":"X-Auth","type":"text","value":"{{x_auth}}"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"{{order_id}}\",\n \"action\": \"preauth\",\n \"price\": \"1000.00\",\n \"orderActualTill\": \"{{order_actual_till}}\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n\t},\n\t\"target\": {\n\t\t\"card\": \"{{card_id}}\"\n\t}\n}"},"url":"https://{{domain}}/v1/transactions","description":"Запрос выполняется синхронно с дополнительным асинхронным ответом.
\nОтвет (как синхронный, так и асинхронный) может содержать более широкий набор полей, чем в примере.
\nВозможно использовать запрос блокировки, используя данные привязанной карты, и выполнять ее без участия клиента.
\nДля этого нужно обговорить эту возможность с вашим менеджером!
\nПосле окончания настройки, вы сможете передавать в запросе параметр target/card со значением {cardId}, которое получили после привязки карты.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","transactions"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"b559196d-d695-40f0-8953-6cffe82bd31b","name":"Оплата картой 2-стадийная: блокировка средств на привязанной карте [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"123322\",\n \"action\": \"preauth\",\n \"price\": \"1000.00\",\n \"orderActualTill\": \"2019-06-14 12:34:56+00:00\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n\t},\n\t\"target\": {\n\t\t\"card\": \"6b14cf1f-10af-45d0-946f-096d5dc57b64\"\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.mandarinpay.com/v1/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 02 Jul 2019 13:58:58 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"205"},{"key":"Connection","value":"keep-alive"},{"key":"Via","value":"waitress"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"cc2173b900ed4c5a8b42d23cb74f03cf\"\n}"}],"_postman_id":"4d6ca3b5-7b12-4a3d-8068-19a7f6c1537a"},{"name":"Двухстадийное пополнение с карты (Списание)","id":"4343530d-bb45-4592-82ad-a354db18579e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"{{x_auth}}","type":"text","description":"merchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"{{order_id}}\",\n \"action\": \"pay\",\n \"price\": \"900.00\",\n \"merchantFee\": \"130.00\",\n \"destinationWallet\": \"{{account_id}}\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n },\n \"target\": {\n \"transaction\": \"{{transaction_id}}\"\n }\n}"},"url":"https://{{domain}}/v1/transactions","description":"Запрос выполняется синхронно с дополнительным асинхронным ответом.
\nОтвет (как синхронный, так и асинхронный) может содержать более широкий набор полей, чем в примере.
\nДля полного или частичного списания используйте action = pay и полученный в уведомлении об успешной предавторизации id в качестве значения для target/transaction.\nЗначение price может быть любым в пределах значения предавторизованной суммы, переданной в поле price в изначальной транзакции preauth.\nПоле merchantFee хранит комиссию, которая будет зачислена маркетплейсу (не может быть больше значения price). Сумма, которая будет зачислена саб-мерчанту, равна разнице между price и merchantFee. \nОстаток будет возвращен на карту плательщика автоматически.
Активного участия клиента при этом не требуется. Транзакция будет осуществлена в асинхронном режиме. В результате запроса вам синхронно придет id транзакции, и асинхронно придет callback-уведомление.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","transactions"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"5d290d16-f34f-4835-862b-c72e37b0eda4","name":"Оплата картой 2-стадийная: списание средств [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"123323\",\n \"action\": \"pay\",\n \"price\": \"900.00\",\n \"merchantFee\": \"130.00\",\n \"destinationWallet\": \"d1387389-b6c7-4a80-81a4-3960ed96cfd0\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n },\n \"target\": {\n \"transaction\": \"43913ddc000c4d3990fddbd3980c1725\"\n }\n}"},"url":"https://api-sandbox.mandarinpay.com/v1/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 03 Jul 2019 10:12:06 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"106"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"9ac3775a809442e58a5c4407be4e29df\"\n}"}],"_postman_id":"4343530d-bb45-4592-82ad-a354db18579e"},{"name":"Двухстадийное пополнение с карты (Отмена блокировки)","id":"ce72d8f4-6a8c-40d0-9862-ca168468579e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"{{x_auth}}","type":"text","description":"merchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"{{order_id}}\",\n \"action\": \"reversal\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n },\n \"target\": {\n \"transaction\": \"{{transaction_id}}\"\n }\n}"},"url":"https://{{domain}}/v1/transactions","description":"Запрос выполняется синхронно с дополнительным асинхронным ответом.
\nОтвет (как синхронный, так и асинхронный) может содержать более широкий набор полей, чем в примере.
\nДля разблокировки всей предавторизованной суммы используйте action = reversal и полученный в уведомлении об успешной блокировке id в качестве значения для target/transaction.
Активного участия клиента при этом не требуется.\nОтмена производится для всей заблокированной суммы.
\nТранзакция будет осуществлена в асинхронном режиме. В результате запроса вам синхронно придет id транзакции отмены блокировки, и асинхронно придет callback-уведомление.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","transactions"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"4c089a83-6dfa-4fb3-ad33-50e759d80732","name":"Оплата картой 2-стадийная: отмена блокировки [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"123324\",\n \"action\": \"reversal\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n },\n \"target\": {\n \"transaction\": \"cc2173b900ed4c5a8b42d23cb74f03cf\"\n }\n}"},"url":"https://api-sandbox.mandarinpay.com/v1/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 03 Jul 2019 10:12:06 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"106"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"13a3775a809442e1265c4407be4e2973\"\n}"}],"_postman_id":"ce72d8f4-6a8c-40d0-9862-ca168468579e"}],"id":"1c1b1f0f-184d-4532-b1e1-5683ac749de3","description":"Одностадийное пополнение с карты предполагает, что денежные средства списываются в рамках одного запроса (action = pay).
При двухстадийном пополнении с карты, денежные средства списываются в рамках двух последовательных запросов: блокировка суммы (action = preauth) и последующее списание (action = pay) с автоматическим возвратом остатка заблокированных средств на карту.\nЕсли требуется вернуть на карту заблокированную сумму, то вместо списания выполняется разблокировка средств (action = reversal).
Все запросы отправляются на адрес:\nPOST https://{{domain}}/v1/transactions, где {{domain}} равен:
api-sandbox.mandarinpay.com - для тестовой среды (Stage);api.mandarinpay.com - для боевой среды (Prod)В синхроннном ответе вам придет id зарегистрированной транзакции, userWebLink (используется для работы с платежной страницей), jsOperationId (используется для работы через CustomPay).
По завершении транзакции вы получите асинхронный ответ (callback) со статусом и дополнительной детализацией.
\nКомиссия MandarinPay прописывается в договоре с маркетплейсом и не передается в запросах.\nMandarinPay списывает ее автоматически с внутреннего счета маркетплейса.
\nКомиссия маркетплейса именно для пополнения учитывается внутри суммы к списанию.
\nВ договоре с MandarinPay указано, что комиссия MandarinPay составляет 3% от суммы платежа (для операции пополнения аккаунта).
\nМаркетплейс передает запрос на пополнение, содержащий:
\nС карты плательщика будет списано 1000 рублей.
\nНа счет маркетплейса будет зачислено 130 рублей, и сразу списано 30 рублей (3% от 1000 руб.). В результате, баланс счета маркетплейса увеличится на 100 рублей.
\nНа счет саб-мерчанта будут зачислены оставшиеся 870 рублей.
\nПоскольку размер комиссии маркетплейса передает сам маркетплейс, то она может быть меньше комиссии MandarinPay или даже равной нулю. Маркетплейсы могут использовать такие параметры, проводя специальные акции.
\nКак в предыдущем примере, в договоре с MandarinPay указано, что комиссия MandarinPay составляет 3% от суммы платежа (для операции пополнения аккаунта).
\nМаркетплейс передает запрос на пополнение, содержащий:
\nС карты плательщика будет списано 1000 рублей.
\nНа счет маркетплейса будет зачислено 0 рублей, и сразу списано 30 рублей (3% от 1000 руб.). В результате, баланс счета маркетплейса уменьшится на 30 рублей. Мерчант должен следить, чтобы баланс счета оставался положительным, иначе операция не будет осуществлена.
\nНа счет саб-мерчанта будет зачислено 1000 рублей (столько же, сколько было списано с карты плательщика).
\nПеречень и описание возможных блоков и элементов запроса, а также обязательность их передачи приведены ниже:
\nБлок PAYMENT
\nДанный блок является ОБЯЗАТЕЛЬНЫМ
\nБлок CUSTOMERINFO
\nДанный блок является ОБЯЗАТЕЛЬНЫМ
\nБлок CUSTOMVALUES
\nДанный блок является НЕОБЯЗАТЕЛЬНЫМ. Позволяет передать любую дополнительную информацию вместе с платежом. Вы можете передать до 8 пар параметров.
\nБлок URLS
\nБлок является НЕОБЯЗАТЕЛЬНЫМ
\nДанный блок позволяет передать ссылки для отправки callback-уведомления и возврата пользователя с платежной страницы после оплаты.
\nБлок TARGET
\nБлок является НЕОБЯЗАТЕЛЬНЫМ
\nПри двухстадийном пополнении используется с запросами, где action = pay или action = reversal. \nПозволяет передать id транзакции, которая инициировала операцию.
При одностадийном пополнении используется с запросами, где action = pay. \nПозволяет передать id сохраненной карты, с которой нужно провести списание.
merchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"{{order_id}}\",\n \"action\": \"payout\",\n \"price\": \"1000.00\",\n \"merchantFee\": \"150.00\",\n \"sourceWallet\": \"{{account_id}}\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n },\n \"target\": {\n \"card\": \"{{card_id}}\"\n }\n}"},"url":"https://{{domain}}/v1/transactions","description":"Запрос выполняется синхронно с дополнительным асинхронным ответом.
\nОтвет (как синхронный, так и асинхронный) может содержать более широкий набор полей, чем в примере.
\nВАЖНО! \nВ примере ниже со счета саб-мерчанта будет списано 1150 рублей. На карту будет зачислено 1000 рублей.\nМаркетплейс получает 150 рублей в виде комиссии (комиссия учитывается сверху от суммы к списанию), из которой 50 рублей будет списано как комиссия MandarinPay (согласно условиям договора).
\nТранзакция будет осуществлена в асинхронном режиме. В результате запроса вам синхронно придет id транзакции, и асинхронно придет callback-уведомление.
Значение orderId должно быть уникальным в пределах успешных операций вывода средств. Если Вы не получили успешный callback и хотите повторно запросить ту же самую выплату, рекомендуем использовать тот же самый номер orderId. Это предотвратит дублирование выплаты, если первоначальная выплата была произведена, но успешный callback не дошел.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","transactions"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"3dc24611-dbd7-47e3-a93a-9e99585e9618","name":"Вывод средств на привязанную карту [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"123321\",\n \"action\": \"payout\",\n \"price\": \"1000.00\",\n \"merchantFee\": \"150.00\",\n \"sourceWallet\": \"d1387389-b6c7-4a80-81a4-3960ed96cfd0\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n },\n \"target\": {\n \"card\": \"0eb51e74-e704-4c36-b5cb-8f0227621518\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.mandarinpay.com/v1/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 03 Jul 2019 13:12:16 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"151"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"43913ddc000c4d3990fddbd3980c1725\"\r\n}\r\n"}],"_postman_id":"f6032164-648e-44b3-80dd-a4ebdeca4c88"},{"name":"Вывод средств по номеру карты (payout card number)","id":"33c0116d-9563-4476-b146-c2367537041f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"{{x_auth}}","type":"text","description":"merchantId-SHA256(merchantId-requestId-secret)-requestId
\n"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"{{order_id}}\",\n \"action\": \"payout\",\n \"price\": \"1000.00\",\n \"merchantFee\": \"150.00\",\n \"sourceWallet\": \"{{account_id}}\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n },\n \"target\": {\n \"knownCardNumber\": \"5559572059031262\"\n }\n}"},"url":"https://{{domain}}/v1/transactions","description":"Запрос выполняется синхронно с дополнительным асинхронным ответом.
\nОтвет (как синхронный, так и асинхронный) может содержать более широкий набор полей, чем в примере.
\nВАЖНО!
\nВ примере ниже со счета саб-мерчанта будет списано 1150 рублей. На карту будет зачислено 1000 рублей.\nМаркетплейс получает 150 рублей в виде комиссии (комиссия учитывается сверху от суммы к списанию), из которой 50 рублей будет списано как комиссия MandarinPay (согласно условиям договора).
\nТранзакция будет осуществлена в асинхронном режиме. В результате запроса вам синхронно придет id транзакции, и асинхронно придет callback-уведомление.
Значение orderId должно быть уникальным в пределах успешных операций вывода средств. Если Вы не получили успешный callback и хотите повторно запросить ту же самую выплату, рекомендуем использовать тот же самый номер orderId. Это предотвратит дублирование выплаты, если первоначальная выплата была произведена, но успешный callback не дошел.
Тело запроса:
\n","urlObject":{"protocol":"https","path":["v1","transactions"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"ecffd680-30f2-41ca-8caa-5252d93002d9","name":"Вывод средств по номеру карты [Stage]","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"X-Auth","value":"395-c930e6c208d93948adbb9a25f9207219ee37935659ffcb1e8efcf1561cb464cf-1562059278","type":"text"}],"body":{"mode":"raw","raw":"{\n \"payment\": {\n \"orderId\": \"123321\",\n \"action\": \"payout\",\n \"price\": \"1000.00\",\n \"merchantFee\": \"150.00\",\n \"sourceWallet\": \"d1387389-b6c7-4a80-81a4-3960ed96cfd0\"\n },\n \"customerInfo\": {\n \"email\": \"user@example.com\",\n \"phone\": \"+79001234567\"\n },\n \"customValues\": [\n\t\t{\"name\": \"parameter to save and show 0\", \"value\": \"0\"},\n\t\t{\"name\": \"parameter to save and show 1\", \"value\": \"1\"}\n\t],\n \"metadata\": {\n \"parameter_to_callback_and_not_to_show_0\": \"0\",\n \"parameter_to_callback_and_not_to_show_1\": \"1\"\n },\n \"urls\": {\n \"callback\": \"http://...\",\n \"return\": \"http://...\"\n },\n \"target\": {\n \"knownCardNumber\": \"5559572059031262\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.mandarinpay.com/v1/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 03 Jul 2019 14:55:07 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"151"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"43913ddc000c4d3990fddbd3980c1725\"\r\n}\r\n"}],"_postman_id":"33c0116d-9563-4476-b146-c2367537041f"}],"id":"6f6f601d-9557-46aa-95e0-09c4f63426b6","description":"Перевод на карту можно осуществить следующими способами:
\nВсе запросы отправляются на адрес:\nPOST https://{{domain}}/v1/transactions, где {{domain}} равен:
api-sandbox.mandarinpay.com - для тестовой среды (Stage);api.mandarinpay.com - для боевой среды (Prod)В синхроннном ответе вам придет id зарегистрированной транзакции.
По завершении транзакции вы получите асинхронный ответ (callback) со статусом и дополнительной детализацией.
\nКомиссия MandarinPay прописывается в договоре с маркетплейсом и не передается в запросах.\nMandarinPay списывает ее автоматически с внутреннего счета маркетплейса.
\nКомиссия маркетплейса именно для списания учитывается сверху от суммы к списанию.
\nВ договоре с MandarinPay указано, что комиссия MandarinPay составляет 2% + 30 рублей (для операции вывода на карту).
\nМаркетплейс передает запрос на вывод, содержащий:
\nСо счета саб-мерчанта будет списано 1150 рублей.
\nНа счет маркетплейса будет зачислено 150 рублей, и сразу списано 50 рублей (2% от 1000 руб. + 30 рублей). В результате, баланс счета маркетплейса увеличится на 100 рублей.
\nНа карту получателя будут зачислены запрошенные 1000 рублей.
\nПеречень и описание возможных блоков и элементов запроса, а также обязательность их передачи приведены ниже:
\nБлок PAYMENT
\nДанный блок является ОБЯЗАТЕЛЬНЫМ
\nБлок CUSTOMERINFO
\nДанный блок является ОБЯЗАТЕЛЬНЫМ при переводах на иностранные карты. Для переводов на карты российских банков НЕ ПОДДЕРЖИВАЕТСЯ.
\nБлок CUSTOMVALUES
\nДанный блок является НЕОБЯЗАТЕЛЬНЫМ. Позволяет передать любую дополнительную информацию вместе с платежом. Вы можете передать до 8 пар параметров.
\nБлок URLS
\nБлок является НЕОБЯЗАТЕЛЬНЫМ
\nДанный блок позволяет передать ссылки для отправки callback-уведомления и возврата пользователя с платежной страницы после оплаты.
\nБлок TARGET
\nБлок является НЕОБЯЗАТЕЛЬНЫМ
\nПозволяет передать указать карту, на которую производится выплата.\nЗапрос должен содержать только один параметр из данного блока.
\n","event":[{"listen":"prerequest","script":{"id":"b40c8d97-5f76-4e5e-8ba8-b8e46ac91238","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"98092f25-301f-4c9c-9873-4e7435c01f70","type":"text/javascript","exec":[""]}}],"_postman_id":"6f6f601d-9557-46aa-95e0-09c4f63426b6"}],"event":[{"listen":"prerequest","script":{"id":"772e8db1-58f7-421c-8d5c-87b414a92c0c","type":"text/javascript","exec":["var request_id = parseInt((new Date()).getTime() / 1000);","pm.environment.set(\"request_id\", request_id);","var sha256_string = pm.environment.get(\"merchant_id\") + \"-\" + request_id + \"-\" + pm.environment.get(\"secret\")","var x_auth = pm.environment.get(\"merchant_id\") + \"-\" + CryptoJS.SHA256(sha256_string) + \"-\" + request_id;","pm.environment.set(\"x_auth\", x_auth);","","pm.environment.set(\"order_id\", \"your_unique_order_id_\" + request_id);","var moment = require('moment');","pm.environment.set(\"order_actual_till\", moment(((new Date()).getTime() + 86400000)).format(\"YYYY-MM-DD HH:mm:ss\"));"]}},{"listen":"test","script":{"id":"23e80bab-f69e-4d0b-ae3a-fda89623869d","type":"text/javascript","exec":[""]}}]}