Subscription

First-time workspace setup

Review Subscription during or after Getting Started — Recommended Setup Sequence step 1 General Information (optional Vivin platform billing — distinct from tenant payment rules on steps 5–7) before high-volume Integrations in step 12. Full tab map: Recommended setup order. Finish steps 13–15 and Onboarding a New Property — Step 7. Workflow pairing after go-live: Account Settings — Setup sequence after go-live.

Finding your way in this guide

Review Plan & Pricing and Payment Method first, then Billing History for past invoices. Card or checkout issues: Troubleshooting. Non-linear operator habits (Lockout catch-up, Pending manual receipt approval, Reject/revert mistaken receipts, Portfolio segmentation by tenant category, Notification row-click navigation, Payment alert to receivables triage, Confirmation alert triage, Finance debt receivables triage, Finance Income status drill-down, Cash flow forecast drill-down) have matching Related subsections below. Full pairing matrix: Subscription section cross-reference · Account Settings — Tab cross-reference.

The Subscription tab shows your Vivin platform subscription details, including plan pricing, payment method, and billing history.

Direct access

Open Account Settings > Account > Subscription at platform.vivin.app/settings/subscription. To land with hosted checkout already expanded, use platform.vivin.app/settings/subscription?expandCheckout=1 (same entry point as General Information → Subscription). See Deep Links for other settings routes.

Pair with other Account Settings tabs

Pair General Information (operator company identity on invoices and contracts) with this tab before high-volume channel imports — Listings counts and VIBAN Transfers rows in billing history track connected Integrations. Vivin platform subscription charges here are distinct from internal LLM spend on AI usage API (operator JWT, USD provider cost). Section-to-doc pairing: Subscription section cross-reference. Hub tab matrix: Account Settings — Tab cross-reference.

Who can use it

Pair with other Subscription sections

The account_settings.invoicing_&_payments gate matches Invoicing & Payments — confirm Users and roles — Role Permissions before delegating card-on-file updates. Full pairing matrix: Subscription section cross-reference.

The Subscription tab appears under Account Settings → Account when your role includes account_settings.invoicing_&_payments (same permission gate as Payments, Invoicing, and Utilities under Billing). Without it, the tab is hidden and direct URLs show the standard settings permission state. Billing changes to plan tier or contract terms still go through Vivin support — this screen is for self-serve card capture and usage history on subscribed workspaces.

What you see on screen

The page is grouped into Plan & pricing, Payment method, and Billing history. The main heading reflects subscription state:

Heading (English UI)	When it appears
Subscription	The account is subscribed (`isSubscribedToVIVIN` is active in product data).
Subscription – Action Required	Checkout or card capture is still required — an amber warning icon appears beside the title.

The three sections below use the same layout in both states.

Account Settings — Subscription: plan pricing cards, payment method, and billing history table in the settings shell

Walkthrough: Subscription tab — plan pricing and payment method, then scroll to Billing history (Current and Upcoming rows).

Plan & Pricing

Pair with other Subscription sections

Per active listing management rows track live Listings inventory — pair with Integrations before month-end when channel volume drives listing counts. Full pairing matrix: Subscription section cross-reference.

This section displays your current subscription plan and how charges are calculated:

Per active listing management — Price per managed listing
Per virtual IBAN transfer — Price per virtual IBAN transaction (booking and platform transfers)
Per active listing booking engine — Price for listings using the Vivin booking engine (if applicable)

Pricing is based on your usage and may vary by plan tier.

Payment Method

Pair with other Subscription sections

Company identity on General Information should match the cardholder name on file — use Resetting a Management User Password when Action Required blocks the user who owns billing access. Full pairing matrix: Subscription section cross-reference.

When the account is subscribed, this card shows the card on file:

Card brand (Visa, Mastercard, Amex)
Last four digits
Expiration date
Subscription status (Active subscription or an in-progress checkout status while Vivin confirms the card)

Hosted checkout when action is required

When the account is not yet subscribed, the Payment method card switches to Update your payment method copy and an Add card control (expand/collapse with Hide). That opens Vivin’s hosted subscription checkout in a secure iframe on desktop (modal title Subscription checkout). A short warning reminds you not to close the page until checkout succeeds — approval can take a moment after you submit the form.

Surface	Behaviour
Desktop — Subscription tab	Add card expands the checkout modal. While no card is saved yet, the modal may block closing the backdrop (same rule as the startup prompt below). After the API reports saved digits or subscribed status, use Close.
Desktop — narrow / mobile	The iframe is not embedded on small screens. Use Open checkout in a new tab to complete card capture in the browser, then return to Vivin.
Either	I'll do it later dismisses the expanded checkout without saving a card (when the backdrop is not locked).

On desktop, some accounts also see a startup checkout modal about five seconds after the management app finishes its initial load when:

the account is not yet subscribed (isSubscribedToVIVIN is false),
Vivin has provisioned a checkout URL for the workspace,
the signed-in user’s email is on Vivin’s allowlist for that prompt, and
you are not on a mobile layout (the startup modal is desktop-only).

