Refunds and disputes
A refund that reserves the money atomically before it is promised, and a dispute that is an object with a timetable rather than an email thread somebody is supposed to remember.
Merchants handling returns, support teams, and customers who were charged for something they did not get.
Part of the platform itself: it is present wherever BitriPay runs.
The problem
Refunds are usually promised and then attempted. If the merchant balance has already settled out, the refund fails after the customer has been told it is coming — and disputes live in inboxes where deadlines are missed.
How it works
- A refund reserves the amount atomically before it is accepted — the money is secured, then the promise is made.
- Refund up to what is still refundable on the original payment; the remaining amount is shown.
- A dispute is an object with a state, a deadline and the evidence attached.
- Split payments are allocated back pro rata, or absorbed by the merchant, according to the policy set.
What you can check
Facts about the running platform rather than adjectives. Each one is visible in the product, the API reference or the ledger.
- A refund reserves the amount atomically; a refund that cannot be funded is refused at the point of request rather than failing later.
- The refundable balance of a payment is a figure the API reports, so partial refunds cannot quietly exceed the original.
- Disputes are objects with states and deadlines, not email threads, so a missed deadline is visible before it is missed.
- Where a payment was split between recipients, refunds are allocated pro rata or absorbed by the merchant according to the recorded policy, and failed recoveries can be retried.
- A cashier can refund only up to the limit the business sets; above it the refund is refused.
What it costs
Refunding returns the money to the payer. Where a provider fee on the original payment is not returned by the provider, the statement shows that rather than absorbing it silently.
Questions
Can I refund more than once on the same payment?
Yes, up to what is still refundable. The remaining refundable amount is reported, so a series of partial refunds cannot quietly exceed the original payment.
What happens to a refund on a payment that was split?
It follows the policy recorded on the payment: each recipient gives back their share pro rata, or the merchant absorbs the whole amount. A recovery that fails can be retried rather than silently abandoned.
Why was my refund refused?
Most often because the amount could not be reserved — the funds were not available at the moment of the request. Being refused at that point is deliberately better than being promised a refund that fails afterwards.
Read next
Settlement and statements
A settlement statement that is numbered, hashed and reproducible, showing the provider fee, the platform fee and the tax on it as separate lines rather than one net figure.
Team and roles
Staff get their own sign-in with a role the software enforces every time, including a refund limit the owner sets — so delegating the counter does not mean handing over the business.
The ledger
A double-entry ledger where balances are derived from postings rather than stored, corrections are opposing entries rather than edits, and invariants are enforced at write time instead of checked by a nightly job.