In the dashboard: open an inspection to see its payments, payer shares and refunds
The Hive Inspect API is a work in progress. It is available to a small group of accounts today, and the release for everyone is coming very soon. To ask for early access, message us from the chat bubble in your dashboard.
What you get back
Amounts are in dollars in your account’s currency, the same as the rest of the API.
Check that an inspection is fully paid
Usesettled. It is true only when all three are true:
- The inspection’s
payment_statusispaid. - Nothing is owed (
amount_dueis 0). - No payment is still
processing,awaiting_closingorunknown.
Payment status
Each payment has astatus:
For a bank payment made in the last 14 days, Hive asks Stripe for the real state when you make the request.
Payer shares
shares shows who pays what. The main client’s row has the id primary. Every other row is a share of the bill you sent to someone else, such as an agent, and has its own id.
Each share has a status: pending, partial, processing or paid.
The summary is the truth for what is owed. A share can stay open after someone else has paid the bill. For example, you send a share to an agent and the client then pays everything. The inspection is paid and
amount_due is 0, while that share still shows pending. Do not add up the shares yourself.Amounts and the technology fee
Each payment has two amounts:amountis what was charged. On a card payment it includes the technology fee, unless your company absorbs it. This is the number to match against Stripe.services_amountis the part that paid for your services.
Stripe ids
stripe_payment_intent_id(pi_...) is the payment on your own Stripe account.stripe_refund_id(re_...) is the refund on your own Stripe account.
Refunds and reversals
- A refund appears in
refundswith astatusofpending,succeeded,failedorcanceled. A failed or canceled refund returned no money and is not counted. - A rejected bank payment appears in
failed_bank_payments. Hive removes it frompaymentsand the inspection goes back to unpaid. - To find out when it happens, subscribe to the
inspection.payment_updatedwebhook. It is sent for every payment, refund and rejected bank payment, and again when a bank payment settles. The message carries these same payment details.
Things to know
- Payment ids can change after an edit. A payment keeps its
id, unless someone uses Edit Payment or Clear Payment on the inspection. Those replace the payment records. - A share’s charged amount is worked out. Hive stores the services amount of a share payment. Its
amountadds the technology fee and can differ from Stripe by a cent. - Refunds of a share’s payment are not listed. If you refund a payment made by another payer, it does not appear here yet.
- Old payments can be missing details. A few payments from before 2026 have no
idor no card details. - Disputes are not included. Chargebacks are not tracked in Hive. Check them in Stripe.

