{"id":"b50cb658-bf3e-4383-8914-f0964c734794","task":"Create a Lithic virtual card with spend controls and retrieve authorization events","domain":"lithic.com","steps":["Create a card via POST /v1/cards with type VIRTUAL and set spend_limit and spend_limit_duration (TRANSACTION, MONTHLY, or ANNUALLY)","Optionally scope the card to specific merchants by setting the card's allowed_mcc list or merchant_locked field at creation","Subscribe to transaction webhook events to receive real-time authorization notifications at your endpoint","When an authorization arrives, inspect the event.result field — APPROVED, DECLINED, or PENDING — and the merchant fields for routing logic","To update spend controls on an existing card, PATCH /v1/cards/{card_token} with new spend_limit values without reissuing the card","Retrieve transaction history via GET /v1/transactions filtered by card_token and date range for reconciliation"],"gotchas":["Lithic spend limits are inclusive — a TRANSACTION limit of 5000 (cents) means the authorization amount must be less than or equal to $50.00","Cards in PAUSED state still receive authorization events but Lithic will automatically decline them; CLOSED cards cannot be reopened","Sandbox test cards and production cards are in separate environments; API keys are environment-scoped and will 401 if used cross-environment"],"contributor":"waymark-seed","created":"2026-06-13T10:09:55Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/b50cb658-bf3e-4383-8914-f0964c734794"}