{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Жизненный цикл выплаты","description":"Статусы выплаты от pending до success: кто её исполняет, что происходит при отмене и как открыть спор по выплате.","siteUrl":"https://b2b-app.lumowallet.io","lang":"ru-RU","keywords":"Lumo B2B, платёжный API, крипто-платежи, USDT, TRC-20, СБП QR, виртуальные карты VISA, выплаты в рублях","image":"https://b2b-app.lumowallet.io/og-cover.png","jsonLd":{"@context":"https://schema.org","@type":"Organization","name":"Lumo B2B","url":"https://b2b-app.lumowallet.io","logo":"https://b2b-app.lumowallet.io/apple-touch-icon.png","description":"Крипто-платежи для бизнеса: приём по QR СБП, депозиты USDT, виртуальные VISA-карты и выплаты в рублях.","sameAs":["https://t.me/LumoB2B"]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"жизненный-цикл-выплаты","__idx":0},"children":["Жизненный цикл выплаты"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"pending ──▶ waiting_trader ──▶ in_progress ──▶ success\n                    │                 │\n                    └────────┬────────┘\n                             ▼\n                           fail ──▶ возврат средств на баланс\n"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Статус"},"children":["Статус"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Что значит"},"children":["Что значит"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Списано, заявка ещё не подтверждена сервисом выплат. Живёт секунды"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["waiting_trader"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["В очереди, ждём исполнителя. Отмена возможна только здесь"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in_progress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Исполнитель взял заявку"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Рубли отправлены получателю"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fail"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Не выполнена, средства возвращены на баланс"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Каждая смена статуса приезжает вебхуком ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payout.status_changed"]}," — см."," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/webhooks"},"children":["Webhooks"]},". Параллельно статус всегда можно спросить сами:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl 'https://b2b.lumowallet.io/payouts/{id}' -H 'X-API-Key: YOUR_API_KEY'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"возврат-средств","__idx":1},"children":["Возврат средств"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Провал заявки возвращает списанное на баланс автоматически и ровно один раз."," ","Признак — поле ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refundedAt"]},": пока оно заполнено, деньги у вас. Ориентируйтесь"," ","на него, а не на сам факт ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fail"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Возвращается вся списанная сумма (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargedUsdt"]},"), в USDT, по курсу заявки. Курс"," ","за это время мог измениться — вас это не касается, вернётся ровно столько,"," ","сколько списали."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"отмена","__idx":2},"children":["Отмена"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /payouts/{id}/cancel\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Возможна, только пока заявку не взял исполнитель, то есть в статусе"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["waiting_trader"]},". Заявка уходит в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fail"]}," с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failReason: cancelled_by_merchant"]},","," ","средства возвращаются сразу."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Если исполнитель уже взял заявку, придёт ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_NOT_CANCELABLE"]}," — дальше"," ","только спор."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"споры","__idx":3},"children":["Споры"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /payouts/{id}/dispute\nContent-Type: multipart/form-data\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Спор — про «деньги не дошли». Разбирательство ведёт сервис выплат: он хранит"," ","вложения, опрашивает исполнителя и выносит вердикт, а мы передаём обращение и"," ","показываем состояние."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Поле"},"children":["Поле"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Описание"},"children":["Описание"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["comment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Суть претензии, обязательно"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["files"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["До 3 файлов, каждый не больше 5 МБ"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST 'https://b2b.lumowallet.io/payouts/{id}/dispute' \\\n  -H 'X-API-Key: YOUR_API_KEY' \\\n  -F 'comment=Получатель не видит зачисление, прошло 40 минут' \\\n  -F 'files=@screenshot.png'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Состояние спора приезжает в карточке заявки:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"dispute\": {\n  \"id\": \"025127ce-5a76-46e8-89ef-8ccf422248fb\",\n  \"status\": \"open\",\n  \"resolution\": null,\n  \"comment\": \"Получатель не видит зачисление, прошло 40 минут\",\n  \"openedAt\": \"2026-08-26T11:34:11.596Z\",\n  \"resolvedAt\": null\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Когда спор решают в вашу пользу, заявка приходит в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fail"]}," с"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failReason: dispute_lost"]},", а ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resolution"]}," становится ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_won"]}," — средства"," ","возвращаются обычным путём. Решение в пользу исполнителя оставляет заявку в"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Когда спор открыть нельзя (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_DISPUTE_NOT_ALLOWED"]},"):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["заявку ещё никто не взял — её проще отменить и получить деньги сразу;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["заявка уже провалилась — средства и так вернулись;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["спор по этой заявке уже открыт."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"список-выплат","__idx":4},"children":["Список выплат"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /payouts?status=&search=&limit=&offset=\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}," ищет по вашему ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalId"]}," (в том числе по части) или по нашему ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," —"," ","целиком либо по первым символам."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{ \"payouts\": [ /* … */ ], \"total\": 42 }\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"редкий-случай-повторное-списание","__idx":5},"children":["Редкий случай: повторное списание"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Заявку может признать провалившейся, вернуть вам деньги, а потом подтвердить"," ","исполнение — например, если спор решили в пользу исполнителя после ложного"," ","таймаута. Тогда сумма списывается повторно, а вы получаете отдельное событие"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payout.recharged"]},": из поля ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," (снова ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]},") повторное списание не"," ","видно никак."]}]},"headings":[{"value":"Жизненный цикл выплаты","id":"жизненный-цикл-выплаты","depth":1},{"value":"Возврат средств","id":"возврат-средств","depth":2},{"value":"Отмена","id":"отмена","depth":2},{"value":"Споры","id":"споры","depth":2},{"value":"Список выплат","id":"список-выплат","depth":2},{"value":"Редкий случай: повторное списание","id":"редкий-случай-повторное-списание","depth":2}],"frontmatter":{"seo":{"description":"Статусы выплаты от pending до success: кто её исполняет, что происходит при отмене и как открыть спор по выплате.","title":"Жизненный цикл выплаты"}},"lastModified":"2026-09-02T11:33:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payouts/lifecycle","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}