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.
- accountstringExpandable
ID of the Stripe account this fee was taken from.
- amountinteger
Amount earned, in cents.
- amount_
refundedinteger Amount in cents refunded (can be less than the amount attribute on the fee if a partial refund was issued)
- chargestringExpandable
ID of the charge that the application fee was taken from.
- currencyenum
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- refundedboolean
Whether the fee has been fully refunded. If the fee is only partially refunded, this attribute will still be false.
More attributes
- objectstring
- applicationstringExpandable
- balance_
transactionnullable stringExpandable - createdtimestamp
- fee_
sourcenullable object - livemodeboolean
- originating_
transactionnullable stringExpandable - refundsobject
The Application Fee 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_1MBoV6KbnvuxQXGucP0PaPPO", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284508, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoU0KbnvuxQXGu2wCCz4Bb", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284441, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoRzKbnvuxQXGuvKkBKkSR", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284315, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoPOKbnvuxQXGueOBnke22", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284154, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoOGKbnvuxQXGu6EPQI2Zp", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284084, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoMUKbnvuxQXGu8Y0Peaoy", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670283974, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MAgZBKbnvuxQXGuLTUrgGeq", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670015681, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1JAu9EKbnvuxQXGuRdZYkxVW", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1625738880, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": { "order_id": "6735" } }, { "id": "fr_1HZK0UKbnvuxQXGuS428gH0W", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1602005482, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_D0s7fGBKB40Twy", "object": "fee_refund", "amount": 138, "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
No parameters.
Returns
Returns an application fee object if a valid identifier was provided, and raises an error otherwise.
Response
{ "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_1MBoV6KbnvuxQXGucP0PaPPO", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284508, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoU0KbnvuxQXGu2wCCz4Bb", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284441, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoRzKbnvuxQXGuvKkBKkSR", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284315, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoPOKbnvuxQXGueOBnke22", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284154, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoOGKbnvuxQXGu6EPQI2Zp", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284084, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoMUKbnvuxQXGu8Y0Peaoy", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670283974, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MAgZBKbnvuxQXGuLTUrgGeq", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670015681, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1JAu9EKbnvuxQXGuRdZYkxVW", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1625738880, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": { "order_id": "6735" } }, { "id": "fr_1HZK0UKbnvuxQXGuS428gH0W", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1602005482, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_D0s7fGBKB40Twy", "object": "fee_refund", "amount": 138, "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" }}Returns a list of application fees you’ve previously collected. The application fees are returned in sorted order, with the most recent fees appearing first.
Parameters
- chargestring
Only return application fees for the charge specified by this charge ID.
More parameters
- createdobject
- ending_
beforestring - limitinteger
- starting_
afterstring
Returns
A dictionary with a data property that contains an array of up to limit application fees, starting after application fee starting_. Each entry in the array is a separate application fee object. If no more fees are available, the resulting array will be empty.
Response
{ "object": "list", "url": "/v1/application_fees", "has_more": false, "data": [ { "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_1MBoV6KbnvuxQXGucP0PaPPO", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284508, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoU0KbnvuxQXGu2wCCz4Bb", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284441, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoRzKbnvuxQXGuvKkBKkSR", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284315, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoPOKbnvuxQXGueOBnke22", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284154, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoOGKbnvuxQXGu6EPQI2Zp", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670284084, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MBoMUKbnvuxQXGu8Y0Peaoy", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670283974, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1MAgZBKbnvuxQXGuLTUrgGeq", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1670015681, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_1JAu9EKbnvuxQXGuRdZYkxVW", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1625738880, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": { "order_id": "6735" } }, { "id": "fr_1HZK0UKbnvuxQXGuS428gH0W", "object": "fee_refund", "amount": 0, "balance_transaction": null, "created": 1602005482, "currency": "usd", "fee": "fee_1B73DOKbnvuxQXGuhY8Aw0TN", "metadata": {} }, { "id": "fr_D0s7fGBKB40Twy", "object": "fee_refund", "amount": 138, "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" } } ]}Application Fee Refund objects allow you to refund an application fee that has previously been created but not yet refunded. Funds will be refunded to the Stripe account from which the fee was originally collected.
Related guide: Refunding application fees