Maxmove LogoDocs

Die Entwicklerdokumentation ist auf Englisch verfügbar.

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.

Als Markdown ansehen

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/deliveries is 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_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:

StatusCodeMeaningWhat to do
403invoice_billing_not_enabledYour workspace is not approved for invoice billing yet.Contact support to enable invoice billing.
402invoice_credit_limit_exceededThe delivery would exceed your workspace's credit limit.Settle open statements or contact support.
402invoice_statement_overdueAn 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.

Hat das Ihre Frage beantwortet?