# RefundInput

Input · GraphQL API

Specific input fields for describing a refund.

## Fields

- `amount` (`Amount`): The amount to refund. Must be less than or equal to the amount of the original transaction. Defaults to the total amount of the original transaction.
- `orderId` (`String`): The refund's order ID. Defaults to the order ID of the original transaction.
- `merchantAccountId` (`ID`): ID of the merchant account that will be used when performing the refund.
- `description` (`String`): Description of the refund that is displayed to customers in PayPal email receipts.
- `reason` (`String`) — deprecated since 2023-06-08: Reason of the refund transaction. This field maps to the PayPal refund reason.
- `surchargeAmount` (`String`): The portion of the total refund amount attributable to the surcharge. This amount is already included in the total refund amount and must not be added separately. Value must be non-negative. Applicable to e-commerce credit card transactions only. [US region].
- `lineItems` (`[TransactionLineItemInput!]`): Line items for this refund. Up to 249 line items may be specified. Only allowed for Custom Actions transactions.

## Used by

- [RefundTransactionInput](/braintree/graphql/reference/types/refund-transaction-input) — Input; refund

## GraphQL definition

```graphql
input RefundInput {
  amount: Amount
  orderId: String
  merchantAccountId: ID
  description: String
  reason: String @deprecated(reason: "Please use `description` instead.")
  surchargeAmount: String
  lineItems: [TransactionLineItemInput!]
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)