Send a Square catering invoice with a deposit-then-balance payment schedule using the Invoices API
domain: developer.squareup.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Create the underlying Order via the Orders API with the full catering order total
Create an Invoice referencing the order_id, with payment_requests containing one DEPOSIT request (fixed amount or percentage_requested) and one BALANCE request
Publish the invoice so Square emails the payment link and collects the deposit first
Monitor invoice status via retrieve/search for when the deposit is paid, which schedules the balance request
Confirm the BALANCE request auto-collects, or send a reminder, as the event date approaches
Known gotchas
An invoice supports only specific payment_request combinations: one BALANCE alone, one DEPOSIT with one BALANCE, or a DEPOSIT with 2-12 INSTALLMENTs - arbitrary combinations aren't allowed
Recurring invoices and invoices with deposit/installment payment requests aren't supported for all payment methods (e.g., Afterpay), which can silently limit guest payment options
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?