# Betaling & Toegangsbeperkingen

Wanneer een abonnementsbetaling mislukt, implementeert Magma een gradueel escalatieproces dat de toegang tot gebouwfuncties progressief beperkt naarmate de achterstallige periode langer duurt. Dit document legt elke fase van de levenscyclus van betalingsfouten uit, wat bij elke fase wordt geblokkeerd en hoe u de volledige toegang herstelt.

***

## Overzicht

Betalingsfouten worden afgehandeld via 8 escalatiefasen, beginnend met een waarschuwing en culminerend in volledige gebouwarchivering op dag 60. Bij elke fase:

* Worden specifieke functies geblokkeerd.
* Worden e-mailmeldingen verzonden aan de gebouweigenaar, Accountmanager en alle stakeholders.
* Toont het gebouw een banner in de applicatie die de beperking en de vereiste actie uitlegt.

***

## Escalatiefasen

### Fase 1: INVOICE\_FAILED

**Trigger:** De initiële betalingspoging mislukt (dag 0).

**Beperkingen:** Geen — dit is alleen een waarschuwingsfase. Alle functies blijven volledig toegankelijk.

**Vereiste actie:** Werk de betaalmethode bij en probeer de betaling opnieuw via de sectie Abonnementsbeheer.

**Meldingen:** E-mail verzonden naar Eigenaar en Accountmanager met waarschuwing dat de factuur is mislukt en betaling vereist is.

***

### Fase 2: OVERDUE\_3\_DAYS

**Trigger:** Betaling is 3 dagen achterstallig.

**Beperkingen:**

* **DTT Minting is geblokkeerd.** U kunt geen nieuwe minting initiëren of een bestaande DTT bijwerken totdat de betaling is opgelost.

**Nog steeds toegankelijke functies:** Data Room, BIM 3D Viewer, Scan Viewer, Lot Division, Fluid Synoptic, Gallery, Beloningen, Taken, Activiteitsfeed.

**Meldingen:** E-mail verzonden naar Eigenaar, Accountmanager en alle stakeholders.

***

### Fase 3: OVERDUE\_7\_DAYS

**Trigger:** Betaling is 7 dagen achterstallig.

**Beperkingen:**

* DTT Minting blijft geblokkeerd.
* **Documentuploads zijn geblokkeerd.** Er kunnen geen nieuwe documenten worden geüpload naar de Data Room.
* **Documentvalidatie is geblokkeerd.** Validators kunnen documenten niet goedkeuren of afwijzen.

**Nog steeds toegankelijke functies:** Alleen-lezen toegang tot de Data Room (bekijken, downloaden), BIM 3D Viewer, Scan Viewer, Lot Division (alleen-lezen), Fluid Synoptic (alleen-lezen), Gallery (bekijken).

**Meldingen:** E-mail verzonden naar Eigenaar, Accountmanager en alle stakeholders.

***

### Fase 4: OVERDUE\_14\_DAYS

**Trigger:** Betaling is 14 dagen achterstallig.

**Beperkingen:**

* Alle beperkingen van Fase 3 blijven van kracht.
* **Toegang tot BIM 3D Viewer is geblokkeerd.** Stakeholders kunnen niet langer interageren met het 3D-model.
* **Toegang tot Scan Viewer is geblokkeerd.** Bekijken van puntenwolkscans is niet meer beschikbaar.

**Opmerking:** `canScanAccess` is een aparte machtigingsvlag. Deze vlag wordt bij deze fase expliciet ingesteld op false voor alle stakeholders.

**Nog steeds toegankelijke functies:** Alleen-lezen toegang tot de Data Room (beperkt), Gallery (alleen bekijken).

**Meldingen:** E-mail verzonden naar Eigenaar, Accountmanager en alle stakeholders.

***

### Fase 5: OVERDUE\_30\_DAYS

**Trigger:** Betaling is 30 dagen achterstallig.

**Beperkingen:**

* Alle beperkingen van Fase 4 blijven van kracht.
* Verdere toegangsbeperkingen worden toegepast op resterende toegankelijke functies.

**Meldingen:** E-mail verzonden naar Eigenaar, Accountmanager en alle stakeholders.

***

### Fase 6: PRE\_ARCHIVE\_7\_DAYS

**Trigger:** 7 dagen vóór de archiveringsdeadline (doorgaans dag 53 van de achterstallige periode).

**Beperkingen:**

* Alle beperkingen van Fase 5 blijven van kracht.
* Een **prominente waarschuwingsbanner** wordt weergegeven in de gehele gebouwinterface:

> "Dit gebouw wordt over 7 dagen gearchiveerd wegens niet-betaling. Betaal nu om volledige toegang te herstellen en gegevensarchivering te voorkomen."

Dit is een eindwaarschuwingsfase die stakeholders 7 dagen geeft om actie te ondernemen voordat het gebouw volledig wordt gearchiveerd.

**Meldingen:** E-mail met urgentiebericht verzonden naar Eigenaar, Accountmanager en alle stakeholders.

***

### Fase 7: PRE\_ARCHIVE\_3\_DAYS

**Trigger:** 3 dagen vóór de archiveringsdeadline (doorgaans dag 57 van de achterstallige periode).

**Beperkingen:**

* Alle beperkingen van Fase 6 blijven van kracht.
* Waarschuwingsbanner bijgewerkt om 3 resterende dagen weer te geven.

**Meldingen:** E-mail met definitief urgentiebericht verzonden naar Eigenaar, Accountmanager en alle stakeholders.

***

### Fase 8: ARCHIVED

**Trigger:** Dag 60 van de achterstallige periode.

**Beperkingen:**

