Sample - Stripe API
POST/v1/application_fees/{id}/refunds

Create an application fee refund

Creates a refund for an application fee that was previously collected. Supply amount to issue a partial refund, and use metadata to attach structured key-value information to the refund. You can issue multiple partial refunds until the full fee has been refunded.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.
  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 3 body fields
idstringrequired
The unique identifier of the application fee to refund. Maximum 5000 characters.

Optional form-encoded parameters for creating an application fee refund.

amountintegeroptional
A positive integer, in _cents (or local equivalent)_, representing how much of this fee to refund. Can refund only up to the remaining unrefunded amount of the fee.
expandarray<string>optional
Specifies which fields in the response should be expanded.
metadataobjectoptional
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.

2 status codes
200Returns the created application fee refund with its amount, currency, fee identifier, balance transaction, metadata, and creation time.
amountintegerrequired
Amount, in cents (or local equivalent).
balance_transactionstringoptional
Balance transaction that describes the impact on your account balance.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
currencystringrequired
Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
feestringrequired
ID of the application fee that was refunded.
idstringrequired
Unique identifier for the object.
metadataobjectoptional
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:fee_refund
defaultError response.
errorobjectrequired

Error handling

id must identify the application fee. When supplied, amount must be a positive integer in cents or the local currency equivalent and cannot exceed the fee's remaining unrefunded amount; expand values must be no more than 5000 characters.