Skip to main content
Use the Refunds API when money already captured on an appointment needs to come back. A customer or barber requests a refund. A shop owner approves or denies that request.

​
What you do first

  1. Confirm the appointment payment is eligible before you ask the caller to retry.
  2. Request a refund (or open the existing request) with an idempotency key on money-changing writes.
  3. List refund requests or get one while it waits.
  4. Approve or deny it. Approval moves money; denial leaves the capture in place.

​
States that matter

​
When a call fails

Failures come back as problem documents. Open the type link for the cause, the fix, and whether retrying is safe. Some appointments cannot refund yet; the problem page names the reason and the next call.
  • Captures and authorizations live under Appointments.
  • Card-present collection lives under Payments.