{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","description":"**Для интеграции с платёжной системой запросите логин и пароль для тестового сервера**\n\n**Войдите в панель управления (админка), на странице настройки находится ваш апи ключ.**\n\n**Запросите ip платёжной системы для добавления в ваш вайтлист.**\n\n**Для отладки рекомендуем пользоваться данной коллекцией постман.**\n\n**Сваггер pay-guru.io/api/swagger**\n\n**На тестовом сервере для вас создана полноценная тестовая среда, ничем не отличающаяся от прод сервера.**\n\n**В разделе Приём, вы видите все ваши сделки на приём, в разделе Выплаты, ваши сделки на выплату. В Спорах, созданные вами в телеграм боте или по апи споры**\n\n**На странице сделки вы можете изменить её статус, выполнить или отменить, и изменить её сумму (приём)**\n\nНа странице сделки есть кнопка **Дебаг, которая открывает страницу, со списоком всех запросов, ответов, колбеков данной сделки.**\n\n**В админке вы можете скачать список сделок с их текущими состояниями, и различные отчёты в xlsx.**\n\n**Общее:**\n\n**Сделка - сделка на приём или выплату, если нет уточнения**\n\n**Статус сделок: created/success/cancelled**\n\n**При изменении статуса сделки или изменении суммы сделки вы получаете колбек.**\n\n**БАНКИ.**\n\nСделайте маппинг нужных вам банков. Актуальный список банков находится по адресу /api/external/banks/items\n\n**СДЕЛКИ НА ПРИЁМ. Вторичный трафик.**\n\n**Вторичный трафик обязательно должен сопровождаться достоверными и уникальными идентификаторами ваших пользователей. Далее id пользователя, в теле запроса передаётся в user.id. Эти id нужны только для того чтобы различать ваших пользователей. Вы должны передать id пользователя, если у вас есть возможность.**\n\n**Как сделать user.id для запроса**\n\n**user.id пользователя это строка. user.id не может меняться. user.id может быть зашифрован. Всем будет удобнее, если в качестве user.id будет использован номер вашего пользователя “123456789”. В случае, если у вас нет номера пользователя, можете запросить у мерчанта и использовать другие уникальные, или хотя бы близкие к уникальности данные: емейл, телефон, ФИО, их компиляцию или шифрованную компиляцию.**\n\n**Создание сделок для пользователя**\n\n**Покупатель не может одновременно производить множество платежей. Соответственно, для каждого пользователя (user.id) не может быть более одной сделки в состоянии created. Это значит, что перед созданием новой сделки, текущая открытая сделка данного пользователя должна быть отменена, если она у него имеется. Вы можете отменить открытую сделку методом cancel или эта сделка будет отменена автоматически при запросе новой сделки.**\n\n**СДЕЛКИ НА ПРИЁМ. Первичный трафик.**\n\n**Если у вас нет id пользователя, и нет данных для создании скомпилированного id пользователя, то вы можете создать сделку без user.id. При запросе сделки без id пользователя, считается, что она поступила от уникального пользователя, это позволяет вам, и пользователю, иметь множество одновременно выполняющихся идентичных сделок. Запросы на создание сделки без user.id не будут отклонены по причине наличия сделки на данную сумму. Но если пользователь создаёт одновременно множество сделок, тем более на одинаковую сумму, то при п2п обработке это может привести к отклонению запроса по причине недостатка свободных реквизитов.**\n\n**Возможные изменения статуса сделок:**\n\n**ПС отменяет сделку в created**\n\n**Мерчант отменяет сделку по апи в created**\n\n**ПС выполняет сделку в created и в cancelled**\n\n**ПС выполняет сделку при принятии диспута в cancelled (приём)**\n\n**ПС отменяет сделку при принятии диспута в success (выплата)**\n\n**Изменение суммы сделки**\n\n**По запросу мерчанта, а также в процессе обработки спора, ПС может изменить сумму сделки.**\n\n**При изменении суммы сделки отправляется колбек**\n\n**Каждое изменение суммы фиксируется и возвращается при запросе статуса сделки в виде массива:**\n\n``` json\n\"amountChangeHistory\": [\n{\n    \"oldAmount\": 2938,\n    \"newAmount\": 2948,\n    \"newAmountUSDT\": 30.88,\n    \"newFee\": 12.36,\n    \"created\": \"2024-10-01T06:01:23.023Z\",\n    \"source\": 0\n}\n]\n\n ```\n\n**Сумма сделки может изменится в любом состоянии сделки created/success/cancelled**\n\n**Сумма сделки может меняться многократно.**\n\n**Параметры, которые меняются при изменении суммы сделки, и отражают текущее состояние: amount, amountUSDT, fee. Курс остаётся прежним.**\n\n**ЗАГОЛОВКИ**\n\nContent-Type: application/json\n\nAuthorization: **апи ключ**","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"8847455","team":6493011,"collectionId":"6ab90f4a-d543-4554-afe4-32e5d71d5969","publishedId":"2sAY4vg2Vt","public":true,"publicUrl":"https://api.pay-guru.io","privateUrl":"https://go.postman.co/documentation/8847455-6ab90f4a-d543-4554-afe4-32e5d71d5969","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":"https://content.pstmn.io/13ec1204-4548-4fb6-ab2f-f71854a630c2/VW50aXRsZWQucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/4dfa0569-00e5-414d-861d-0bb9ec66429f/VW50aXRsZWQucG5n","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.11.6","publishDate":"2025-03-24T05:53:43.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/4dfa0569-00e5-414d-861d-0bb9ec66429f/VW50aXRsZWQucG5n","logoDark":"https://content.pstmn.io/13ec1204-4548-4fb6-ab2f-f71854a630c2/VW50aXRsZWQucG5n"}},"statusCode":200},"environments":[],"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/35f7aa423cb0bf3ac8b239036d5cb1b500c1dd69e71a6d6a9611b7433010a6d7","favicon":"https://pay-guru.io/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"}],"canonicalUrl":"https://api.pay-guru.io/view/metadata/2sAY4vg2Vt"}