Stripe: Application fees schemas
4 Stripe schemas with complete fields and constraints.
← Application fees operations · All schemas
Create an application fee refund — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | `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](https://docs.stripe.com/connect/destination-charges#refunding-app-fee) |
amount | JSON | Required within parent | |
amount (anyOf 1) | integer | Alternative | Amount, in cents (or local equivalent). |
amount (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
balance_transaction | JSON | Optional | |
balance_transaction (anyOf 1) | JSON | Alternative | Balance transaction that describes the impact on your account balance. |
balance_transaction (anyOf 1) (anyOf 1) | string | Alternative | Maximum length: 5000 |
balance_transaction (anyOf 1) (anyOf 2) | Model | Alternative | Expand Retrieve a balance transaction — balance get Balance History Id — response body |
balance_transaction (anyOf 2) | null | Alternative | |
created | JSON | Required within parent | |
created (anyOf 1) | integer | Alternative | Time at which the object was created. Measured in seconds since the Unix epoch. Format: unix-time |
created (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
currency | string | Required within parent | 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). Format: currency |
fee | JSON | Required within parent | ID of the application fee that was refunded. |
fee (anyOf 1) | string | Alternative | Maximum length: 5000 |
fee (anyOf 2) | Model | Alternative | Expand Post Application Fees Id Refund — response body |
id | string | Required within parent | Unique identifier for the object. Maximum length: 5000 |
metadata | JSON | Optional | |
metadata (anyOf 1) | object | Alternative | 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. Additional keys: see wildcard field |
metadata (anyOf 1).* | string | Additional keys | Maximum length: 500 |
metadata (anyOf 2) | null | Alternative | |
object | string | Required within parent | String representing the object's type. Objects of the same type share the same value. Known values: fee_refund |
Referenced models: Post Application Fees Id Refund — response body, Retrieve a balance transaction — balance get Balance History Id — response body
Post Application Fees Id Refund — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
account | JSON | Required within parent | ID of the Stripe account this fee was taken from. |
account (anyOf 1) | string | Alternative | Maximum length: 5000 |
account (anyOf 2) | Model | Alternative | Expand Create an account — response body |
amount | JSON | Required within parent | |
amount (anyOf 1) | integer | Alternative | Amount earned, in cents (or local equivalent). |
amount (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
amount_refunded | JSON | Required within parent | |
amount_refunded (anyOf 1) | integer | Alternative | Amount in cents (or local equivalent) refunded (can be less than the amount attribute on the fee if a partial refund was issued) |
amount_refunded (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
application | JSON | Required within parent | ID of the Connect application that earned the fee. |
application (anyOf 1) | string | Alternative | Maximum length: 5000 |
application (anyOf 2) | Model | Alternative | Expand PostApplicationFeesIdRefund — response body — application / object: application |
balance_transaction | JSON | Optional | |
balance_transaction (anyOf 1) | JSON | Alternative | Balance transaction that describes the impact of this collected application fee on your account balance (not including refunds). |
balance_transaction (anyOf 1) (anyOf 1) | string | Alternative | Maximum length: 5000 |
balance_transaction (anyOf 1) (anyOf 2) | Model | Alternative | Expand Retrieve a balance transaction — balance get Balance History Id — response body |
balance_transaction (anyOf 2) | null | Alternative | |
charge | JSON | Required within parent | ID of the charge that the application fee was taken from. |
charge (anyOf 1) | string | Alternative | Maximum length: 5000 |
charge (anyOf 2) | Model | Alternative | Expand Create a charge — response body |
created | JSON | Required within parent | |
created (anyOf 1) | integer | Alternative | Time at which the object was created. Measured in seconds since the Unix epoch. Format: unix-time |
created (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
currency | string | Required within parent | 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). Format: currency |
fee_source | JSON | Optional | |
fee_source (anyOf 1) | JSON | Alternative | Polymorphic source of the application fee. Includes the ID of the object the application fee was created from. |
fee_source (anyOf 1) (anyOf 1) | Model | Alternative | Expand PostApplicationFeesIdRefund — response body — fee_source / value / type: charge, payout |
fee_source (anyOf 2) | null | Alternative | |
id | string | Required within parent | Unique identifier for the object. Maximum length: 5000 |
livemode | boolean | Required within parent | If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`. |
object | string | Required within parent | String representing the object's type. Objects of the same type share the same value. Known values: application_fee |
originating_transaction | JSON | Optional | |
originating_transaction (anyOf 1) | JSON | Alternative | ID of the corresponding charge on the platform account, if this fee was the result of a charge using the `destination` parameter. |
originating_transaction (anyOf 1) (anyOf 1) | string | Alternative | Maximum length: 5000 |
originating_transaction (anyOf 1) (anyOf 2) | Model | Alternative | Expand Create a charge — response body |
originating_transaction (anyOf 2) | null | Alternative | |
refunded | boolean | Required within parent | Whether the fee has been fully refunded. If the fee is only partially refunded, this attribute will still be false. |
refunds | object | Required within parent | A list of refunds that have been applied to the fee. |
refunds.data | array | Required within parent | Details about each object. |
refunds.data[] | Model | Each item | Expand Create an application fee refund — response body |
refunds.has_more | boolean | Required within parent | True if this list has another page of items after this one that can be fetched. |
refunds.object | string | Required within parent | String representing the object's type. Objects of the same type share the same value. Always has the value `list`. Known values: list |
refunds.url | string | Required within parent | The URL where this list can be accessed. Maximum length: 5000 |
Referenced models: Create an account — response body, PostApplicationFeesIdRefund — response body — application / object: application, Retrieve a balance transaction — balance get Balance History Id — response body, Create a charge — response body, Create an application fee refund — response body, PostApplicationFeesIdRefund — response body — fee_source / value / type: charge, payout
PostApplicationFeesIdRefund — response body — application / object: application
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
id | string | Required within parent | Unique identifier for the object. Maximum length: 5000 |
name | JSON | Optional | |
name (anyOf 1) | string | Alternative | The name of the application. Maximum length: 5000 |
name (anyOf 2) | null | Alternative | |
object | string | Required within parent | String representing the object's type. Objects of the same type share the same value. Known values: application |
PostApplicationFeesIdRefund — response body — fee_source / value / type: charge, payout
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
charge | string | Optional | Charge ID that created this application fee. Maximum length: 5000 |
payout | string | Optional | Payout ID that created this application fee. Maximum length: 5000 |
type | string | Required within parent | Type of object that created the application fee. Known values: charge, payout |