Key Rules and Limitations
Only One Refund Can Be Processed Per Transaction
Piano allows a single refund action per transaction through the Piano Dashboard. This is most commonly encountered with partial refunds:
-
If you issue a partial refund in Piano, you cannot later issue another refund (partial or full) for the same transaction from within Piano.
-
If you later need to refund the remaining amount, you must process the additional refund directly in your payment provider's dashboard (for example, Stripe or PayPal).
Partial Refunds Are Final in the Piano UI
Once a partial refund is processed, Piano treats that transaction as refunded (the transaction moves to a refunded state), which prevents any additional refunds from being initiated in the Piano interface.
Refunds Cannot Be Reversed or Edited After Initiation
After you initiate a refund (full or partial) in Piano, it cannot be canceled, halted, or modified within Piano.
If a refund was issued for the wrong amount, the correction must be handled outside of Piano (for example, by issuing a new charge through your payment provider if your business process allows it).
Payment Provider Dependent Behavior
Refund capabilities in Piano depend on the payment provider used for the transaction:
-
If the payment provider supports partial refunds (for example, many credit card payment providers do), Piano can process a partial refund.
-
If the payment provider does not support partial refunds (common with some custom/invoice-like payment types, or certain providers), Piano may only be able to process a full refund.
This behavior is not configurable in Piano; it is determined by the payment provider's functionality.
Common Provider-Specific Symptom
If you see an error such as:
Payment is not partial refundable
This indicates the payment provider for that transaction does not allow partial refunds. In that case:
-
Process the refund through the payment provider directly, or
-
Issue a full refund if that is the only option supported for that payment type.
Time Limits: Refund Windows May Be Enforced by the Provider
Even when Piano supports initiating a refund, your payment provider may restrict how long after the original payment a refund is allowed.
|
Provider |
Typical Refund Window |
Notes |
|---|---|---|
|
PayPal |
180 days |
From the original transaction date |
|
Other Providers |
Varies |
Check your provider's documentation |
If the transaction is outside the provider's refund window, you won't be able to refund it via Piano. You'll need to handle it directly with the payment provider or follow your organization's alternative refund process.
How to Issue a Partial Refund
-
Confirm the transaction's payment provider supports partial refunds.
-
In Piano, open the user/customer record and locate the relevant transaction.
-
Click Refund and enter/confirm the partial amount (if the provider supports editable partial amounts).
-
Submit the refund, verify the amount carefully, because:
-
You cannot issue a second refund for that transaction in Piano.
-
The refund cannot be reversed or adjusted in Piano once submitted.
-
Include all amounts that must be refunded (including taxes, if applicable) in this single refund action.
Troubleshooting
The Refund Button Is Disabled or Greyed Out
Most commonly, this means a refund (often a partial refund) has already been issued for that transaction in Piano. Because Piano only supports one refund per transaction, no further refunds can be initiated in the Dashboard.
Next step: Process any additional refund amount directly in the payment provider's dashboard.
In rare cases, this may also be caused by a transaction that has not yet settled or remains in a pending state, as is common with direct debit or ACH payments.
You Need to Refund Taxes or the Remaining Balance
Piano cannot process a second refund for the same transaction.
Include all amounts that must be refunded (including taxes, if applicable) in the single refund you initiate in Piano. If you already issued a partial refund, complete the remainder in the payment provider.
You Cannot Access Payment Details or Refund Actions
If you can't view the necessary user/payment details, confirm:
-
You have the required permissions/role access.
Operational Recommendations
-
Decide the final refund amount before submitting the refund in Piano.
-
Validate payment provider capabilities for partial refunds during selection/onboarding if partial refunds are a business requirement.
-
For scenarios requiring multiple adjustments or refunds beyond provider windows, plan to use your provider's tools (or internal finance systems) for exceptions.