The modal title is Subscription – Action Required and embeds the same hosted checkout iframe as the Subscription tab. While no card is saved yet, the modal may poll checkout status every few seconds and block backdrop dismiss for allowlisted emails until a card is on file or checkout reports subscribed — same lock behaviour as expanding Add card on the tab before digits are saved. Prefer Account Settings → Subscription when you want to complete billing deliberately; use I'll do it later or Close only when the product allows dismiss.

From Account Settings → General Information, the Subscription shortcut can open the tab with checkout already expanded (/settings/subscription?expandCheckout=1) so you land directly on the Payment method iframe without hunting for Add card.

Entry point	Best for
Subscription tab	Reviewing plan pricing, billing history, and updating a card on your schedule
Startup modal (desktop, allowlisted)	Accounts that must attach a card before routine operations
General Information → Subscription	Jumping straight into hosted checkout via `expandCheckout=1`

Deep link from General Information

When checkout is still required, General Information can show a Subscription shortcut that opens this tab with the hosted card section already expanded: the URL includes ?expandCheckout=1 (for example /settings/subscription?expandCheckout=1). The product removes that query parameter after it applies so bookmarks stay on /settings/subscription. Use the same pattern when you hand operators a link that should land directly on Add card instead of the collapsed Payment method card.

While the checkout iframe is open on desktop and no card digits are saved yet, the tab polls checkout status every few seconds so the UI can flip to Active subscription as soon as the gateway confirms the card — you do not need to refresh the whole settings page after submitting the hosted form.

For plan tier changes, contract questions, or billing disputes, contact Vivin support — see Get Help & Support.

Action Required screenshots

Follow-up captures when the docs account is not subscribed: settings-subscription-action-required-header.png (amber Subscription – Action Required title + Add card), settings-subscription-hosted-checkout-modal.png (desktop iframe + do-not-close warning). Optional MP4: settings-subscription-add-card-flow.mp4.

Vivin internal: payment transactions

When you are signed in with a Vivin internal operator account and the workspace is already subscribed, an extra card appears below Billing history:

UI element	English label (default)
Title	Payment transactions
Subtitle	Internal billing records (VIVIN operators only)
Table	Period, Amount, Status, Action (right-aligned)

It lists platform subscription charge rows for Vivin’s internal billing workflow — separate from the customer-facing Billing history table above it.

Status (examples)	Action
`to_approve`	Approve — confirms the charge; a success toast reads Transaction approved.
`approved`	Read-only — no action button
`pending`	Read-only while the gateway or back-office flow is in progress
`failed`	Read-only — retry or support follow-up happens outside this screen

When no rows exist yet, the table shows No subscription transactions. Customer property managers never see this block; it is for Vivin staff operating on subscribed accounts only.

Account Settings — Subscription, Payment transactions table with to approve rows and Approve action (Vivin internal operators)

Troubleshooting

Pair with other Subscription sections

Escalate persistent checkout failures through Using in-app support — tenant rent collections on Finance are a separate billing layer from Vivin platform fees here. Full pairing matrix: Subscription section cross-reference.

Symptom	What to try
Subscription – Action Required persists after adding a card	Wait for Vivin to confirm the card (status can lag). Refresh the tab or sign out and back in. If digits never appear, contact support with your account name.
Checkout iframe blank on desktop	Disable strict ad blockers for `platform.vivin.app`, allow third-party cookies for the checkout host, retry Add card.
Mobile shows Open checkout in a new tab only	Expected — complete card capture in the browser tab, then return to Vivin and refresh Subscription.
Startup modal blocks the app	Complete checkout, use I'll do it later when the backdrop is not locked, or open Account Settings → Subscription deliberately instead of dismissing mid-flow.
Billing history missing Upcoming	Row appears when the API returns a forecast for the next period; new or paused accounts may show Current only until usage is calculated.

Billing History

Pair with other Subscription sections

Listings and VIBAN Transfers columns reflect Sales channel volume — include Upcoming rows in Portfolio KPI review before forecasting platform fees (distinct from Handling a Late Payment — Step 1 tenant collections). Full pairing matrix: Subscription section cross-reference.

A table of past and upcoming billing periods shows:

Column	Description
Period	The month being billed (Current, Upcoming, or past)
Charge Date	When the charge is or was processed
Listings	Number of active listings in that period
VIBAN Transfers	Number of virtual IBAN transactions (booking + platform)
Total	Amount charged for the period

The Current period is highlighted in the table (badge on the row for the billing month in progress). Upcoming shows the estimated charge for the next month based on your current listing count and transfer usage — it appears before the charge date so you can forecast platform fees.

Account Settings — Subscription, Billing history table with Current and Upcoming period rows

Billing history rows

Each row is one billing period for your Vivin platform subscription (not tenant rent). Listings and VIBAN Transfers columns reflect usage counted for that month; Total is the platform fee charged or estimated for that period.

Subscription section cross-reference

Use this table when one Subscription topic naturally leads into another Account Settings tab, operator module, workflow, or concept — each row links to the docs you should read before or after reviewing platform billing.