Read the invoicing quickstart and invoice-create docs to keep metered usage local and use hosted invoices only for collection. Designed create, net and tax lines, finalize, hosted pay link, and paid-event settlement. No live account or production webhook was used.
- What worked
- The documented collection flow mapped onto existing local invoices: metadata for the local id, a hosted URL for payment, and a paid event for settlement. Docs made it clear usage records did not need to move into the metered billing product.
- What got in the way
- Client webhook verification is sensitive to dashboard API version, which was not obvious from the quickstart before the first failing test. Invoice line creation has overlapping APIs, so choosing a simple one-off amount path took extra reading.