Billing – API docs

Deliveries you create with a live key are billed to the workspace that owns the key, on its monthly invoice. Test keys are never billed.

How API deliveries are paid#

Monthly invoice. Every live delivery from POST /v1/deliveries is booked on invoice with monthly billing. There is no card payment per delivery through the API.
Only completed deliveries. A delivery is added to the monthly statement when it is completed, in the calendar month (UTC) of completion. Cancelled deliveries are not added.
Price. amount_cents on the quote and the delivery is the total price in cents of currency. Prices include applicable VAT.
Quoted price. Book with a quote_id to get exactly the quoted price. See Quotes and prices.

Invoice approval#

Before you can create live deliveries, Maxmove must approve your workspace for invoice billing and set a credit limit. Contact support to enable it.

Quotes work without approval. Live delivery creation checks it:

Status	Code	Meaning	What to do
403	`invoice_billing_not_enabled`	Your workspace is not approved for invoice billing yet.	Contact support to enable invoice billing.
402	`invoice_credit_limit_exceeded`	The delivery would exceed your workspace's credit limit.	Settle open statements or contact support.
402	`invoice_statement_overdue`	An invoice statement is overdue.	Pay the outstanding balance, then retry.

These errors don't occur with test keys, so check approval before you go live.

API access#

Business workspaces have API access by default. Fleet workspaces need a plan that includes API access; otherwise requests answer 403 api_access_disabled. See Authentication.

Shop integrations are billed differently#

Orders from the Shopify, WooCommerce, and Shopware integrations are not billed on the monthly invoice. Maxmove charges the workspace's company card per delivery. See Integrations.