{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Webhooks по картам","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":"webhooks-по-картам","__idx":0},"children":["Webhooks по картам"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lumo отправляет следующие события на ваш ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookUrl"]}," в дополнение к"," ","событиям ордеров (см. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/webhooks"},"children":["Webhooks"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Все события подписаны одним ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookSecret"]}," компании, заголовок"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Lumo-Signature"]}," (HMAC-SHA256 от JSON-тела)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"события","__idx":1},"children":["События"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cardassigned","__idx":2},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.assigned"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Карта выпущена — приходит после асинхронного выпуска (когда исходный"," ","вызов ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cards/request"]}," вернул ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status: pending"]},")."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"event\": \"card.assigned\",\n  \"data\": {\n    \"cardId\": \"8c7f1823-...\",\n    \"requestId\": \"2077f4ef-...\",\n    \"maskedPan\": \"4466 ** ** 1234\",\n    \"expiry\": \"03/29\",\n    \"assignedAt\": \"2026-04-23T12:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cardotp_received","__idx":3},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.otp_received"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Получен 3DS-код из почты эквайера. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/cards/otp-3ds"},"children":["3DS OTP"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"event\": \"card.otp_received\",\n  \"data\": {\n    \"cardId\": \"8c7f1823-...\",\n    \"code\": \"582130\",\n    \"receivedAt\": \"2026-04-23T12:00:10Z\",\n    \"expiresAt\": \"2026-04-23T12:02:10Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cardtransactioncreated","__idx":4},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.transaction.created"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Новая транзакция по карте (purchase / refund / ...). Шейп — тот же, что"," ","у ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /cards/:id/transactions"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cardclosed","__idx":5},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.closed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Карта закрыта (см. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/cards/close-card"},"children":["Закрытие карты"]},"). Остаток за"," ","вычетом комиссии за закрытие возвращён на баланс компании."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"event\": \"card.closed\",\n  \"data\": {\n    \"cardId\": \"8c7f1823-...\",\n    \"closingBalance\": 24.5,\n    \"feeUsdt\": 1,\n    \"refundUsdt\": 23.5\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cardrechargesucceeded","__idx":6},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.recharge.succeeded"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Пополнение успешно завершилось."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"event\": \"card.recharge.succeeded\",\n  \"data\": {\n    \"rechargeId\": \"7f2b12a4-...\",\n    \"cardId\": \"8c7f1823-...\",\n    \"targetAmountUsd\": 50,\n    \"totalDebitUsdt\": 51.96\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cardrechargefailed","__idx":7},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.recharge.failed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Отклонено эквайером. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalDebitUsdt"]}," автоматически возвращён на баланс."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"event\": \"card.recharge.failed\",\n  \"data\": {\n    \"rechargeId\": \"7f2b12a4-...\",\n    \"cardId\": \"8c7f1823-...\",\n    \"failureReason\": \"Insufficient issuer funds\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cardrechargerefunded","__idx":8},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.recharge.refunded"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Успешное пополнение было позже возвращено (например, отменено"," ","эквайером). Средства вернулись на баланс."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cardrechargein_progress_manual","__idx":9},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.recharge.in_progress_manual"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Пополнение зависло — требуется ручное вмешательство нашей стороны."," ","Средства пока списаны. Связывайтесь с support с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rechargeId"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"гарантии-доставки","__idx":10},"children":["Гарантии доставки"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At-least-once: одно событие может прийти несколько раз."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Используйте ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.cardId"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.rechargeId"]}," как idempotency-ключ на"," ","своей стороне."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Порядок не гарантируется: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.recharge.succeeded"]}," может прийти"," ","раньше соответствующего ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.transaction.created"]},", если эквайер быстрее"," ","подтвердил пополнение, чем обновил историю."]}]}]},"headings":[{"value":"Webhooks по картам","id":"webhooks-по-картам","depth":1},{"value":"События","id":"события","depth":2},{"value":"card.assigned","id":"cardassigned","depth":3},{"value":"card.otp_received","id":"cardotp_received","depth":3},{"value":"card.transaction.created","id":"cardtransactioncreated","depth":3},{"value":"card.closed","id":"cardclosed","depth":3},{"value":"card.recharge.succeeded","id":"cardrechargesucceeded","depth":3},{"value":"card.recharge.failed","id":"cardrechargefailed","depth":3},{"value":"card.recharge.refunded","id":"cardrechargerefunded","depth":3},{"value":"card.recharge.in_progress_manual","id":"cardrechargein_progress_manual","depth":3},{"value":"Гарантии доставки","id":"гарантии-доставки","depth":2}],"frontmatter":{"seo":{"title":"Webhooks по картам"}},"lastModified":"2026-07-04T23:14:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/cards/webhooks","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}