Cause

Payment status does not allow a refund (must be succeeded or partially_refunded with remaining refundable amount).

Partner action

Only refund payments that have succeeded (or are partially refunded with remaining balance). Check GET /payments/{id}.

Gando action (internal)

Guard POST /payments/{id}/refund on payment.status and remaining refundable cents.

Example response

{
  "error": {
    "code": "payment_not_refundable",
    "message": "Payment is not in a refundable status",
    "requestId": "req_abc123"
  }
}