When you collect a transaction fee on top of a charge made for your user (using Connect), an Application Fee object is created in your account. You can list, retrieve, and refund application fees.
Related guide: Collecting application fees
Attributes
- idstring
Unique identifier for the object.
- objectstring, value is "application_fee"
String representing the object’s type. Objects of the same type share the same value.
- accountstringExpandable
ID of the Stripe account this fee was taken from.
- amountinteger
Amount earned, in the smallest currency unit.
- applicationstringExpandable
ID of the Connect application that earned the fee.
- balance_
transactionnullable stringExpandable Balance transaction that describes the impact of this collected application fee on your account balance (not including refunds).
- chargestringExpandable
ID of the charge that the application fee was taken from.
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- currencyenum
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- livemodeboolean
If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - originating_
transactionnullable stringExpandable ID of the corresponding charge on the platform account, if this fee was the result of a charge using the
destinationparameter. - refundedboolean
Whether the fee has been fully refunded. If the fee is only partially refunded, this attribute will still be false.
- refundsobject
A list of refunds that have been applied to the fee.
More attributes
- amount_
refundednullable integer - fee_
sourcenullable object
{ "id": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "object": "application_fee", "account": "acct_164wxjKbnvuxQXGu", "amount": 105, "amount_refunded": 105, "application": "ca_32D88BD1qLklliziD7gYQvctJIhWBSQ7", "balance_transaction": "txn_1032HU2eZvKYlo2CEPtcnUvl", "charge": "ch_1B73DOKbnvuxQXGurbwPqzsu", "created": 1506609734, "currency": "gbp", "livemode": false, "originating_transaction": null, "refunded": true, "refunds": { "object": "list", "data": [ { "id": "fr_1MBoU0KbnvuxQXGu2wCCz4Bb", "object": "fee_refund", "amount": 38, "balance_transaction": null, "created": 1670284441, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_D0s7fGBKB40Twy", "object": "fee_refund", "amount": 100, "balance_transaction": "txn_1CaqNg2eZvKYlo2C75cA3Euk", "created": 1528486576, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} } ], "has_more": false, "url": "/v1/application_fees/fee_1B73DOKbnvuxQXGuhY8Aw0TN/refunds" }, "fee_source": { "charge": "ch_1B73DOKbnvuxQXGurbwPqzsu", "type": "charge" }}Retrieves the details of an application fee that your account has collected. The same information is returned when refunding the application fee.
Parameters
- idstringRequired
Unique identifier for the object.
Returns
Returns an application fee object if a valid identifier was provided, and raises an error otherwise.
curl https://api.stripe.com/v1/application_fees/{{APPLICATION_FEE_ID}} \ -u "sk_test_...sk_test_...:" \ -H "Stripe-Version: 2026-10-28.endive"{ "id": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "object": "application_fee", "account": "acct_164wxjKbnvuxQXGu", "amount": 105, "amount_refunded": 105, "application": "ca_32D88BD1qLklliziD7gYQvctJIhWBSQ7", "balance_transaction": "txn_1032HU2eZvKYlo2CEPtcnUvl", "charge": "ch_1B73DOKbnvuxQXGurbwPqzsu", "created": 1506609734, "currency": "gbp", "livemode": false, "originating_transaction": null, "refunded": true, "refunds": { "object": "list", "data": [ { "id": "fr_1MBoU0KbnvuxQXGu2wCCz4Bb", "object": "fee_refund", "amount": 38, "balance_transaction": null, "created": 1670284441, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_D0s7fGBKB40Twy", "object": "fee_refund", "amount": 100, "balance_transaction": "txn_1CaqNg2eZvKYlo2C75cA3Euk", "created": 1528486576, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} } ], "has_more": false, "url": "/v1/application_fees/fee_1B73DOKbnvuxQXGuhY8Aw0TN/refunds" }, "fee_source": { "charge": "ch_1B73DOKbnvuxQXGurbwPqzsu", "type": "charge" }}