Billing
How deliveries booked through the Maxmove API are billed: per-delivery or monthly billing, invoice approval and credit limit, what is charged, and the billing errors.
Deliveries you create with a live key are billed to the workspace that owns the key, according to its invoice billing frequency. Test keys are never billed.
How API deliveries are paid#
- Invoice billing. Every live delivery from
POST /v1/deliveriesis booked on invoice. The business workspace chooses collection after each completed delivery or monthly in Settings → Billing → Billing frequency. The default is monthly. There is no card payment per delivery through the API. - Only completed deliveries. A delivery is assigned to a statement when it is completed. Monthly billing groups deliveries by their calendar month (UTC) of completion. Cancelled deliveries are not added.
- Price.
amount_centson the quote and the delivery is the total price in cents ofcurrency. Prices include applicable VAT. - Quoted price. Book with a
quote_idto 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 remains unpaid after the workspace's grace period. | Pay the outstanding balance, then retry. Contact support if the transfer is still in transit. |
These errors don't occur with test keys, so check approval before you go live.
New invoice bookings receive a workspace-specific grace period after a statement's due date to allow bank transfers to arrive. The default is seven full days (168 hours); Maxmove staff can set 0–90 days for your workspace. Zero means booking is blocked at the due date. Each day is a full 24 hours. The original due date and outstanding balance stay unchanged. Available credit and any review or currency holds still apply during grace. Once grace expires, an unpaid statement blocks new invoice bookings until payment is recorded in full.
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 through invoice statements. Maxmove charges the workspace's company card per delivery. See Integrations.
Billing frequency and documents#
Changing the frequency applies to future completed deliveries. Deliveries already assigned to a statement keep their frequency. Invoice documents remain per order; a statement groups them for payment. Per-delivery statements become eligible after completion and invoice readiness, while monthly statements wait for the month to end. Workspace invoice approval, available credit and collection activation remain separate requirements.
Did this answer your question?