* **Alle functies zijn uitgeschakeld.** Het gebouw is volledig gearchiveerd.
* Alle Data Room-toegang, BIM Viewer-toegang, Scan Viewer-toegang, Lot Division, Fluid Synoptic, Gallery, DTT-minting, Beloningen — alles is ontoegankelijk.
* Het gebouw blijft zichtbaar in het dashboard met een ARCHIVED-statusbadge, maar erop klikken toont een vergrendeld scherm.
* **Incassoprocedure gestart.** De openstaande factuur wordt doorverwezen naar een incassoproces.

**Gegevensbewaring:** Gebouwgegevens worden bewaard maar zijn ontoegankelijk. Gegevens worden niet onmiddellijk verwijderd — neem contact op met support om opties voor gegevensopvraging te bespreken.

**Meldingen:** E-mail verzonden naar Eigenaar, Accountmanager en alle stakeholders om hen op de hoogte te stellen van de archivering.

***

## Overzicht van beperkingen per fase

| Fase                  | Achterstallige dagen | Minting         | Upload/Valideren | BIM/Scan        | Alle functies         |
| --------------------- | -------------------- | --------------- | ---------------- | --------------- | --------------------- |
| INVOICE\_FAILED       | 0                    | Beschikbaar     | Beschikbaar      | Beschikbaar     | Beschikbaar           |
| OVERDUE\_3\_DAYS      | 3                    | **Geblokkeerd** | Beschikbaar      | Beschikbaar     | Beschikbaar           |
| OVERDUE\_7\_DAYS      | 7                    | **Geblokkeerd** | **Geblokkeerd**  | Beschikbaar     | Beschikbaar           |
| OVERDUE\_14\_DAYS     | 14                   | **Geblokkeerd** | **Geblokkeerd**  | **Geblokkeerd** | Beschikbaar (beperkt) |
| OVERDUE\_30\_DAYS     | 30                   | **Geblokkeerd** | **Geblokkeerd**  | **Geblokkeerd** | Beperkt               |
| PRE\_ARCHIVE\_7\_DAYS | \~53                 | **Geblokkeerd** | **Geblokkeerd**  | **Geblokkeerd** | Minimaal              |
| PRE\_ARCHIVE\_3\_DAYS | \~57                 | **Geblokkeerd** | **Geblokkeerd**  | **Geblokkeerd** | Minimaal              |
| ARCHIVED              | 60                   | **Geblokkeerd** | **Geblokkeerd**  | **Geblokkeerd** | **Alles geblokkeerd** |

***

## Toegang herstellen

Om de volledige toegang te herstellen bij elke fase vóór ARCHIVED:

1. Navigeer naar de sectie **Abonnementsbeheer** (toegankelijk zelfs bij betalingsfout).
2. Ga naar het tabblad **Facturen**.
3. Klik op de mislukte factuur en werk uw betaalmethode bij of bevestig deze.
4. Voltooi de betaling.

Zodra de betaling is bevestigd:

* Toegangsbeperkingen worden onmiddellijk opgeheven (binnen minuten).
* De statusbadge van het gebouw keert terug naar **Actief**.
* Alle geblokkeerde functies worden opnieuw ingeschakeld.
* Een bevestigings-e-mail wordt verzonden naar de Eigenaar en Accountmanager.

> **Belangrijk:** Het oplossen van de betaling vóór dag 60 voorkomt archivering. Als het gebouw al is gearchiveerd (Fase 8), neem dan contact op met Magma-support om herstelopties te bespreken.

***

## E-mailmeldingen

Bij elke escalatiefase worden e-mailmeldingen verzonden naar:

* **Gebouweigenaar** — Ontvangt alle meldingen bij elke fase.
* **Accountmanager (AM)** — Ontvangt alle meldingen bij elke fase.
* **Alle stakeholders** — Ontvangen meldingen vanaf Fase 2.

De toenemende urgentie van de e-mails is ontworpen om ervoor te zorgen dat ten minste één verantwoordelijke partij op de hoogte raakt en actie onderneemt vóór archivering.

***

## De canScanAccess-vlag

De toegankelijkheid van de Scan Viewer wordt beheerd door een speciale machtigingsvlag: `canScanAccess`. Deze vlag wordt onafhankelijk beheerd van algemene gebouwtoegangsmachtigingen.

* Bij Fase 4 (OVERDUE\_14\_DAYS) wordt `canScanAccess` voor alle stakeholders ingesteld op **false**.
* Wanneer de betaling is hersteld, wordt `canScanAccess` voor alle stakeholders gereset naar **true**.

Deze vlag is ook van toepassing in andere contexten — gebouwbeheerders kunnen bijvoorbeeld `canScanAccess` instellen op false voor specifieke stakeholderrollen, ongeacht de betalingsstatus, als de scandata als gevoelig wordt beschouwd voor hun rol.

***

## Tips voor het vermijden van betalingsfouten

* **Stel automatische facturering in** met een geldige betaalmethode — dit is de betrouwbaarste manier om betalingsfouten te voorkomen.
* **Wijs een Accountmanager aan** met factureringsverantwoordelijkheden die factuurmeldingen monitort.
* **Reageer onmiddellijk op INVOICE\_FAILED** — het oplossen van het probleem bij Fase 1 voorkomt functiebeperkingen en de situatie wordt opgelost voordat het escaleert.
* **Vermijd de OVERDUE\_7\_DAYS-fase** — de blokkering van documentupload en validatie bij deze fase betekent dat uw Magma Index-voortgang stagneert, beloningen niet kunnen worden verdiend en de workflow van uw team wordt verstoord.
* **Laat een gebouw nooit de status ARCHIVED bereiken** — gegevensopvraging uit een gearchiveerd gebouw vereist tussenkomst van support en kan aanvullende herstelprocedures inhouden.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mymagma.com/magma-documentation/nl/functies/payment-failure.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
