Skip to content
العربية All documentation Sign in

Partner credit

An operator can hold a credit balance with Suitiee and use it to subscribe the hosts they manage to packages. It is the answer to "I bill my owners myself and I do not want each of them topping up a wallet."

What you need

Step 1 — Credit is granted

Suitiee grants the credit and records why — an invoice number, an agreement reference, or a sentence. That reason lives on the ledger, so a balance can always be traced to what bought it.

Step 2 — Spend it on a host's package

Subscribe a host to a package and the credit pays for it. Those visits are then used before anything the host funded themselves. See Packages.

Over the API: GET /partner/packages for what is available, then POST /partner/clients/{external_id}/subscribe. See The partner API.

Step 3 — Watch the alerts, not the balance

Balance alerts lists the hosts whose funding will not cover the cleanings already booked. That is the earliest honest warning that a unit is about to go uncleaned — earlier than any number on a dashboard.

Balance alerts: hosts whose funding will not cover what is booked

Step 4 — Read the ledger

GET /partner/credits returns the balance and every movement on it. In the panel, the same list sits under your credit balance.

Credit can also settle a PMS invoice

Your credit balance can be used to pay your own PMS subscription invoice — but that is a deliberate, manual decision, because the balance is normally there to fund your hosts' cleaning. See The PMS subscription.

When it goes wrong

What you see What it means What to do
A host with credit-funded visits still short The package is exhausted and their wallet is empty Subscribe them again, or have them top up
"The credit balance does not cover this" The invoice or subscription is larger than the balance Ask for more credit, or pay by card
A ledger line you do not recognise Every grant carries the reason it was granted Read the reason on the line
Hosts on Balance alerts who look funded Their funding does not cover what is already booked, not what is spent It is a forward-looking alert; act on it

Last updated 2026-09-04

Was this page helpful?