{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"7e091807-e555-4975-8b18-ec29a85b89f2","name":"API V2","description":"## Как начать интеграцию?\n\n1. Для начала интеграции свяжитесь с нашим менеджером, который предоставит вам доступ к вашему личному кабинету в нашей системе, а также выдаст API ключ и активирует ваш мерчант. **Личный кабинет находится по ссылке:** [<b>https://panel.majorpay.pro</b>](https://panel.majorpay.pro)\n    \n2. Сделайте форк (копию) текущего API в свой аккаунт Postman, чтобы тестировать API и вносить изменения.\n    \n3. В своем форке (справа сверху) выберите среду \"**Production\"** и укажите ваши **\"api_key\"** и **\"shop_id\"**\n    \n\nТеперь вы можете делать запросы сразу из Postman, а также генерировать код для вставки с уже заполненными данными.\n\n## Частозадаваемые вопросы\n\nВ этом блоке мы собрали самые частозадаваемые вопросы при работе с нашим проектом. Внимательно ознакомьтесь с ними, чтобы иметь более четкое представление о нашем подходе.\n\n#### **В какой валюте хранится баланс?**\n\n> Ваш баланс всегда хранится в USDT. Любой поступающий платеж автоматически конвертируется из валюты пополнения (например рубли) в USDT, а вывод наоборот - из USDT в валюту выбранного платежного метода. Это является распространенной практикой и сделано для устранения возможных потерь и удобства наших работников. \n  \n\n#### **Есть ли разделение на выплатной баланс?**\n\n> Нет. Все деньги, которые поступили от платежей, сразу же доступны для выплат и сеттлов. \n  \n\n#### **Как происходят сеттлы?**\n\n> Сеттл (от англ. Settlement) - это рассчет между вашим мерчантом и нашей кассой. В отличии от массовых выплат, сеттлы проходят 1-2 раза в день крупными суммами.  \nВсе сеттлы происходят в криптовалюте **Tether USDT TRC-20.**  \nДля создания сеттла перейдите в ваш Личный кабинет -> Выплаты -> Создать выплату. Выберите из выпадающего списка Tether TRC-20, укажите сумму и кошелек, затем нажмите **Создать**.  \nПосле создания выплаты уведомите нас в нашем фин. канале Telegram и наша поддержка максимально быстро одобрит транзакцию. Срок проведения сеттла: от 1 минут до 1 часа в любое время суток (в зависимость от загрузки нашей поддержки). \n  \n\n#### **Как работать, если у меня несколько проектов?**\n\n> Баланс аккаунта един для всех мерчантов. Поэтому, есть два способа работы:  \n1\\. Если вам не нужно разделение баланса по мерчантам, вы можете добавить несколько мерчантов на один аккаунт. Выплатной баланс для них будет общим.  \n2\\. Если вам нужно разделение баланса по мерчантам, тогда необходимо запросить у нашего менеджера отдельный аккаунт под каждый мерчант. У аккаунтов будут уникальные данные для входа и уникальные ключи доступа к API. \n  \n\n#### Как рассматриваются споры от пользователей?\n\n> При отсутвии зачисления по платежу из-за технических причин или из-за ошибки пользователя ваша поддержка создает тикет в Личном кабинете, прикрепляя чек перевода от пользователя. Наша поддержка рассматривает спор от 1 минуты до 24 часов, в зависимости от сложности случая. Любой кейс мы стараемся обработать как можно быстрее, чтобы пользователь получил деньги на свой баланс максимально оперативно. \n  \n\n# Краткий план для интеграции платежей:\n\n1. Выбор **суммы**. Возможно предложение сумм через `POST /suggest`\n    \n2. **Создание** платежа через `POST /order`\n    \n3. Получение **информации** о платежей через `GET /order/:id` и отображение реквизитов пользователю\n    \n4. **Подтверждение** перевода пользователем с помощью `POST /confirm/:id`\n    \n5. **Загрузка чека** перевода пользователем через `POST /upload/:id`\n    \n6. **Заморозка** платежа в случае проблемы пользователем или поддержкой через `POST /freeze/:id`\n    \n7. **Отмена платежа** пользователем с указанием в случае нерабочих реквизитов или ошибки через `POST /cancel/:id`\n    \n\n# Авторизация запросов\n\nДля авторизации ваших запросов необходимо передавать заголовок `x-api-key` с API ключом, полученным в панели или от нашего менеджера.\n\nЗапросы с HTTP кодом **200** являются **успешными**.\n\nЗапросы с HTTP кодом **4XX-5XX** являются **неуспешными**.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"48395555","team":10129533,"collectionId":"7e091807-e555-4975-8b18-ec29a85b89f2","publishedId":"2sB3QKsAEr","public":true,"publicUrl":"https://developer.majorpay.pro","privateUrl":"https://go.postman.co/documentation/48395555-7e091807-e555-4975-8b18-ec29a85b89f2","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.0","publishDate":"2025-10-12T11:25:07.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"Production","id":"cf9e8367-b86a-4497-8dba-e8045d7b6bbb","owner":"48395555","values":[{"key":"api_key","value":"","enabled":true,"type":"default"},{"key":"shop_id","value":"","enabled":true,"type":"default"},{"key":"base_url","value":"","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/ef28ab49d2c39ce86ff58b3b31ea1baeb5b68a916a37186e7598150f87fb8bcc","favicon":"https://majorpay.pro/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Production","value":"48395555-cf9e8367-b86a-4497-8dba-e8045d7b6bbb"}],"canonicalUrl":"https://developer.majorpay.pro/view/metadata/2sB3QKsAEr"}