{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Пополнение карты","description":"Крипто-платежи для бизнеса. Принимайте USDT, платите через СБП QR. AML-проверки включены.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"пополнение-карты","__idx":0},"children":["Пополнение карты"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Пополнение — двухфазное: сначала quote (расчёт стоимости), потом execute."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-запросить-quote","__idx":1},"children":["1. Запросить quote"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /cards/recharge/quote\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"параметры","__idx":2},"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":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["uuid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID карты из ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /cards"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["targetAmount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Сумма, которая должна оказаться на карте (USD)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"пример","__idx":3},"children":["Пример"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST 'https://b2b.lumowallet.io/cards/recharge/quote' \\\n  -H 'X-API-Key: YOUR_API_KEY' \\\n  -H 'Content-Type: application/json' \\\n  -d '{ \"cardId\": \"8c7f1823-...\", \"targetAmount\": 50 }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ответ","__idx":4},"children":["Ответ"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"cardId\": \"8c7f1823-...\",\n  \"targetAmount\": 50,\n  \"processorFeeBps\": 300,\n  \"processorGrossAmount\": 51.55,\n  \"ourFeeBps\": 80,\n  \"ourFee\": 0.41,\n  \"userCharge\": 51.55,\n  \"currency\": \"USDT\",\n  \"commissionUsdt\": 0.41,\n  \"totalDebitUsdt\": 51.96\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalDebitUsdt"]}," — сколько будет списано с баланса компании."," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userCharge"]}," — брутто-сумма (включает комиссию эквайера), которая попадёт"," ","на карту после списания комиссии эквайера — т.е. ровно ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["targetAmount"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quote не блокирует средства и живёт только в момент запроса."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-выполнить-пополнение","__idx":5},"children":["2. Выполнить пополнение"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /cards/recharge\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Заголовок ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["обязателен"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"пример-1","__idx":6},"children":["Пример"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST 'https://b2b.lumowallet.io/cards/recharge' \\\n  -H 'X-API-Key: YOUR_API_KEY' \\\n  -H 'Idempotency-Key: 9f0dcd94-...' \\\n  -H 'Content-Type: application/json' \\\n  -d '{ \"cardId\": \"8c7f1823-...\", \"targetAmount\": 50 }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ответ-сразу","__idx":7},"children":["Ответ (сразу)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"7f2b12a4-...\",\n  \"cardId\": \"8c7f1823-...\",\n  \"targetAmountUsd\": 50,\n  \"userChargeUsdt\": 51.55,\n  \"commissionUsdt\": 0.41,\n  \"status\": \"pending\",\n  \"failureReason\": null,\n  \"createdAt\": \"2026-04-23T12:00:00Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Финальный статус приходит webhook'ом ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.recharge.*"]}," или обновляется"," ","в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /cards/recharges"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"статусы-recharge","__idx":8},"children":["Статусы recharge"]},{"$$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":"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":"td","attributes":{},"children":["Списано при запросе"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["succeeded"]}]},{"$$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":["failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Отклонено эквайером"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Возврат"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalDebitUsdt"]}," на баланс"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refunded"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Возврат после успеха"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Возврат"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalDebitUsdt"]}," на баланс"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in_progress_manual"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Зависло — ручной разбор"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Списано, разморозка вручную"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ошибки-при-execute","__idx":9},"children":["Ошибки при execute"]},{"$$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":"HTTP"},"children":["HTTP"]},{"$$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":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INSUFFICIENT_FUNDS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Не хватает ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availableBalance"]}," на ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalDebitUsdt"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CARD_RETIRED"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CARD_FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Карта не принимает пополнения"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Отсутствует ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Карта ещё не активирована эквайером"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Если вызов эквайера упал — мы ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["автоматически возвращаем"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalDebitUsdt"]}," на баланс и пробрасываем ошибку. Ретраить можно сразу"," ","с тем же ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"история-пополнений","__idx":10},"children":["История пополнений"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl 'https://b2b.lumowallet.io/cards/recharges?limit=50&before=2026-04-23T00:00:00Z' \\\n  -H 'X-API-Key: YOUR_API_KEY'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Возвращает массив ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CardRecharge[]"]}," по всем картам компании. Cursor-"," ","пагинация через ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["before"]}," (ISO-дата). Для фильтрации по одной карте —"," ","фильтруйте на своей стороне по ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardId"]},"."]}]},"headings":[{"value":"Пополнение карты","id":"пополнение-карты","depth":1},{"value":"1. Запросить quote","id":"1-запросить-quote","depth":2},{"value":"Параметры","id":"параметры","depth":3},{"value":"Пример","id":"пример","depth":3},{"value":"Ответ","id":"ответ","depth":3},{"value":"2. Выполнить пополнение","id":"2-выполнить-пополнение","depth":2},{"value":"Пример","id":"пример-1","depth":3},{"value":"Ответ (сразу)","id":"ответ-сразу","depth":3},{"value":"Статусы recharge","id":"статусы-recharge","depth":2},{"value":"Ошибки при execute","id":"ошибки-при-execute","depth":2},{"value":"История пополнений","id":"история-пополнений","depth":2}],"frontmatter":{"seo":{"title":"Пополнение карты"}},"lastModified":"2026-04-24T02:13:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/cards/recharge","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}