Refunds apply to card (fiat) payments only. Crypto payments settle directly on-chain and cannot be refunded from Suby.
How to Issue a Refund
Refunds are accessible from two places in your dashboard. From Payments1
Go to Payments
Navigate to Payments in your dashboard.
2
Find the transaction
Locate the payment you want to refund.
3
Refund
Click on it, select Refund, and confirm. The refund is processed immediately.
1
Go to Transactions
Navigate to Transactions in your dashboard.
2
Find the transaction
Locate the transaction with status
succeeded.3
Refund
Click on it, select Refund, and confirm. The refund is processed immediately.
What Happens After a Refund
Customer refunded
The customer receives their money back via the original payment method.
Status updated
The transaction status updates to
refunded in your dashboard.Subscription cancelled
If the refund is on a subscription payment, the subscription is cancelled and access is revoked.
Payout adjusted
The refunded amount is deducted from your next payout.
Partial Refunds
You can refund only part of a payment by specifying an amount instead of refunding the full charge.- Refund any amount up to the captured total, in the payment’s currency.
- Call the refund repeatedly — as long as the cumulative refunded amount stays within the captured total.
- While a residual amount remains, the payment status is
PARTIALLY_REFUNDED. Once the cumulative refunds reach the full captured amount, it flips toREFUNDED. - The running total is exposed as
refundedAmountCentson the payment, and each API call returns theremainingRefundableCentsstill available.
A subscription payment is cancelled and access revoked only when it is fully refunded. A partial refund on a subscription payment leaves access intact.
Webhooks
Refunds emit signed payment webhooks so your systems stay in sync:Via API
Full API Reference
Endpoints, parameters, and response objects for Refunds — including the optional
amountInCents for partial refunds.
