Skip to content

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 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.

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:

  1. Do what the issue asks, for example refund the customer in Stripe. Click Open to see the appointment.

  2. Write a short note saying how it was settled, for example Refunded by bank transfer. The note is kept in the appointment’s history.

  3. 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.

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.

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.

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.

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.

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.

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 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.

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