Question 1

What should I keep for accounting?

Accepted Answer

Keep your invoice records, your payout records, and the webhook events that report what happened to each. The webhook stream is the authoritative log — record against it, anchored to the invoice and payout objects it describes. Verify each webhook's signature so you are recording genuine halfin events. Because crypto payments are final, these are settled facts, not provisional figures that a dispute might revise later.

Question 2

Why is the webhook the source of truth and not the redirect?

Accepted Answer

The redirect to your redirect_url is where the customer's browser goes after paying — a convenience, not proof of payment. The browser can close early or lose the tab without changing what settled on-chain. The webhook is a server-to-server event halfin sends when an invoice's state actually changes, and it fires regardless of what the browser did. Reconcile against the webhook stream, and verify its signature, so your books reflect what genuinely settled.

Question 3

Which webhook events should I record for reconciliation?

Accepted Answer

Inbound: invoice.confirming and invoice.paid, plus the edge cases invoice.overpaid, invoice.underpaid, invoice.expired, invoice.late_deposit, and invoice.deposit_reversed. Balance and outbound: balance.credited, payout.completed, and payout.failed. Each is a distinct, reconcilable fact about money you can map to a ledger entry, paired with the invoice or payout object it describes.

What should I keep for accounting?

Keep reading across the cluster.