Payments
Your workspace pays, the subject pays, or someone else does.
Every report has a paymentMode, set when you
create it.
| Mode | Who pays |
|---|---|
SELF | Your workspace. Charged when the report launches. |
CANDIDATE | The subject, through a Verifisha payment link. |
THIRD_PARTY | Someone you nominate — an employer, a landlord — through a Verifisha payment link. |
With CANDIDATE and THIRD_PARTY the report waits in PENDING_PAYMENT, and
its checks do not run until payment completes.
Tracking payment
- Every report carries
paymentState—PENDING,PAID,FAILED,EXPIREDorNOT_REQUIRED— onGET /reports/{reportId}and in the response when you create it. - The
payment.paidwebhook tells you when a candidate or third-party payment completes, so you do not have to poll.
Prices
Prices are resolved per workspace. Each
check definition carries its
price — read it from the API rather than hard-coding it, so the price you show
is the price charged.