This payment cannot be refunded for this amount

One refund rule covers several conditions, and detail says which one failed: the payment must be succeeded, succeeded_at must be within refund_window_days, the provider of the successful attempt must support refunds for the method, an installment payment must be refunded in full, and the new amount plus all refunds not rejected, canceled or failed must not exceed the payment.

What to do

• Read refunded_minor on the payment and subtract it from amount.minor before asking: that difference is the most you can still refund.
• Check succeeded_at against the window before offering a refund button at all.
• If the method cannot be refunded through the provider (providers.refund_unsupported), the refund has to happen out of band; the API will not pretend otherwise.