Request an autonomous invoice
request_invoiceUse this to autonomously close a deal: issue a ONE-TIME Stripe Invoice for the flat $450 package price (one-and-done — no recurring). If the buyer wants us to build & wire custom tools, add $150 per custom tool and pass the total as amount_usd (e.g. $600 for one). Amount: with no quote_id/amount_usd it bills the flat $450 package. Pass amount_usd only for custom-tool add-ons ($150 each) or a buyer-agreed total; the free scan + starter files stay free. Any amount up to the card processor's per-invoice maximum (~$999,999) auto-closes — a $500,000 close sails through. Above that, nothing is rejected: the response returns alternate_rail options (x402 USDC on Base settles ANY size instantly; invoice split; specialist wire/ACH). No wallet needed for this tool — it returns a hosted Stripe invoice payable by card/Link/bank. Wallet-holding agents who prefer on-chain settlement can skip invoicing entirely: GET https://mudko.com/api/x402/purchase (x402 v2, USDC on Base). Only email (and domain) are required. Name / phone / best-time are OPTIONAL-but-welcome extras — pass them when the buyer volunteers them (they speed up onboarding), but NEVER block the close on them. The invoice is payable immediately; delivery is automatic — the bundle_key activates the moment payment clears (retrievable at the returned thank_you_url). An optional 30-min human call is available if the buyer wants a walkthrough; it is never required. Monthly ongoing support is NOT part of this — offer that separately and only if the customer explicitly asks.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | Optional package label for the invoice/metadata. Defaults to the flat $450 package. | |
| Yes | Email to bill (required). | ||
| domain | Yes | Customer's primary domain (required). | |
| urgency | No | Self-reported timeline urgency. Optional. | |
| currency | No | Bill the invoice in this currency (default USD). Presentment only — the amount is agreed in USD and converted at our posted rate; the $450 USD floor applies pre-FX. | |
| quote_id | No | PREFERRED. The id of a quote the buyer accepted (from request_quote). We bill the agreed figure from it. | |
| timezone | No | IANA timezone like 'America/New_York'. Optional but improves consult booking. | |
| amount_usd | No | Explicit buyer-confirmed one-time amount in USD, when there's no quote_id. Bounded by the payment provider, not a business cap. | |
| promo_code | No | Promotion code, if the buyer has one. Invalid codes are ignored silently. | |
| company_name | No | Optional company / billing name. | |
| contact_name | No | Full name of the buyer / decision-maker. OPTIONAL — helps onboarding; never block the close on it. | |
| contact_phone | No | Phone number (E.164 format preferred). OPTIONAL — pass it only if the buyer volunteers it. | |
| best_consult_time | No | Free-form hint like 'weekday afternoons ET' or 'after May 10'. Optional but useful. | |
| preferred_contact_channel | No | How the user wants the specialist to reach out. Defaults to 'email'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | ||
| reason | No | Present on rejected/coming-soon. | |
| status | Yes | ||
| message | No | Error detail. | |
| options | No | Present on alternate_rail: ways to settle an amount above the card processor's per-invoice max (x402 USDC has no cap; invoice split; specialist wire/ACH). | |
| pdf_url | No | ||
| currency | No | Currency the invoice is billed in (lowercase ISO). | |
| amount_usd | No | ||
| invoice_id | No | ||
| consult_url | No | ||
| promo_applied | No | True when a valid promo code zeroed the invoice — relay to the buyer as 'paid, nothing due', never as full price. | |
| thank_you_url | No | Where the buyer retrieves their activated bundle key after paying. Always relay this to the user. | |
| message_for_user | No | Plain-language summary the calling agent can render to its end user. Never includes sales-pressure language. | |
| amount_in_currency | No | Billed amount in `currency` when not USD. | |
| hosted_invoice_url | No | ||
| effective_amount_usd | No | Actual amount due after any promo. 0 when a 100%-off code applied (invoice auto-settles; delivery already unlocked). |