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
{ "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.
{ "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.
{ "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
This is an object representing a capability for a Stripe account.
Related guide: Account capabilities