Billing | Mappinest Docs

Overview

The Billing workspace shows your current plan, monthly usage period, PAYG state, payment method, invoices, and invoice details. Plan changes and card updates are completed securely through Stripe.

Mappinest does not store complete card numbers or card security codes. The console receives only the card brand, last four digits, and expiry date needed to identify the default payment method.

Billing workspace

Section	What it shows
Overview	Current plan, billing state, usage period, allowances, and estimated overage.
Manage Plan	Plan choices, PAYG actions, the default payment method, and secure Stripe card replacement.
Invoices	Finalized invoices, payment state, hosted invoice links, and downloadable PDF documents.
Billing details	Invoice address, country, and supported tax identification details synchronized with Stripe.

Plans and billed usage

Free includes monthly request allowances without a recurring subscription. Flex costs $18 USD per month, includes higher allowances, and uses lower overage rates. Pro is arranged through custom terms. Current prices and included usage are listed on the Pricing page.

Monthly API usage is measured with three units. Tiles API usage is measured in tile requests, Maps API usage in map loads, and Dataset API usage in dataset requests. See Platform Limits for the current included amounts.

PAYG applies to request usage. It does not increase hosted storage, hosted-file allowances, or upload limits.

Free PAYG

Free PAYG lets a Free account continue beyond its included monthly request allowances. It requires an explicit authorization and a valid default payment method. A Free account without both requirements cannot create billable overage.

Select Enable Free PAYG from Manage Plan and confirm the billing terms.
Complete the Stripe payment-method form if the account does not already have a usable default card.
Return to Billing and wait for the activation confirmation. Stripe webhook processing can take a few seconds.
Review current usage and estimated overage from Billing or the Usage page.

Usage is stored by UTC date. When PAYG is enabled during a day, chargeable usage starts at the beginning of the next UTC day. Usage recorded before that boundary is not converted into PAYG overage.

Disabling PAYG stops future PAYG authorization. Usage already accrued while PAYG was active and any finalized invoices remain payable. If the default payment method is removed, Mappinest disables future Free PAYG or Flex PAYG fallback after Stripe confirms the change.

Flex

Choose Flex from Manage Plan to open Stripe Checkout. Checkout shows the amount due, any proration, applicable tax, and the next billing date before you subscribe.

A Flex cancellation is scheduled for the end of the current subscription period. Flex allowances stay active until that date. Free PAYG continues afterward only when the account has an existing PAYG fallback authorization and a usable default payment method.

Scheduling a downgrade does not start the storage remediation period. Storage is checked when the lower plan actually becomes active. Read Storage usage for the full retention timeline.

Payment methods

Manage Plan shows the default card used for automatic billing. Select Add payment method or Replace payment method to open the secure Stripe form directly. A successful replacement becomes the new default payment method.

When a new default card is added, Mappinest can immediately retry eligible outstanding automatic invoices. An invoice that requires cardholder authentication may still require an additional action in Stripe.

Invoices

The Invoices section lists finalized account invoices and their current payment state. Use View invoice for the Stripe-hosted invoice page or PDF to download the invoice document. The Outstanding filter shows invoices that still require payment or another action.

If an automatic payment fails, Billing displays the payment state and Mappinest sends the applicable recovery notification. Updating the default card or completing the Stripe payment action allows the invoice state to reconcile through the billing webhook.

Payment grace period

For an unpaid monthly usage invoice, the payment grace period runs through the end of the 10th UTC day of the following month. If the invoice remains unpaid, serving can be paused from the beginning of the 11th UTC day. Dashboard access and payment recovery remain available.

Paying the invoice or successfully retrying it removes the invoice-based restriction after the payment webhook is processed. This payment restriction does not delete hosted tilesets or datasets.

Billing details

Billing details are used for future invoices. You can maintain the invoice address, country, and supported tax identification number from the console. Changes are synchronized with the Stripe customer connected to the Mappinest billing account.

When a billing change appears

Checkout, card updates, invoice payments, and subscription changes are confirmed by Stripe webhooks. The Billing page refreshes its state after you return, but a completed provider action can take a few seconds to appear. Refresh the page if the confirmation is still being processed.