{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Создание выплаты","description":"Создание выплаты в рублях через POST /payouts: реквизиты получателя (карта или СБП по телефону), расчёт и списание USDT.","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":"POST /payouts\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Списывает USDT с баланса компании и передаёт заявку исполнителю."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"параметры","__idx":1},"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":"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":["amountRub"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["да"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Сумма в рублях — ровно столько получит получатель"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requisiteType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card"]}," | ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["да"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Куда платим"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requisite"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["да"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Номер карты (16–19 цифр) или телефона (10–15 цифр)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bankId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["для ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID банка из ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /payouts/banks"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientFirstName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["нет"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Имя получателя"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientLastName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["нет"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Фамилия получателя"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["нет"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ваш идентификатор выплаты"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Формат реквизита произвольный — разделители, скобки и пробелы мы вырежем сами."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"почему-банк--это-id-а-не-строка","__idx":2},"children":["Почему банк — это id, а не строка"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Название банка уходит исполнителю, и он ищет его у себя. Произвольный текст"," ","вроде «банк карты» он не найдёт, и заявка вернётся отказом уже после списания."," ","Поэтому банк принимается только идентификатором из справочника."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Для выплаты ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["на карту"]}," банк не нужен: эмитент однозначно определяется номером,"," ","исполнитель видит его в своём приложении. Для перевода ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["по телефону"]}," банк"," ","обязателен — к одному номеру привязано несколько банков, и без выбора непонятно,"," ","куда доставлять."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"фио-получателя","__idx":3},"children":["ФИО получателя"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Необязательны — деньги идут по номеру, а не по имени. Смысл в сверке на стороне"," ","исполнителя: приложение банка покажет ему имя получателя, и разойтись оно может"," ","только если в реквизите опечатка. Это единственный шанс поймать ошибку до того,"," ","как деньги уйдут чужому человеку."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"idempotency-key","__idx":4},"children":["Idempotency-Key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Передавайте всегда."]}," Ретрай с тем же ключом вернёт ту же заявку, а не"," ","выплатит второй раз. Уникальность ключа — в пределах вашей компании."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Без заголовка повторный запрос — это вторая выплата. Это не баг: не получив"," ","ключа, мы не можем отличить ретрай от намеренной второй отправки на тот же"," ","номер."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"пример","__idx":5},"children":["Пример"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST 'https://b2b.lumowallet.io/payouts' \\\n  -H 'X-API-Key: YOUR_API_KEY' \\\n  -H 'Idempotency-Key: 9f1c8d2e-4b7a-4c11-9f0e-2b8a1d5c3e77' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"amountRub\": 12000,\n    \"requisiteType\": \"phone\",\n    \"requisite\": \"+79000000000\",\n    \"bankId\": \"bank100000000111\",\n    \"recipientFirstName\": \"Иван\",\n    \"recipientLastName\": \"Иванов\",\n    \"externalId\": \"payout-12345\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"0d6c0d28-02e3-4366-bab8-3347f7f4f799\",\n  \"externalId\": \"payout-12345\",\n  \"status\": \"waiting_trader\",\n  \"amountRub\": 12000,\n  \"chargedUsdt\": 147.71,\n  \"rate\": 81.24,\n  \"requisiteType\": \"phone\",\n  \"requisite\": \"+79000000000\",\n  \"bankId\": \"bank100000000111\",\n  \"bank\": \"Сбербанк\",\n  \"recipientFirstName\": \"Иван\",\n  \"recipientLastName\": \"Иванов\",\n  \"failReason\": null,\n  \"comment\": null,\n  \"refundedAt\": null,\n  \"dispute\": null,\n  \"takenAt\": null,\n  \"completedAt\": null,\n  \"createdAt\": \"2026-08-25T13:28:26.887Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargedUsdt"]}," — сколько списано с баланса. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank"]}," — название на момент создания"," ","заявки: справочник могут переименовать, а в закрытой заявке должно остаться то,"," ","что видел исполнитель."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"предварительный-расчёт","__idx":6},"children":["Предварительный расчёт"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /payouts/quote\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Считает сумму списания без создания заявки и без блокировки средств."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST 'https://b2b.lumowallet.io/payouts/quote' \\\n  -H 'X-API-Key: YOUR_API_KEY' \\\n  -H 'Content-Type: application/json' \\\n  -d '{ \"amountRub\": 12000 }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{ \"amountRub\": 12000, \"rate\": 81.24, \"amountUsdt\": 147.71 }\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Курс здесь и в созданной заявке может отличаться на движение рынка между"," ","запросами: фиксируется он в момент создания."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"справочник-банков","__idx":7},"children":["Справочник банков"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /payouts/banks\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Снимок списка участников СБП."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"id\": \"bank100000000111\",\n    \"name\": \"Сбербанк\",\n    \"logoUrl\": \"https://api.lumowallet.io/bank-logos/bank100000000111.webp\",\n    \"popular\": true\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["popular"]}," — короткий список банков, в которые выводят чаще всего; его обычно"," ","показывают сразу, остальные достают поиском. Обрезать справочник до популярных"," ","не стоит: клиент регионального банка иначе не получит деньги."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ошибки","__idx":8},"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":"errorCode"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]}]},{"$$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":["PAYOUTS_NOT_ENABLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Выплаты не подключены вашей компании"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AMOUNT_BELOW_MIN"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AMOUNT_ABOVE_MAX"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Сумма вне лимитов, границы в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_REQUISITE_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Неверная длина номера карты или телефона"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_BANK_REQUIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Перевод по телефону без ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bankId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_BANK_UNKNOWN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Банка нет в справочнике"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INSUFFICIENT_BALANCE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Не хватает свободного баланса, доступное в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_ACTIVE_LIMIT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Превышен лимит одновременных заявок"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_REQUISITE_COOLDOWN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["На этот реквизит недавно платили, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.availableAt"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_OUTSIDE_WORKING_HOURS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Вне часов приёма"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_SERVICE_REJECTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Сервис выплат не принял заявку — ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["средства уже вернулись"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_SERVICE_UNAVAILABLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Сервис не ответил — ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["заявка принята, средства не возвращены"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Последние две различайте внимательно. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_SERVICE_REJECTED"]}," означает, что"," ","заявки не существует и деньги на балансе. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT_SERVICE_UNAVAILABLE"]}," означает"," ","неизвестность: заявка могла создаться, поэтому мы не возвращаем деньги вслепую —"," ","её судьба выяснится автоматически, а статус придёт вебхуком. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Не повторяйте"," ","такой запрос с новым ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}]}," — так вы создадите вторую выплату."," ","Повтор с тем же ключом безопасен и вернёт ту же заявку."]}]},"headings":[{"value":"Создание выплаты","id":"создание-выплаты","depth":1},{"value":"Параметры","id":"параметры","depth":2},{"value":"Почему банк — это id, а не строка","id":"почему-банк--это-id-а-не-строка","depth":3},{"value":"ФИО получателя","id":"фио-получателя","depth":3},{"value":"Idempotency-Key","id":"idempotency-key","depth":2},{"value":"Пример","id":"пример","depth":2},{"value":"Предварительный расчёт","id":"предварительный-расчёт","depth":2},{"value":"Справочник банков","id":"справочник-банков","depth":2},{"value":"Ошибки","id":"ошибки","depth":2}],"frontmatter":{"seo":{"description":"Создание выплаты в рублях через POST /payouts: реквизиты получателя (карта или СБП по телефону), расчёт и списание USDT.","title":"Создание выплаты"}},"lastModified":"2026-09-02T11:33:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payouts/create-payout","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}