Payment Issues
The Issues tab of the Payments page lists money that has not moved as it should, for example a refund that Stripe could not make.
Who sees which issues
Section titled “Who sees which issues”| Who | What they see on the Issues tab |
|---|---|
| The business owner | Every issue in the business |
| A staff member with Update Stripe permission | Every issue in the business |
| A subcontractor | The issues on their own Stripe account: customer refunds, disputed card payments and Stripe Tax records for their appointments. Not your share of their charges, sales to reverse or gift cards, which are the business’s |
A subcontractor sees the Issues tab on their Payments page once their Stripe account is connected. They never need Update Stripe permission for it, and cannot be given it. See Staff Permissions and Subcontractor.
An issue on a subcontractor’s account can be marked settled by either the business owner or the subcontractor. It is usually the subcontractor who fixes it, since only they can sign in to their own Stripe account.
Retrying or needs you
Section titled “Retrying or needs you”Every issue is in one of two states:
- Retrying. Boniquo is fixing it automatically. There is nothing to do; it disappears once it is fixed
- Needs you. Boniquo has stopped retrying, or could never fix it. Do what the issue says, then mark it settled
To mark an issue settled:
-
Fix it
Section titled “Fix it”Do what the issue asks, for example refund the customer in Stripe. Click Open to see the appointment.
-
Click Mark settled
Section titled “Click Mark settled”Write a short note saying how it was settled, for example Refunded by bank transfer. The note is kept in the appointment’s history.
-
Click Mark settled again
Section titled “Click Mark settled again”The issue shows Settled and the count on the tab goes down.
If someone else marked the same issue settled first, for example the owner and the subcontractor at the same time, you are told it is already settled and the list is refreshed. Only the first note is kept; it is in the appointment’s history with who wrote it.
The issues
Section titled “The issues”Customer refund
Section titled “Customer refund”| Shown as | Meaning |
|---|---|
| Refund retrying | The refund for a cancelled appointment failed. Boniquo tries again every hour, up to 5 attempts in all |
| Refund needs you | The refund could not be made. The customer has not been told |
Some failures cannot be fixed by trying again, for example a refund that Stripe accepted and then reported as failed. These go straight to Refund needs you.
To fix it, contact the customer and refund them from the Stripe account the payment was made into (a subcontractor’s own account for their appointments), or another way. A refund you make in the Stripe Dashboard is picked up by Boniquo and settles the issue for you. A refund made any other way, mark settled.
Your share of a subcontractor charge
Section titled “Your share of a subcontractor charge”| Shown as | Meaning |
|---|---|
| Share waiting | A subcontractor’s customer paid into the subcontractor’s Stripe account and your share has not reached your account yet, for example because Stripe has not made the money available. Boniquo tries again every hour, for up to 7 days |
| Share needs you | After 7 days your share still could not be passed on. Boniquo has been notified and will transfer it to your Stripe account |
Once the money arrives in your Stripe account, mark it settled.
Sale refunded in Stripe
Section titled “Sale refunded in Stripe”| Shown as | Meaning |
|---|---|
| Reverse Sale needed | A checked-out sale was refunded in Stripe, or from the Dashboard tab of the Payments page. Only the card was refunded |
Open the appointment and click Reverse Sale to give back any gift cards and loyalty rewards. The card is not refunded again. The issue disappears once the sale is reversed. See Refunds.
Sale’s record in Stripe Tax
Section titled “Sale’s record in Stripe Tax”This is listed for an appointment, a retail sale or a class pass sold at the desk. A retail sale’s is shown as Retail sale’s record in Stripe Tax, and Open takes you to the Retail Sales page. A pass’s is shown as Pass’s record in Stripe Tax, and Open takes you to the Members tab of Passes & Memberships.
| Shown as | Meaning |
|---|---|
| Tax record updating | Sales and refunds that Stripe Tax calculated tax for are recorded in Stripe Tax. This one has not been recorded yet. Boniquo tries again every hour, up to 5 attempts |
| Tax record needs you | The record could not be brought up to date |
To fix it, check the sale (or the pass) and any refund in Stripe Tax, correct it there, then mark it settled. See Tax.
Disputed card payment
Section titled “Disputed card payment”A dispute (or chargeback) is when the customer asks their bank to take back a card payment. Boniquo never moves money for a dispute; it shows it so you can act.
| Shown as | Meaning |
|---|---|
| Payment disputed | The bank is disputing the payment. Click View in Stripe and respond before Stripe’s deadline |
| Dispute lost | The bank has taken the money back, plus Stripe’s dispute fee |
A dispute you win disappears by itself. For one you lose, decide what to do with the customer (charge them again, write it off or block them), then mark it settled. If the payment was for a subcontractor’s appointment, your share goes back to the subcontractor automatically.
Gift card share of a reversed sale
Section titled “Gift card share of a reversed sale”| Shown as | Meaning |
|---|---|
| Gift card refund needs you | Part of a reversed or cancelled sale was paid with a gift card that has since been voided, cancelled, expired or deleted, so that part could not go back onto it |
Give the customer that amount another way, for example a new gift card or a refund, then mark it settled.
Shown on the appointment only
Section titled “Shown on the appointment only”| Shown as | Meaning |
|---|---|
| Clawback due | After a refund of a subcontractor’s charge, the subcontractor’s fee and your share are still being put right. Boniquo tries again every hour |
There is nothing for you to do, so it is not listed on the Issues tab.
What Boniquo checks automatically
Section titled “What Boniquo checks automatically”Behind the scenes, Boniquo runs regular checks that find and fix problems before they need you. Most never appear on the Issues tab.
| Check | How often | What it does |
|---|---|---|
| Failed refunds | Every hour | Tries each failed refund again, then hands it to you after 5 attempts |
| Subcontractor shares | Every hour | Passes on your share of a subcontractor’s charge, and puts the shares right after a refund |
| Stripe Tax records | Every hour | Records sales and refunds in Stripe Tax that are not recorded yet |
| Deposit links | Every hour | When a deposit link expires, asks Stripe whether it was paid. A deposit paid but not recorded is applied to the booking |
| Unpaid deposits | Every hour | A booking whose deposit was not paid in time is checked with Stripe first, then cancelled. Any gift card is given back and the customer is told |
| Card reader payments | Every hour | A card reader payment that went through but was not recorded, for example because the browser was closed, is recorded. One that never completed is closed off |
| Sales figures | Weekly | Checks the dashboard’s sales figures against your bookings and rebuilds any that disagree |