openapi: 3.0.0 info: title: Stripe Accounts Account Get API description: This is an object representing a Stripe account. You can retrieve it to see properties on the account like its current requirements or if the account is enabled to make live charges or receive payouts. contact: email: dev-platform@stripe.com name: Stripe Dev Platform Team url: https://stripe.com termsOfService: https://stripe.com/us/terms/ version: '2023-10-16' x-stripeSpecFilename: spec3 servers: - url: https://api.stripe.com/ security: - basicAuth: [] - bearerAuth: [] tags: - name: Get paths: /v1/apps/secrets: get: description:

List all secrets stored on the given scope.

operationId: getAppsSecrets parameters: - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: Specifies the scoping of the secret. Requests originating from UI extensions can only access account-scoped secrets or secrets scoped to their own user. explode: true in: query name: scope required: true schema: properties: type: enum: - account - user type: string user: maxLength: 5000 type: string required: - type title: scope_param type: object style: deepObject - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false properties: {} type: object required: false responses: '200': content: application/json: schema: description: '' properties: data: items: $ref: '#/components/schemas/apps.secret' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/apps/secrets type: string required: - data - has_more - object - url title: SecretServiceResourceSecretList type: object x-expandableFields: - data description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Apps Secrets x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/apps/secrets/find: get: description:

Finds a secret in the secret store by name and scope.

operationId: getAppsSecretsFind parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A name for the secret that's unique within the scope. in: query name: name required: true schema: maxLength: 5000 type: string style: form - description: Specifies the scoping of the secret. Requests originating from UI extensions can only access account-scoped secrets or secrets scoped to their own user. explode: true in: query name: scope required: true schema: properties: type: enum: - account - user type: string user: maxLength: 5000 type: string required: - type title: scope_param type: object style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false properties: {} type: object required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/apps.secret' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Apps Secrets Find x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/balance: get: description: "

Retrieves the current account balance, based on the authentication that was used to make the request.\n For a sample request, see Accounting for negative balances.

" operationId: getBalance parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetBalanceRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/balance' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Balance x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/balance/history: get: description: '

Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and so forth). The transactions are returned in sorted order, with the most recent transactions appearing first.

Note that this endpoint was previously called “Balance history” and used the path /v1/balance/history.

' operationId: getBalanceHistory parameters: - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: Only return transactions in a certain currency. 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). in: query name: currency required: false schema: type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: For automatic Stripe payouts only, only returns transactions that were paid out on the specified payout ID. in: query name: payout required: false schema: maxLength: 5000 type: string style: form - description: Only returns the original transaction. in: query name: source required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: 'Only returns transactions of the given type. One of: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_inbound`, `obligation_outbound`, `obligation_reversal_inbound`, `obligation_reversal_outbound`, `obligation_payout`, `obligation_payout_failure`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`.' in: query name: type required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetBalanceHistoryRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/BalanceTransactionsList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Balance History x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/balance/history/{id}: get: description: '

Retrieves the balance transaction with the given ID.

Note that this endpoint previously used the path /v1/balance/history/:id.

' operationId: getBalanceHistoryId parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: id required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetBalanceHistoryIdRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/balance_transaction' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Balance History Id x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/balance_transactions: get: description: '

Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and so forth). The transactions are returned in sorted order, with the most recent transactions appearing first.

Note that this endpoint was previously called “Balance history” and used the path /v1/balance/history.

' operationId: getBalanceTransactions parameters: - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: Only return transactions in a certain currency. 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). in: query name: currency required: false schema: type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: For automatic Stripe payouts only, only returns transactions that were paid out on the specified payout ID. in: query name: payout required: false schema: maxLength: 5000 type: string style: form - description: Only returns the original transaction. in: query name: source required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: 'Only returns transactions of the given type. One of: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_inbound`, `obligation_outbound`, `obligation_reversal_inbound`, `obligation_reversal_outbound`, `obligation_payout`, `obligation_payout_failure`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`.' in: query name: type required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetBalanceTransactionsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/BalanceTransactionsList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Balance Transactions x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/balance_transactions/{id}: get: description: '

Retrieves the balance transaction with the given ID.

Note that this endpoint previously used the path /v1/balance/history/:id.

' operationId: getBalanceTransactionsId parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: id required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetBalanceTransactionsIdRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/balance_transaction' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Balance Transactions Id x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/billing_portal/configurations: get: description:

Returns a list of configurations that describe the functionality of the customer portal.

operationId: getBillingPortalConfigurations parameters: - description: Only return configurations that are active or inactive (e.g., pass `true` to only list active configurations). in: query name: active required: false schema: type: boolean style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: Only return the default or non-default configurations (e.g., pass `true` to only list the default configuration). in: query name: is_default required: false schema: type: boolean style: form - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetBillingPortalConfigurationsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PortalPublicResourceConfigurationList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Billing Portal Configurations x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/billing_portal/configurations/{configuration}: get: description:

Retrieves a configuration that describes the functionality of the customer portal.

operationId: getBillingPortalConfigurationsConfiguration parameters: - in: path name: configuration required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetBillingPortalConfigurationsConfigurationRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/billing_portal.configuration' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Billing Portal Configurations Configuration x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/checkout/sessions: get: description:

Returns a list of Checkout Sessions.

operationId: getCheckoutSessions parameters: - description: Only return the Checkout Sessions that were created during the given date interval. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: Only return the Checkout Sessions for the Customer specified. in: query name: customer required: false schema: maxLength: 5000 type: string style: form - description: Only return the Checkout Sessions for the Customer details specified. explode: true in: query name: customer_details required: false schema: properties: email: type: string required: - email title: customer_details_params type: object style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: Only return the Checkout Session for the PaymentIntent specified. in: query name: payment_intent required: false schema: maxLength: 5000 type: string style: form - description: Only return the Checkout Sessions for the Payment Link specified. in: query name: payment_link required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Only return the Checkout Sessions matching the given status. in: query name: status required: false schema: enum: - complete - expired - open type: string style: form - description: Only return the Checkout Session for the subscription specified. in: query name: subscription required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCheckoutSessionsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PaymentPagesCheckoutSessionList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Checkout Sessions x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/checkout/sessions/{session}: get: description:

Retrieves a Session object.

operationId: getCheckoutSessionsSession parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: session required: true schema: maxLength: 66 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCheckoutSessionsSessionRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/checkout.session' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Checkout Sessions Session x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/checkout/sessions/{session}/line_items: get: description:

When retrieving a Checkout Session, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.

operationId: getCheckoutSessionsSessionLineItems parameters: - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - in: path name: session required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCheckoutSessionsSessionLineItemsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PaymentPagesCheckoutSessionListLineItems' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Checkout Sessions Session Line Items x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/country_specs: get: description:

Lists all Country Spec objects available in the API.

operationId: getCountrySpecs parameters: - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCountrySpecsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/CountrySpecList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Country Specs x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/country_specs/{country}: get: description:

Returns a Country Spec for a given Country code.

operationId: getCountrySpecsCountry parameters: - in: path name: country required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCountrySpecsCountryRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/country_spec' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Country Specs Country x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/coupons: get: description:

Returns a list of your coupons.

operationId: getCoupons parameters: - description: A filter on the list, based on the object `created` field. The value can be a string with an integer Unix timestamp, or it can be a dictionary with a number of different query options. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCouponsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/CouponsResourceCouponList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Coupons x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true PullTagsFromSummary: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/coupons/{coupon}: get: description:

Retrieves the coupon with the given ID.

operationId: getCouponsCoupon parameters: - in: path name: coupon required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCouponsCouponRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/coupon' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Coupons Coupon x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true PullTagsFromSummary: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/credit_notes: get: description:

Returns a list of credit notes.

operationId: getCreditNotes parameters: - description: Only return credit notes for the customer specified by this customer ID. in: query name: customer required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: Only return credit notes for the invoice specified by this invoice ID. in: query name: invoice required: false schema: maxLength: 5000 type: string style: form - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCreditNotesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/CreditNotesList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Credit Notes x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/credit_notes/preview: get: description:

Get a preview of a credit note without creating it.

operationId: getCreditNotesPreview parameters: - description: The integer amount in cents (or local equivalent) representing the total amount of the credit note. in: query name: amount required: false schema: type: integer style: form - description: The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice. in: query name: credit_amount required: false schema: type: integer style: form - description: The date when this credit note is in effect. Same as `created` unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the credit note PDF. in: query name: effective_at required: false schema: format: unix-time type: integer style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: ID of the invoice. in: query name: invoice required: true schema: maxLength: 5000 type: string style: form - description: Line items that make up the credit note. explode: true in: query name: lines required: false schema: items: properties: amount: type: integer description: maxLength: 5000 type: string invoice_line_item: maxLength: 5000 type: string quantity: type: integer tax_amounts: anyOf: - items: properties: amount: type: integer tax_rate: maxLength: 5000 type: string taxable_amount: type: integer required: - amount - tax_rate - taxable_amount title: tax_amount_with_tax_rate_param type: object type: array - enum: - '' type: string tax_rates: anyOf: - items: maxLength: 5000 type: string type: array - enum: - '' type: string type: enum: - custom_line_item - invoice_line_item type: string unit_amount: type: integer unit_amount_decimal: format: decimal type: string required: - type title: credit_note_line_item_params type: object type: array style: deepObject - description: The credit note's memo appears on the credit note PDF. in: query name: memo required: false schema: maxLength: 5000 type: string style: form - description: Set of [key-value pairs](https://stripe.com/docs/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`. explode: true in: query name: metadata required: false schema: additionalProperties: type: string type: object style: deepObject - description: The integer amount in cents (or local equivalent) representing the amount that is credited outside of Stripe. in: query name: out_of_band_amount required: false schema: type: integer style: form - description: Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory` in: query name: reason required: false schema: enum: - duplicate - fraudulent - order_change - product_unsatisfactory type: string style: form - description: ID of an existing refund to link this credit note to. in: query name: refund required: false schema: type: string style: form - description: The integer amount in cents (or local equivalent) representing the amount to refund. If set, a refund will be created for the charge associated with the invoice. in: query name: refund_amount required: false schema: type: integer style: form - description: When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. explode: true in: query name: shipping_cost required: false schema: properties: shipping_rate: maxLength: 5000 type: string title: credit_note_shipping_cost type: object style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCreditNotesPreviewRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/credit_note' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Credit Notes Preview x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/credit_notes/preview/lines: get: description:

When retrieving a credit note preview, you’ll get a lines property containing the first handful of those items. This URL you can retrieve the full (paginated) list of line items.

operationId: getCreditNotesPreviewLines parameters: - description: The integer amount in cents (or local equivalent) representing the total amount of the credit note. in: query name: amount required: false schema: type: integer style: form - description: The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice. in: query name: credit_amount required: false schema: type: integer style: form - description: The date when this credit note is in effect. Same as `created` unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the credit note PDF. in: query name: effective_at required: false schema: format: unix-time type: integer style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: ID of the invoice. in: query name: invoice required: true schema: maxLength: 5000 type: string style: form - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: Line items that make up the credit note. explode: true in: query name: lines required: false schema: items: properties: amount: type: integer description: maxLength: 5000 type: string invoice_line_item: maxLength: 5000 type: string quantity: type: integer tax_amounts: anyOf: - items: properties: amount: type: integer tax_rate: maxLength: 5000 type: string taxable_amount: type: integer required: - amount - tax_rate - taxable_amount title: tax_amount_with_tax_rate_param type: object type: array - enum: - '' type: string tax_rates: anyOf: - items: maxLength: 5000 type: string type: array - enum: - '' type: string type: enum: - custom_line_item - invoice_line_item type: string unit_amount: type: integer unit_amount_decimal: format: decimal type: string required: - type title: credit_note_line_item_params type: object type: array style: deepObject - description: The credit note's memo appears on the credit note PDF. in: query name: memo required: false schema: maxLength: 5000 type: string style: form - description: Set of [key-value pairs](https://stripe.com/docs/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`. explode: true in: query name: metadata required: false schema: additionalProperties: type: string type: object style: deepObject - description: The integer amount in cents (or local equivalent) representing the amount that is credited outside of Stripe. in: query name: out_of_band_amount required: false schema: type: integer style: form - description: Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory` in: query name: reason required: false schema: enum: - duplicate - fraudulent - order_change - product_unsatisfactory type: string style: form - description: ID of an existing refund to link this credit note to. in: query name: refund required: false schema: type: string style: form - description: The integer amount in cents (or local equivalent) representing the amount to refund. If set, a refund will be created for the charge associated with the invoice. in: query name: refund_amount required: false schema: type: integer style: form - description: When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. explode: true in: query name: shipping_cost required: false schema: properties: shipping_rate: maxLength: 5000 type: string title: credit_note_shipping_cost type: object style: deepObject - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCreditNotesPreviewLinesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/CreditNoteLinesList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Credit Notes Preview Lines x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/credit_notes/{credit_note}/lines: get: description:

When retrieving a credit note, you’ll get a lines property containing the the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.

operationId: getCreditNotesCreditNoteLines parameters: - in: path name: credit_note required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCreditNotesCreditNoteLinesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/CreditNoteLinesList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Credit Notes Credit Note Lines x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/credit_notes/{id}: get: description:

Retrieves the credit note object with the given identifier.

operationId: getCreditNotesId parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: id required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCreditNotesIdRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/credit_note' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Credit Notes Id x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers: get: description:

Returns a list of your customers. The customers are returned sorted by creation date, with the most recent customers appearing first.

operationId: getCustomers parameters: - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A case-sensitive filter on the list based on the customer's `email` field. The value must be a string. in: query name: email required: false schema: maxLength: 512 type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Provides a list of customers that are associated with the specified test clock. The response will not include customers with test clocks if this parameter is not set. in: query name: test_clock required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/CustomerResourceCustomerList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/search: get: description: '

Search for customers you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.

' operationId: getCustomersSearch parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results. in: query name: page required: false schema: maxLength: 5000 type: string style: form - description: The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for customers](https://stripe.com/docs/search#query-fields-for-customers). in: query name: query required: true schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersSearchRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/SearchResult' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Search x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}: get: description:

Retrieves a Customer object.

operationId: getCustomersCustomer parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerRequest' required: false responses: '200': content: application/json: schema: anyOf: - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/balance_transactions: get: description:

Returns a list of transactions that updated the customer’s balances.

operationId: getCustomersCustomerBalanceTransactions parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerBalanceTransactionsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/CustomerBalanceTransactionList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Balance Transactions x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/balance_transactions/{transaction}: get: description:

Retrieves a specific customer balance transaction that updated the customer’s balances.

operationId: getCustomersCustomerBalanceTransactionsTransaction parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: transaction required: true schema: type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerBalanceTransactionsTransactionRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/customer_balance_transaction' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Balance Transactions Transaction x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/bank_accounts: get: deprecated: true description:

You can see a list of the bank accounts belonging to a Customer. Note that the 10 most recent sources are always available by default on the Customer. If you need more than those 10, you can use this API method and the limit and starting_after parameters to page through additional bank accounts.

operationId: getCustomersCustomerBankAccounts parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerBankAccountsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/BankAccountList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Bank Accounts x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/bank_accounts/{id}: get: deprecated: true description:

By default, you can see the 10 most recent sources stored on a Customer directly on the object, but you can also retrieve details about a specific bank account stored on the Stripe account.

operationId: getCustomersCustomerBankAccountsId parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: id required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerBankAccountsIdRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/bank_account' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Bank Accounts Id x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/cards: get: deprecated: true description: '

You can see a list of the cards belonging to a customer. Note that the 10 most recent sources are always available on the Customer object. If you need more than those 10, you can use this API method and the limit and starting_after parameters to page through additional cards.

' operationId: getCustomersCustomerCards parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerCardsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/CardList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Cards x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/cards/{id}: get: deprecated: true description:

You can always see the 10 most recent cards directly on a customer; this method lets you retrieve details about a specific card stored on the customer.

operationId: getCustomersCustomerCardsId parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: id required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerCardsIdRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/card' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Cards Id x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/cash_balance: get: description:

Retrieves a customer’s cash balance.

operationId: getCustomersCustomerCashBalance parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerCashBalanceRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/cash_balance' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Cash Balance x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/cash_balance_transactions: get: description:

Returns a list of transactions that modified the customer’s cash balance.

operationId: getCustomersCustomerCashBalanceTransactions parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerCashBalanceTransactionsRequest' required: false responses: '200': content: application/json: schema: description: 'Customers with certain payments enabled have a cash balance, representing funds that were paid by the customer to a merchant, but have not yet been allocated to a payment. Cash Balance Transactions represent when funds are moved into or out of this balance. This includes funding by the customer, allocation to payments, and refunds to the customer.' x-expandableFields: - data $ref: '#/components/schemas/CustomerCashBalanceTransactionList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Cash Balance Transactions x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/cash_balance_transactions/{transaction}: get: description:

Retrieves a specific cash balance transaction, which updated the customer’s cash balance.

operationId: getCustomersCustomerCashBalanceTransactionsTransaction parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: transaction required: true schema: type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerCashBalanceTransactionsTransactionRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/customer_cash_balance_transaction' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Cash Balance Transactions Transaction x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/discount: get: description: '' operationId: getCustomersCustomerDiscount parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerDiscountRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/discount' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Discount x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/payment_methods: get: description:

Returns a list of PaymentMethods for a given Customer

operationId: getCustomersCustomerPaymentMethods parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: type: string style: form - description: An optional filter on the list, based on the object `type` field. Without the filter, the list includes all current and future payment method types. If your integration expects only one type of payment method in the response, make sure to provide a type value in the request. in: query name: type required: false schema: enum: - acss_debit - affirm - afterpay_clearpay - alipay - au_becs_debit - bacs_debit - bancontact - blik - boleto - card - cashapp - customer_balance - eps - fpx - giropay - grabpay - ideal - klarna - konbini - link - oxxo - p24 - paynow - paypal - pix - promptpay - revolut_pay - sepa_debit - sofort - us_bank_account - wechat_pay - zip type: string x-stripeBypassValidation: true style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerPaymentMethodsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/CustomerPaymentMethodResourceList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Payment Methods x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/payment_methods/{payment_method}: get: description:

Retrieves a PaymentMethod object for a given Customer.

operationId: getCustomersCustomerPaymentMethodsPaymentMethod parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: payment_method required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerPaymentMethodsPaymentMethodRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/payment_method' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Payment Methods Payment Method x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/sources: get: description:

List sources for a specified customer.

operationId: getCustomersCustomerSources parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: Filter sources according to a particular object type. in: query name: object required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerSourcesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/ApmsSourcesSourceList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Sources x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/sources/{id}: get: description:

Retrieve a specified source for a given customer.

operationId: getCustomersCustomerSourcesId parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: id required: true schema: maxLength: 500 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerSourcesIdRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/payment_source' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Sources Id x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/subscriptions: get: description:

You can see a list of the customer’s active subscriptions. Note that the 10 most recent active subscriptions are always available by default on the customer object. If you need more than those 10, you can use the limit and starting_after parameters to page through additional subscriptions.

operationId: getCustomersCustomerSubscriptions parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerSubscriptionsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/SubscriptionList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Subscriptions x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/subscriptions/{subscription_exposed_id}: get: description:

Retrieves the subscription with the given ID.

operationId: getCustomersCustomerSubscriptionsSubscriptionExposedId parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: subscription_exposed_id required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerSubscriptionsSubscriptionExposedIdRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/subscription' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Subscriptions Subscription Exposed Id x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/subscriptions/{subscription_exposed_id}/discount: get: description: '' operationId: getCustomersCustomerSubscriptionsSubscriptionExposedIdDiscount parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: subscription_exposed_id required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerSubscriptionsSubscriptionExposedIdDiscountRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/discount' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Subscriptions Subscription Exposed Id Discount x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/tax_ids: get: description:

Returns a list of tax IDs for a customer.

operationId: getCustomersCustomerTaxIds parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerTaxIdsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/TaxIDsList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Tax Ids x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/customers/{customer}/tax_ids/{id}: get: description:

Retrieves the tax_id object with the given identifier.

operationId: getCustomersCustomerTaxIdsId parameters: - in: path name: customer required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: id required: true schema: type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetCustomersCustomerTaxIdsIdRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/tax_id' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Customers Customer Tax Ids Id x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/disputes: get: description:

Returns a list of your disputes.

operationId: getDisputes parameters: - description: Only return disputes associated to the charge specified by this charge ID. in: query name: charge required: false schema: maxLength: 5000 type: string style: form - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: Only return disputes associated to the PaymentIntent specified by this PaymentIntent ID. in: query name: payment_intent required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetDisputesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/DisputeList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Disputes x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/disputes/{dispute}: get: description:

Retrieves the dispute with the given ID.

operationId: getDisputesDispute parameters: - in: path name: dispute required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetDisputesDisputeRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/dispute' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Disputes Dispute x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/events: get: description:

List events, going back up to 30 days. Each event data is rendered according to Stripe API version at its creation time, specified in event object api_version attribute (not according to your current Stripe API version or Stripe-Version header).

operationId: getEvents parameters: - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: Filter events by whether all webhooks were successfully delivered. If false, events which are still pending or have failed all delivery attempts to a webhook endpoint will be returned. in: query name: delivery_success required: false schema: type: boolean style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: A string containing a specific event name, or group of events using * as a wildcard. The list will be filtered to include only events with a matching event property. in: query name: type required: false schema: maxLength: 5000 type: string style: form - description: An array of up to 20 strings containing specific event names. The list will be filtered to include only events with a matching event property. You may pass either `type` or `types`, but not both. explode: true in: query name: types required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetEventsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/NotificationEventList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Events x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/events/{id}: get: description:

Retrieves the details of an event. Supply the unique identifier of the event, which you might have received in a webhook.

operationId: getEventsId parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: id required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetEventsIdRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/event' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Events Id x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/exchange_rates: get: description:

Returns a list of objects that contain the rates at which foreign currencies are converted to one another. Only shows the currencies for which Stripe supports.

operationId: getExchangeRates parameters: - description: A cursor for use in pagination. `ending_before` is the currency that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with the exchange rate for currency X your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and total number of supported payout currencies, and the default is the max. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is the currency that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with the exchange rate for currency X, your subsequent call can include `starting_after=X` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetExchangeRatesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/ExchangeRateList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Exchange Rates x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/exchange_rates/{rate_id}: get: description:

Retrieves the exchange rates from the given currency to every supported currency.

operationId: getExchangeRatesRateId parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: rate_id required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetExchangeRatesRateIdRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/exchange_rate' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Exchange Rates Rate Id x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/files: get: description:

Returns a list of the files that your account has access to. Stripe sorts and returns the files by their creation dates, placing the most recently created files at the top.

operationId: getFiles parameters: - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: Filter queries by the file purpose. If you don't provide a purpose, the queries return unfiltered files. in: query name: purpose required: false schema: enum: - account_requirement - additional_verification - business_icon - business_logo - customer_signature - dispute_evidence - document_provider_identity_document - finance_report_run - identity_document - identity_document_downloadable - pci_document - selfie - sigma_scheduled_query - tax_document_user_upload - terminal_reader_splashscreen maxLength: 5000 type: string x-stripeBypassValidation: true style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetFilesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/FileResourceFileList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Files x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/files/{file}: get: description:

Retrieves the details of an existing file object. After you supply a unique file ID, Stripe returns the corresponding file object. Learn how to access file contents.

operationId: getFilesFile parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: file required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetFilesFileRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/file' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Files File x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/financial_connections/accounts: get: description:

Returns a list of Financial Connections Account objects.

operationId: getFinancialConnectionsAccounts parameters: - description: If present, only return accounts that belong to the specified account holder. `account_holder[customer]` and `account_holder[account]` are mutually exclusive. explode: true in: query name: account_holder required: false schema: properties: account: maxLength: 5000 type: string customer: maxLength: 5000 type: string title: accountholder_params type: object style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: If present, only return accounts that were collected as part of the given session. in: query name: session required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetFinancialConnectionsAccountsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/BankConnectionsResourceLinkedAccountList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Financial Connections Accounts x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/financial_connections/accounts/{account}: get: description:

Retrieves the details of an Financial Connections Account.

operationId: getFinancialConnectionsAccountsAccount parameters: - in: path name: account required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetFinancialConnectionsAccountsAccountRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/financial_connections.account' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Financial Connections Accounts x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/financial_connections/accounts/{account}/owners: get: description:

Lists all owners for a given Account

operationId: getFinancialConnectionsAccountsAccountOwners parameters: - in: path name: account required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: The ID of the ownership object to fetch owners from. in: query name: ownership required: true schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetFinancialConnectionsAccountsAccountOwnersRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/BankConnectionsResourceOwnerList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Financial Connections Accounts Owners x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/financial_connections/sessions/{session}: get: description:

Retrieves the details of a Financial Connections Session

operationId: getFinancialConnectionsSessionsSession parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: session required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetFinancialConnectionsSessionsSessionRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/financial_connections.session' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Financial Connections Sessions Session x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/financial_connections/transactions: get: description:

Returns a list of Financial Connections Transaction objects.

operationId: getFinancialConnectionsTransactions parameters: - description: The ID of the Stripe account whose transactions will be retrieved. in: query name: account required: true schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: 'A filter on the list based on the object `transacted_at` field. The value can be a string with an integer Unix timestamp, or it can be a dictionary with the following options:' explode: true in: query name: transacted_at required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: 'A filter on the list based on the object `transaction_refresh` field. The value can be a dictionary with the following options:' explode: true in: query name: transaction_refresh required: false schema: properties: after: maxLength: 5000 type: string required: - after title: transaction_refresh_params type: object style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetFinancialConnectionsTransactionsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/BankConnectionsResourceTransactionList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Financial Connections Transactions x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/financial_connections/transactions/{transaction}: get: description:

Retrieves the details of a Financial Connections Transaction

operationId: getFinancialConnectionsTransactionsTransaction parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: transaction required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetFinancialConnectionsTransactionsTransactionRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/financial_connections.transaction' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Financial Connections Transactions Transaction x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/identity/verification_reports: get: description:

List all verification reports.

operationId: getIdentityVerificationReports parameters: - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Only return VerificationReports of this type in: query name: type required: false schema: enum: - document - id_number type: string x-stripeBypassValidation: true style: form - description: Only return VerificationReports created by this VerificationSession ID. It is allowed to provide a VerificationIntent ID. in: query name: verification_session required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIdentityVerificationReportsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/GelatoVerificationReportList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Identity Verification Reports x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/identity/verification_reports/{report}: get: description:

Retrieves an existing VerificationReport

operationId: getIdentityVerificationReportsReport parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: report required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIdentityVerificationReportsReportRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/identity.verification_report' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Identity Verification Reports Report x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/identity/verification_sessions: get: description:

Returns a list of VerificationSessions

operationId: getIdentityVerificationSessions parameters: - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Only return VerificationSessions with this status. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work). in: query name: status required: false schema: enum: - canceled - processing - requires_input - verified type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIdentityVerificationSessionsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/GelatoVerificationSessionList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Identity Verification Sessions x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/identity/verification_sessions/{session}: get: description: '

Retrieves the details of a VerificationSession that was previously created.

When the session status is requires_input, you can use this method to retrieve a valid client_secret or url to allow re-submission.

' operationId: getIdentityVerificationSessionsSession parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: session required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIdentityVerificationSessionsSessionRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/identity.verification_session' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Identity Verification Sessions Session x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/Invoice Items: get: description:

Returns a list of your invoice items. Invoice items are returned sorted by creation date, with the most recently created invoice items appearing first.

operationId: getInvoice Items parameters: - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: The identifier of the customer whose invoice items to return. If none is provided, all invoice items will be returned. in: query name: customer required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: Only return invoice items belonging to this invoice. If none is provided, all invoice items will be returned. If specifying an invoice, no customer identifier is needed. in: query name: invoice required: false schema: maxLength: 5000 type: string style: form - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: Set to `true` to only show pending invoice items, which are not yet attached to any invoices. Set to `false` to only show invoice items already attached to invoices. If unspecified, no filter is applied. in: query name: pending required: false schema: type: boolean style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetInvoice ItemsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/InvoicesItemsList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Invoice Items x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/Invoice Items/{invoiceitem}: get: description:

Retrieves the invoice item with the given ID.

operationId: getInvoice ItemsInvoiceitem parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: invoiceitem required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetInvoice ItemsInvoiceitemRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/invoiceitem' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Invoice Items x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/invoices: get: description:

You can list all invoices, or list the invoices for a specific customer. The invoices are returned sorted by creation date, with the most recently created invoices appearing first.

operationId: getInvoices parameters: - description: The collection method of the invoice to retrieve. Either `charge_automatically` or `send_invoice`. in: query name: collection_method required: false schema: enum: - charge_automatically - send_invoice type: string style: form - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: Only return invoices for the customer specified by this customer ID. in: query name: customer required: false schema: maxLength: 5000 type: string style: form - explode: true in: query name: due_date required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://stripe.com/docs/billing/invoices/workflow#workflow-overview) in: query name: status required: false schema: enum: - draft - open - paid - uncollectible - void type: string x-stripeBypassValidation: true style: form - description: Only return invoices for the subscription specified by this subscription ID. in: query name: subscription required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetInvoicesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/InvoicesList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Invoices x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/invoices/search: get: description: '

Search for invoices you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.

' operationId: getInvoicesSearch parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results. in: query name: page required: false schema: maxLength: 5000 type: string style: form - description: The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for invoices](https://stripe.com/docs/search#query-fields-for-invoices). in: query name: query required: true schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetInvoicesSearchRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/SearchResult_2' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Invoices Search x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/invoices/upcoming: get: description: '

At any time, you can preview the upcoming invoice for a customer. This will show you all the charges that are pending, including subscription renewal charges, invoice item charges, etc. It will also show you any discounts that are applicable to the invoice.

Note that when you are viewing an upcoming invoice, you are simply viewing a preview – the invoice has not yet been created. As such, the upcoming invoice will not show up in invoice listing calls, and you cannot use the API to pay or edit the invoice. If you want to change the amount that your customer will be billed, you can add, remove, or update pending invoice items, or update the customer’s discount.

You can preview the effects of updating a subscription, including a preview of what proration will take place. To ensure that the actual proration is calculated exactly the same as the previewed proration, you should pass a proration_date parameter when doing the actual subscription update. The value passed in should be the same as the subscription_proration_date returned on the upcoming invoice resource. The recommended way to get only the prorations being previewed is to consider only proration line items where period[start] is equal to the subscription_proration_date on the upcoming invoice resource.

' operationId: getInvoicesUpcoming parameters: - description: Settings for automatic tax lookup for this invoice preview. explode: true in: query name: automatic_tax required: false schema: properties: enabled: type: boolean required: - enabled title: automatic_tax_param type: object style: deepObject - description: The code of the coupon to apply. If `subscription` or `subscription_items` is provided, the invoice returned will preview updating or creating a subscription with that coupon. Otherwise, it will preview applying that coupon to the customer for the next upcoming invoice from among the customer's subscriptions. The invoice can be previewed without a coupon by passing this value as an empty string. in: query name: coupon required: false schema: maxLength: 5000 type: string style: form - description: The currency to preview this invoice in. Defaults to that of `customer` if not specified. in: query name: currency required: false schema: type: string style: form - description: The identifier of the customer whose upcoming invoice you'd like to retrieve. If `automatic_tax` is enabled then one of `customer`, `customer_details`, `subscription`, or `schedule` must be set. in: query name: customer required: false schema: maxLength: 5000 type: string style: form - description: Details about the customer you want to invoice or overrides for an existing customer. If `automatic_tax` is enabled then one of `customer`, `customer_details`, `subscription`, or `schedule` must be set. explode: true in: query name: customer_details required: false schema: properties: address: anyOf: - properties: city: maxLength: 5000 type: string country: maxLength: 5000 type: string line1: maxLength: 5000 type: string line2: maxLength: 5000 type: string postal_code: maxLength: 5000 type: string state: maxLength: 5000 type: string title: optional_fields_address type: object - enum: - '' type: string shipping: anyOf: - properties: address: properties: city: maxLength: 5000 type: string country: maxLength: 5000 type: string line1: maxLength: 5000 type: string line2: maxLength: 5000 type: string postal_code: maxLength: 5000 type: string state: maxLength: 5000 type: string title: optional_fields_address type: object name: maxLength: 5000 type: string phone: maxLength: 5000 type: string required: - address - name title: customer_shipping type: object - enum: - '' type: string tax: properties: ip_address: anyOf: - type: string - enum: - '' type: string title: tax_param type: object tax_exempt: enum: - '' - exempt - none - reverse type: string tax_ids: items: properties: type: enum: - ad_nrt - ae_trn - ar_cuit - au_abn - au_arn - bg_uic - bo_tin - br_cnpj - br_cpf - ca_bn - ca_gst_hst - ca_pst_bc - ca_pst_mb - ca_pst_sk - ca_qst - ch_vat - cl_tin - cn_tin - co_nit - cr_tin - do_rcn - ec_ruc - eg_tin - es_cif - eu_oss_vat - eu_vat - gb_vat - ge_vat - hk_br - hu_tin - id_npwp - il_vat - in_gst - is_vat - jp_cn - jp_rn - jp_trn - ke_pin - kr_brn - li_uid - mx_rfc - my_frp - my_itn - my_sst - no_vat - nz_gst - pe_ruc - ph_tin - ro_tin - rs_pib - ru_inn - ru_kpp - sa_vat - sg_gst - sg_uen - si_tin - sv_nit - th_vat - tr_tin - tw_vat - ua_vat - us_ein - uy_ruc - ve_rif - vn_tin - za_vat maxLength: 5000 type: string x-stripeBypassValidation: true value: type: string required: - type - value title: data_params type: object type: array title: customer_details_param type: object style: deepObject - description: The coupons to redeem into discounts for the invoice preview. If not specified, inherits the discount from the customer or subscription. This only works for coupons directly applied to the invoice. To apply a coupon to a subscription, you must use the `coupon` parameter instead. Pass an empty string to avoid inheriting any discounts. To preview the upcoming invoice for a subscription that hasn't been created, use `coupon` instead. explode: true in: query name: discounts required: false schema: anyOf: - items: properties: coupon: maxLength: 5000 type: string discount: maxLength: 5000 type: string title: discounts_data_param type: object type: array - enum: - '' type: string style: deepObject - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: List of invoice items to add or update in the upcoming invoice preview. explode: true in: query name: invoice_items required: false schema: items: properties: amount: type: integer currency: type: string description: maxLength: 5000 type: string discountable: type: boolean discounts: anyOf: - items: properties: coupon: maxLength: 5000 type: string discount: maxLength: 5000 type: string title: discounts_data_param type: object type: array - enum: - '' type: string invoiceitem: maxLength: 5000 type: string metadata: anyOf: - additionalProperties: type: string type: object - enum: - '' type: string period: properties: end: format: unix-time type: integer start: format: unix-time type: integer required: - end - start title: period type: object price: maxLength: 5000 type: string price_data: properties: currency: type: string product: maxLength: 5000 type: string tax_behavior: enum: - exclusive - inclusive - unspecified type: string unit_amount: type: integer unit_amount_decimal: format: decimal type: string required: - currency - product title: one_time_price_data type: object quantity: type: integer tax_behavior: enum: - exclusive - inclusive - unspecified type: string tax_code: anyOf: - type: string - enum: - '' type: string tax_rates: anyOf: - items: maxLength: 5000 type: string type: array - enum: - '' type: string unit_amount: type: integer unit_amount_decimal: format: decimal type: string title: invoice_item_preview_params type: object type: array style: deepObject - description: The identifier of the schedule whose upcoming invoice you'd like to retrieve. Cannot be used with subscription or subscription fields. in: query name: schedule required: false schema: maxLength: 5000 type: string style: form - description: The identifier of the subscription for which you'd like to retrieve the upcoming invoice. If not provided, but a `subscription_items` is provided, you will preview creating a subscription with those items. If neither `subscription` nor `subscription_items` is provided, you will retrieve the next upcoming invoice from among the customer's subscriptions. in: query name: subscription required: false schema: maxLength: 5000 type: string style: form - description: For new subscriptions, a future timestamp to anchor the subscription's [billing cycle](https://stripe.com/docs/subscriptions/billing-cycle). This is used to determine the date of the first full invoice, and, for plans with `month` or `year` intervals, the day of the month for subsequent invoices. For existing subscriptions, the value can only be set to `now` or `unchanged`. explode: true in: query name: subscription_billing_cycle_anchor required: false schema: anyOf: - enum: - now - unchanged maxLength: 5000 type: string - format: unix-time type: integer style: deepObject - description: A timestamp at which the subscription should cancel. If set to a date before the current period ends, this will cause a proration if prorations have been enabled using `proration_behavior`. If set during a future period, this will always cause a proration for that period. explode: true in: query name: subscription_cancel_at required: false schema: anyOf: - format: unix-time type: integer - enum: - '' type: string style: deepObject - description: Boolean indicating whether this subscription should cancel at the end of the current period. in: query name: subscription_cancel_at_period_end required: false schema: type: boolean style: form - description: This simulates the subscription being canceled or expired immediately. in: query name: subscription_cancel_now required: false schema: type: boolean style: form - description: If provided, the invoice returned will preview updating or creating a subscription with these default tax rates. The default tax rates will apply to any line item that does not have `tax_rates` set. explode: true in: query name: subscription_default_tax_rates required: false schema: anyOf: - items: maxLength: 5000 type: string type: array - enum: - '' type: string style: deepObject - description: A list of up to 20 subscription items, each with an attached price. explode: true in: query name: subscription_items required: false schema: items: properties: billing_thresholds: anyOf: - properties: usage_gte: type: integer required: - usage_gte title: item_billing_thresholds_param type: object - enum: - '' type: string clear_usage: type: boolean deleted: type: boolean id: maxLength: 5000 type: string metadata: anyOf: - additionalProperties: type: string type: object - enum: - '' type: string price: maxLength: 5000 type: string price_data: properties: currency: type: string product: maxLength: 5000 type: string recurring: properties: interval: enum: - day - month - week - year type: string interval_count: type: integer required: - interval title: recurring_adhoc type: object tax_behavior: enum: - exclusive - inclusive - unspecified type: string unit_amount: type: integer unit_amount_decimal: format: decimal type: string required: - currency - product - recurring title: recurring_price_data type: object quantity: type: integer tax_rates: anyOf: - items: maxLength: 5000 type: string type: array - enum: - '' type: string title: subscription_item_update_params type: object type: array style: deepObject - description: Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. in: query name: subscription_proration_behavior required: false schema: enum: - always_invoice - create_prorations - none type: string style: form - description: If previewing an update to a subscription, and doing proration, `subscription_proration_date` forces the proration to be calculated as though the update was done at the specified time. The time given must be within the current subscription period and within the current phase of the schedule backing this subscription, if the schedule exists. If set, `subscription`, and one of `subscription_items`, or `subscription_trial_end` are required. Also, `subscription_proration_behavior` cannot be set to 'none'. in: query name: subscription_proration_date required: false schema: format: unix-time type: integer style: form - description: For paused subscriptions, setting `subscription_resume_at` to `now` will preview the invoice that will be generated if the subscription is resumed. in: query name: subscription_resume_at required: false schema: enum: - now maxLength: 5000 type: string style: form - description: Date a subscription is intended to start (can be future or past). in: query name: subscription_start_date required: false schema: format: unix-time type: integer style: form - description: If provided, the invoice returned will preview updating or creating a subscription with that trial end. If set, one of `subscription_items` or `subscription` is required. explode: true in: query name: subscription_trial_end required: false schema: anyOf: - enum: - now maxLength: 5000 type: string - format: unix-time type: integer style: deepObject - description: Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `subscription_trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `subscription_trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more. in: query name: subscription_trial_from_plan required: false schema: type: boolean style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetInvoicesUpcomingRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/invoice' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Invoices Upcoming x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/invoices/upcoming/lines: get: description:

When retrieving an upcoming invoice, you’ll get a lines property containing the total count of line items and the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.

operationId: getInvoicesUpcomingLines parameters: - description: Settings for automatic tax lookup for this invoice preview. explode: true in: query name: automatic_tax required: false schema: properties: enabled: type: boolean required: - enabled title: automatic_tax_param type: object style: deepObject - description: The code of the coupon to apply. If `subscription` or `subscription_items` is provided, the invoice returned will preview updating or creating a subscription with that coupon. Otherwise, it will preview applying that coupon to the customer for the next upcoming invoice from among the customer's subscriptions. The invoice can be previewed without a coupon by passing this value as an empty string. in: query name: coupon required: false schema: maxLength: 5000 type: string style: form - description: The currency to preview this invoice in. Defaults to that of `customer` if not specified. in: query name: currency required: false schema: type: string style: form - description: The identifier of the customer whose upcoming invoice you'd like to retrieve. If `automatic_tax` is enabled then one of `customer`, `customer_details`, `subscription`, or `schedule` must be set. in: query name: customer required: false schema: maxLength: 5000 type: string style: form - description: Details about the customer you want to invoice or overrides for an existing customer. If `automatic_tax` is enabled then one of `customer`, `customer_details`, `subscription`, or `schedule` must be set. explode: true in: query name: customer_details required: false schema: properties: address: anyOf: - properties: city: maxLength: 5000 type: string country: maxLength: 5000 type: string line1: maxLength: 5000 type: string line2: maxLength: 5000 type: string postal_code: maxLength: 5000 type: string state: maxLength: 5000 type: string title: optional_fields_address type: object - enum: - '' type: string shipping: anyOf: - properties: address: properties: city: maxLength: 5000 type: string country: maxLength: 5000 type: string line1: maxLength: 5000 type: string line2: maxLength: 5000 type: string postal_code: maxLength: 5000 type: string state: maxLength: 5000 type: string title: optional_fields_address type: object name: maxLength: 5000 type: string phone: maxLength: 5000 type: string required: - address - name title: customer_shipping type: object - enum: - '' type: string tax: properties: ip_address: anyOf: - type: string - enum: - '' type: string title: tax_param type: object tax_exempt: enum: - '' - exempt - none - reverse type: string tax_ids: items: properties: type: enum: - ad_nrt - ae_trn - ar_cuit - au_abn - au_arn - bg_uic - bo_tin - br_cnpj - br_cpf - ca_bn - ca_gst_hst - ca_pst_bc - ca_pst_mb - ca_pst_sk - ca_qst - ch_vat - cl_tin - cn_tin - co_nit - cr_tin - do_rcn - ec_ruc - eg_tin - es_cif - eu_oss_vat - eu_vat - gb_vat - ge_vat - hk_br - hu_tin - id_npwp - il_vat - in_gst - is_vat - jp_cn - jp_rn - jp_trn - ke_pin - kr_brn - li_uid - mx_rfc - my_frp - my_itn - my_sst - no_vat - nz_gst - pe_ruc - ph_tin - ro_tin - rs_pib - ru_inn - ru_kpp - sa_vat - sg_gst - sg_uen - si_tin - sv_nit - th_vat - tr_tin - tw_vat - ua_vat - us_ein - uy_ruc - ve_rif - vn_tin - za_vat maxLength: 5000 type: string x-stripeBypassValidation: true value: type: string required: - type - value title: data_params type: object type: array title: customer_details_param type: object style: deepObject - description: The coupons to redeem into discounts for the invoice preview. If not specified, inherits the discount from the customer or subscription. This only works for coupons directly applied to the invoice. To apply a coupon to a subscription, you must use the `coupon` parameter instead. Pass an empty string to avoid inheriting any discounts. To preview the upcoming invoice for a subscription that hasn't been created, use `coupon` instead. explode: true in: query name: discounts required: false schema: anyOf: - items: properties: coupon: maxLength: 5000 type: string discount: maxLength: 5000 type: string title: discounts_data_param type: object type: array - enum: - '' type: string style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: List of invoice items to add or update in the upcoming invoice preview. explode: true in: query name: invoice_items required: false schema: items: properties: amount: type: integer currency: type: string description: maxLength: 5000 type: string discountable: type: boolean discounts: anyOf: - items: properties: coupon: maxLength: 5000 type: string discount: maxLength: 5000 type: string title: discounts_data_param type: object type: array - enum: - '' type: string invoiceitem: maxLength: 5000 type: string metadata: anyOf: - additionalProperties: type: string type: object - enum: - '' type: string period: properties: end: format: unix-time type: integer start: format: unix-time type: integer required: - end - start title: period type: object price: maxLength: 5000 type: string price_data: properties: currency: type: string product: maxLength: 5000 type: string tax_behavior: enum: - exclusive - inclusive - unspecified type: string unit_amount: type: integer unit_amount_decimal: format: decimal type: string required: - currency - product title: one_time_price_data type: object quantity: type: integer tax_behavior: enum: - exclusive - inclusive - unspecified type: string tax_code: anyOf: - type: string - enum: - '' type: string tax_rates: anyOf: - items: maxLength: 5000 type: string type: array - enum: - '' type: string unit_amount: type: integer unit_amount_decimal: format: decimal type: string title: invoice_item_preview_params type: object type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: The identifier of the schedule whose upcoming invoice you'd like to retrieve. Cannot be used with subscription or subscription fields. in: query name: schedule required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: The identifier of the subscription for which you'd like to retrieve the upcoming invoice. If not provided, but a `subscription_items` is provided, you will preview creating a subscription with those items. If neither `subscription` nor `subscription_items` is provided, you will retrieve the next upcoming invoice from among the customer's subscriptions. in: query name: subscription required: false schema: maxLength: 5000 type: string style: form - description: For new subscriptions, a future timestamp to anchor the subscription's [billing cycle](https://stripe.com/docs/subscriptions/billing-cycle). This is used to determine the date of the first full invoice, and, for plans with `month` or `year` intervals, the day of the month for subsequent invoices. For existing subscriptions, the value can only be set to `now` or `unchanged`. explode: true in: query name: subscription_billing_cycle_anchor required: false schema: anyOf: - enum: - now - unchanged maxLength: 5000 type: string - format: unix-time type: integer style: deepObject - description: A timestamp at which the subscription should cancel. If set to a date before the current period ends, this will cause a proration if prorations have been enabled using `proration_behavior`. If set during a future period, this will always cause a proration for that period. explode: true in: query name: subscription_cancel_at required: false schema: anyOf: - format: unix-time type: integer - enum: - '' type: string style: deepObject - description: Boolean indicating whether this subscription should cancel at the end of the current period. in: query name: subscription_cancel_at_period_end required: false schema: type: boolean style: form - description: This simulates the subscription being canceled or expired immediately. in: query name: subscription_cancel_now required: false schema: type: boolean style: form - description: If provided, the invoice returned will preview updating or creating a subscription with these default tax rates. The default tax rates will apply to any line item that does not have `tax_rates` set. explode: true in: query name: subscription_default_tax_rates required: false schema: anyOf: - items: maxLength: 5000 type: string type: array - enum: - '' type: string style: deepObject - description: A list of up to 20 subscription items, each with an attached price. explode: true in: query name: subscription_items required: false schema: items: properties: billing_thresholds: anyOf: - properties: usage_gte: type: integer required: - usage_gte title: item_billing_thresholds_param type: object - enum: - '' type: string clear_usage: type: boolean deleted: type: boolean id: maxLength: 5000 type: string metadata: anyOf: - additionalProperties: type: string type: object - enum: - '' type: string price: maxLength: 5000 type: string price_data: properties: currency: type: string product: maxLength: 5000 type: string recurring: properties: interval: enum: - day - month - week - year type: string interval_count: type: integer required: - interval title: recurring_adhoc type: object tax_behavior: enum: - exclusive - inclusive - unspecified type: string unit_amount: type: integer unit_amount_decimal: format: decimal type: string required: - currency - product - recurring title: recurring_price_data type: object quantity: type: integer tax_rates: anyOf: - items: maxLength: 5000 type: string type: array - enum: - '' type: string title: subscription_item_update_params type: object type: array style: deepObject - description: Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. in: query name: subscription_proration_behavior required: false schema: enum: - always_invoice - create_prorations - none type: string style: form - description: If previewing an update to a subscription, and doing proration, `subscription_proration_date` forces the proration to be calculated as though the update was done at the specified time. The time given must be within the current subscription period and within the current phase of the schedule backing this subscription, if the schedule exists. If set, `subscription`, and one of `subscription_items`, or `subscription_trial_end` are required. Also, `subscription_proration_behavior` cannot be set to 'none'. in: query name: subscription_proration_date required: false schema: format: unix-time type: integer style: form - description: For paused subscriptions, setting `subscription_resume_at` to `now` will preview the invoice that will be generated if the subscription is resumed. in: query name: subscription_resume_at required: false schema: enum: - now maxLength: 5000 type: string style: form - description: Date a subscription is intended to start (can be future or past). in: query name: subscription_start_date required: false schema: format: unix-time type: integer style: form - description: If provided, the invoice returned will preview updating or creating a subscription with that trial end. If set, one of `subscription_items` or `subscription` is required. explode: true in: query name: subscription_trial_end required: false schema: anyOf: - enum: - now maxLength: 5000 type: string - format: unix-time type: integer style: deepObject - description: Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `subscription_trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `subscription_trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more. in: query name: subscription_trial_from_plan required: false schema: type: boolean style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetInvoicesUpcomingLinesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/InvoiceLinesList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Invoices Upcoming Lines x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/invoices/{invoice}: get: description:

Retrieves the invoice with the given ID.

operationId: getInvoicesInvoice parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: invoice required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetInvoicesInvoiceRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/invoice' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Invoices Invoice x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/invoices/{invoice}/lines: get: description:

When retrieving an invoice, you’ll get a lines property containing the total count of line items and the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.

operationId: getInvoicesInvoiceLines parameters: - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: invoice required: true schema: maxLength: 5000 type: string style: simple - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetInvoicesInvoiceLinesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/InvoiceLinesList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Invoices Invoice Lines x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/authorizations: get: description:

Returns a list of Issuing Authorization objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.

operationId: getIssuingAuthorizations parameters: - description: Only return authorizations that belong to the given card. in: query name: card required: false schema: maxLength: 5000 type: string style: form - description: Only return authorizations that belong to the given cardholder. in: query name: cardholder required: false schema: maxLength: 5000 type: string style: form - description: Only return authorizations that were created during the given date interval. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Only return authorizations with the given status. One of `pending`, `closed`, or `reversed`. in: query name: status required: false schema: enum: - closed - pending - reversed type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingAuthorizationsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/IssuingAuthorizationList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Authorizations x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/authorizations/{authorization}: get: description:

Retrieves an Issuing Authorization object.

operationId: getIssuingAuthorizationsAuthorization parameters: - in: path name: authorization required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingAuthorizationsAuthorizationRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/issuing.authorization' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Authorizations x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/cardholders: get: description:

Returns a list of Issuing Cardholder objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.

operationId: getIssuingCardholders parameters: - description: Only return cardholders that were created during the given date interval. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: Only return cardholders that have the given email address. in: query name: email required: false schema: type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: Only return cardholders that have the given phone number. in: query name: phone_number required: false schema: type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Only return cardholders that have the given status. One of `active`, `inactive`, or `blocked`. in: query name: status required: false schema: enum: - active - blocked - inactive type: string style: form - description: Only return cardholders that have the given type. One of `individual` or `company`. in: query name: type required: false schema: enum: - company - individual type: string x-stripeBypassValidation: true style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingCardholdersRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/IssuingCardholderList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Cardholders x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/cardholders/{cardholder}: get: description:

Retrieves an Issuing Cardholder object.

operationId: getIssuingCardholdersCardholder parameters: - in: path name: cardholder required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingCardholdersCardholderRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/issuing.cardholder' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Cardholders x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/cards: get: description:

Returns a list of Issuing Card objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.

operationId: getIssuingCards parameters: - description: Only return cards belonging to the Cardholder with the provided ID. in: query name: cardholder required: false schema: maxLength: 5000 type: string style: form - description: Only return cards that were issued during the given date interval. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Only return cards that have the given expiration month. in: query name: exp_month required: false schema: type: integer style: form - description: Only return cards that have the given expiration year. in: query name: exp_year required: false schema: type: integer style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: Only return cards that have the given last four digits. in: query name: last4 required: false schema: maxLength: 5000 type: string style: form - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Only return cards that have the given status. One of `active`, `inactive`, or `canceled`. in: query name: status required: false schema: enum: - active - canceled - inactive type: string x-stripeBypassValidation: true style: form - description: Only return cards that have the given type. One of `virtual` or `physical`. in: query name: type required: false schema: enum: - physical - virtual type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingCardsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/IssuingCardList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Cards x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/cards/{card}: get: description:

Retrieves an Issuing Card object.

operationId: getIssuingCardsCard parameters: - in: path name: card required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingCardsCardRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/issuing.card' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Cards Card x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/disputes: get: description:

Returns a list of Issuing Dispute objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.

operationId: getIssuingDisputes parameters: - description: Select Issuing disputes that were created during the given date interval. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Select Issuing disputes with the given status. in: query name: status required: false schema: enum: - expired - lost - submitted - unsubmitted - won type: string style: form - description: Select the Issuing dispute for the given transaction. in: query name: transaction required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingDisputesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/IssuingDisputeList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Disputes x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/disputes/{dispute}: get: description:

Retrieves an Issuing Dispute object.

operationId: getIssuingDisputesDispute parameters: - in: path name: dispute required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingDisputesDisputeRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/issuing.dispute' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Disputes x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/settlements: get: description:

Returns a list of Issuing Settlement objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.

operationId: getIssuingSettlements parameters: - description: Only return issuing settlements that were created during the given date interval. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingSettlementsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/IssuingSettlementList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Settlements x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/settlements/{settlement}: get: description:

Retrieves an Issuing Settlement object.

operationId: getIssuingSettlementsSettlement parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: settlement required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingSettlementsSettlementRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/issuing.settlement' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Settlements Settlement x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/tokens: get: description:

Lists all Issuing Token objects for a given card.

operationId: getIssuingTokens parameters: - description: The Issuing card identifier to list tokens for. in: query name: card required: true schema: maxLength: 5000 type: string style: form - description: Select Issuing tokens that were created during the given date interval. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Select Issuing tokens with the given status. in: query name: status required: false schema: enum: - active - deleted - requested - suspended type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingTokensRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/IssuingNetworkTokenList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Tokens x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/tokens/{token}: get: description:

Retrieves an Issuing Token object.

operationId: getIssuingTokensToken parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: token required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingTokensTokenRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/issuing.token' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Tokens x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/transactions: get: description:

Returns a list of Issuing Transaction objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.

operationId: getIssuingTransactions parameters: - description: Only return transactions that belong to the given card. in: query name: card required: false schema: maxLength: 5000 type: string style: form - description: Only return transactions that belong to the given cardholder. in: query name: cardholder required: false schema: maxLength: 5000 type: string style: form - description: Only return transactions that were created during the given date interval. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Only return transactions that have the given type. One of `capture` or `refund`. in: query name: type required: false schema: enum: - capture - refund type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingTransactionsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/IssuingTransactionList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Transactions x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/issuing/transactions/{transaction}: get: description:

Retrieves an Issuing Transaction object.

operationId: getIssuingTransactionsTransaction parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: transaction required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetIssuingTransactionsTransactionRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/issuing.transaction' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Issuing Transactions x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/link_account_sessions/{session}: get: description:

Retrieves the details of a Financial Connections Session

operationId: getLinkAccountSessionsSession parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: session required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetLinkAccountSessionsSessionRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/financial_connections.session' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Link Account Sessions Session x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/linked_accounts: get: description:

Returns a list of Financial Connections Account objects.

operationId: getLinkedAccounts parameters: - description: If present, only return accounts that belong to the specified account holder. `account_holder[customer]` and `account_holder[account]` are mutually exclusive. explode: true in: query name: account_holder required: false schema: properties: account: maxLength: 5000 type: string customer: maxLength: 5000 type: string title: accountholder_params type: object style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: If present, only return accounts that were collected as part of the given session. in: query name: session required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetLinkedAccountsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/BankConnectionsResourceLinkedAccountList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Linked Accounts x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/linked_accounts/{account}: get: description:

Retrieves the details of an Financial Connections Account.

operationId: getLinkedAccountsAccount parameters: - in: path name: account required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetLinkedAccountsAccountRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/financial_connections.account' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Linked Accounts x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/linked_accounts/{account}/owners: get: description:

Lists all owners for a given Account

operationId: getLinkedAccountsAccountOwners parameters: - in: path name: account required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: The ID of the ownership object to fetch owners from. in: query name: ownership required: true schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetLinkedAccountsAccountOwnersRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/BankConnectionsResourceOwnerList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Linked Accounts Owners x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_intents: get: description:

Returns a list of PaymentIntents.

operationId: getPaymentIntents parameters: - description: A filter on the list, based on the object `created` field. The value can be a string with an integer Unix timestamp or a dictionary with a number of different query options. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: Only return PaymentIntents for the customer that this customer ID specifies. in: query name: customer required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentIntentsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PaymentFlowsPaymentIntentList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Intents x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_intents/search: get: description: '

Search for PaymentIntents you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.

' operationId: getPaymentIntentsSearch parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results. in: query name: page required: false schema: maxLength: 5000 type: string style: form - description: The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for payment intents](https://stripe.com/docs/search#query-fields-for-payment-intents). in: query name: query required: true schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentIntentsSearchRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/SearchResult_3' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Intents Search x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_intents/{intent}: get: description: '

Retrieves the details of a PaymentIntent that has previously been created.

You can retrieve a PaymentIntent client-side using a publishable key when the client_secret is in the query string.

If you retrieve a PaymentIntent with a publishable key, it only returns a subset of properties. Refer to the payment intent object reference for more details.

' operationId: getPaymentIntentsIntent parameters: - description: The client secret of the PaymentIntent. We require it if you use a publishable key to retrieve the source. in: query name: client_secret required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: intent required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentIntentsIntentRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/payment_intent' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Intents x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_links: get: description:

Returns a list of your payment links.

operationId: getPaymentLinks parameters: - description: Only return payment links that are active or inactive (e.g., pass `false` to list all inactive payment links). in: query name: active required: false schema: type: boolean style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentLinksRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PaymentLinksResourcePaymentLinkList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Links x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_links/{payment_link}: get: description:

Retrieve a payment link.

operationId: getPaymentLinksPaymentLink parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: payment_link required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentLinksPaymentLinkRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/payment_link' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Links x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_links/{payment_link}/line_items: get: description:

When retrieving a payment link, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.

operationId: getPaymentLinksPaymentLinkLineItems parameters: - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - in: path name: payment_link required: true schema: maxLength: 5000 type: string style: simple - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentLinksPaymentLinkLineItemsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PaymentLinksResourceListLineItems' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Links Line Items x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_method_configurations: get: description:

List payment method configurations

operationId: getPaymentMethodConfigurations parameters: - description: The Connect application to filter by. explode: true in: query name: application required: false schema: anyOf: - maxLength: 100 type: string - enum: - '' type: string style: deepObject - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentMethodConfigurationsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PaymentMethodConfigResourcePaymentMethodConfigurationsList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Method Configurations x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_method_configurations/{configuration}: get: description:

Retrieve payment method configuration

operationId: getPaymentMethodConfigurationsConfiguration parameters: - in: path name: configuration required: true schema: maxLength: 5000 type: string style: simple - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentMethodConfigurationsConfigurationRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/payment_method_configuration' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Method Configurations x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_method_domains: get: description:

Lists the details of existing payment method domains.

operationId: getPaymentMethodDomains parameters: - description: The domain name that this payment method domain object represents. in: query name: domain_name required: false schema: maxLength: 5000 type: string style: form - description: Whether this payment method domain is enabled. If the domain is not enabled, payment methods will not appear in Elements in: query name: enabled required: false schema: type: boolean style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentMethodDomainsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PaymentMethodDomainResourcePaymentMethodDomainList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Method Domains x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_method_domains/{payment_method_domain}: get: description:

Retrieves the details of an existing payment method domain.

operationId: getPaymentMethodDomainsPaymentMethodDomain parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: payment_method_domain required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentMethodDomainsPaymentMethodDomainRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/payment_method_domain' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Method Domains x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_methods: get: description:

Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the List a Customer’s PaymentMethods API instead.

operationId: getPaymentMethods parameters: - description: The ID of the customer whose PaymentMethods will be retrieved. in: query name: customer required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: type: string style: form - description: An optional filter on the list, based on the object `type` field. Without the filter, the list includes all current and future payment method types. If your integration expects only one type of payment method in the response, make sure to provide a type value in the request. in: query name: type required: false schema: enum: - acss_debit - affirm - afterpay_clearpay - alipay - au_becs_debit - bacs_debit - bancontact - blik - boleto - card - cashapp - customer_balance - eps - fpx - giropay - grabpay - ideal - klarna - konbini - link - oxxo - p24 - paynow - paypal - pix - promptpay - revolut_pay - sepa_debit - sofort - us_bank_account - wechat_pay - zip type: string x-stripeBypassValidation: true style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentMethodsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PaymentFlowsPaymentMethodList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Methods x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payment_methods/{payment_method}: get: description:

Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a Customer, you should use Retrieve a Customer’s PaymentMethods

operationId: getPaymentMethodsPaymentMethod parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: payment_method required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPaymentMethodsPaymentMethodRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/payment_method' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payment Methods x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payouts: get: description:

Returns a list of existing payouts sent to third-party bank accounts or payouts that Stripe sent to you. The payouts return in sorted order, with the most recently created payouts appearing first.

operationId: getPayouts parameters: - explode: true in: query name: arrival_date required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: The ID of an external account - only return payouts sent to this external account. in: query name: destination required: false schema: type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: 'Only return payouts that have the given status: `pending`, `paid`, `failed`, or `canceled`.' in: query name: status required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPayoutsRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PayoutList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payouts x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/payouts/{payout}: get: description:

Retrieves the details of an existing payout. Supply the unique payout ID from either a payout creation request or the payout list. Stripe returns the corresponding payout information.

operationId: getPayoutsPayout parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: payout required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPayoutsPayoutRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/payout' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Payouts x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/plans: get: description:

Returns a list of your plans.

operationId: getPlans parameters: - description: Only return plans that are active or inactive (e.g., pass `false` to list all inactive plans). in: query name: active required: false schema: type: boolean style: form - description: A filter on the list, based on the object `created` field. The value can be a string with an integer Unix timestamp, or it can be a dictionary with a number of different query options. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: Only return plans for the given product. in: query name: product required: false schema: maxLength: 5000 type: string style: form - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPlansRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PlanList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Plans x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/plans/{plan}: get: description:

Retrieves the plan with the given ID.

operationId: getPlansPlan parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: plan required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPlansPlanRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/plan' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Plans x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/prices: get: description:

Returns a list of your active prices, excluding inline prices. For the list of inactive prices, set active to false.

operationId: getPrices parameters: - description: Only return prices that are active or inactive (e.g., pass `false` to list all inactive prices). in: query name: active required: false schema: type: boolean style: form - description: A filter on the list, based on the object `created` field. The value can be a string with an integer Unix timestamp, or it can be a dictionary with a number of different query options. explode: true in: query name: created required: false schema: anyOf: - properties: gt: type: integer gte: type: integer lt: type: integer lte: type: integer title: range_query_specs type: object - type: integer style: deepObject - description: Only return prices for the given currency. in: query name: currency required: false schema: type: string style: form - description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. in: query name: ending_before required: false schema: maxLength: 5000 type: string style: form - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: Only return the price with these lookup_keys, if any exist. explode: true in: query name: lookup_keys required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: Only return prices for the given product. in: query name: product required: false schema: maxLength: 5000 type: string style: form - description: Only return prices with these recurring fields. explode: true in: query name: recurring required: false schema: properties: interval: enum: - day - month - week - year type: string usage_type: enum: - licensed - metered type: string title: all_prices_recurring_params type: object style: deepObject - description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. in: query name: starting_after required: false schema: maxLength: 5000 type: string style: form - description: Only return prices of type `recurring` or `one_time`. in: query name: type required: false schema: enum: - one_time - recurring type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPricesRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/PriceList' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Prices x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/prices/search: get: description: '

Search for prices you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.

' operationId: getPricesSearch parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. in: query name: limit required: false schema: type: integer style: form - description: A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results. in: query name: page required: false schema: maxLength: 5000 type: string style: form - description: The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for prices](https://stripe.com/docs/search#query-fields-for-prices). in: query name: query required: true schema: maxLength: 5000 type: string style: form requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPricesSearchRequest' required: false responses: '200': content: application/json: schema: description: '' x-expandableFields: - data $ref: '#/components/schemas/SearchResult_4' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Prices Search x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get /v1/prices/{price}: get: description:

Retrieves the price with the given ID.

operationId: getPricesPrice parameters: - description: Specifies which fields in the response should be expanded. explode: true in: query name: expand required: false schema: items: maxLength: 5000 type: string type: array style: deepObject - in: path name: price required: true schema: maxLength: 5000 type: string style: simple requestBody: content: application/x-www-form-urlencoded: encoding: {} schema: additionalProperties: false $ref: '#/components/schemas/GetPricesPriceRequest' required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/price' description: Successful response. default: content: application/json: schema: $ref: '#/components/schemas/error' description: Error response. summary: Stripe Get Prices x-api-evangelist-processing: GenerateOperationSummariesFromPath: true PascalCaseOperationSummaries: true CaselCaseOperationIds: true ChooseTags: true tags: - Get components: schemas: BalanceTransactionsList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/balance_transaction' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/balance_transactions type: string payment_method_configuration: description: 'PaymentMethodConfigurations control which payment methods are displayed to your customers when you don''t explicitly specify payment method types. You can have multiple configurations with different sets of payment methods for different scenarios. There are two types of PaymentMethodConfigurations. Which is used depends on the [charge type](https://stripe.com/docs/connect/charges): **Direct** configurations apply to payments created on your account, including Connect destination charges, Connect separate charges and transfers, and payments not involving Connect. **Child** configurations apply to payments created on your connected accounts using direct charges, and charges with the on_behalf_of parameter. Child configurations have a `parent` that sets default values and controls which settings connected accounts may override. You can specify a parent ID at payment time, and Stripe will automatically resolve the connected account’s associated child configuration. Parent configurations are [managed in the dashboard](https://dashboard.stripe.com/settings/payment_methods/connected_accounts) and are not available in this API. Related guides: - [Payment Method Configurations API](https://stripe.com/docs/connect/payment-method-configurations) - [Multiple configurations on dynamic payment methods](https://stripe.com/docs/payments/multiple-payment-method-configs) - [Multiple configurations for your Connect accounts](https://stripe.com/docs/connect/multiple-payment-method-configurations)' properties: acss_debit: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' active: description: Whether the configuration can be used for new payments. type: boolean affirm: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' afterpay_clearpay: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' alipay: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' apple_pay: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' application: description: For child configs, the Connect application associated with the configuration. maxLength: 5000 nullable: true type: string au_becs_debit: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' bacs_debit: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' bancontact: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' blik: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' boleto: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' card: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' cartes_bancaires: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' cashapp: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' eps: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' fpx: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' giropay: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' google_pay: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' grabpay: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' id: description: Unique identifier for the object. maxLength: 5000 type: string ideal: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' is_default: description: The default configuration is used whenever a payment method configuration is not specified. type: boolean jcb: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' klarna: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' konbini: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' link: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean name: description: The configuration's name. maxLength: 5000 type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - payment_method_configuration type: string oxxo: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' p24: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' parent: description: For child configs, the configuration's parent configuration. maxLength: 5000 nullable: true type: string paynow: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' paypal: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' promptpay: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' revolut_pay: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' sepa_debit: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' sofort: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' us_bank_account: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' wechat_pay: $ref: '#/components/schemas/payment_method_config_resource_payment_method_properties' required: - active - id - is_default - livemode - name - object title: PaymentMethodConfigResourcePaymentMethodConfiguration type: object x-expandableFields: - acss_debit - affirm - afterpay_clearpay - alipay - apple_pay - au_becs_debit - bacs_debit - bancontact - blik - boleto - card - cartes_bancaires - cashapp - eps - fpx - giropay - google_pay - grabpay - ideal - jcb - klarna - konbini - link - oxxo - p24 - paynow - paypal - promptpay - revolut_pay - sepa_debit - sofort - us_bank_account - wechat_pay x-resourceId: payment_method_configuration GetPaymentLinksPaymentLinkLineItemsRequest: type: object properties: {} SearchResult_4: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/price' type: array has_more: type: boolean next_page: maxLength: 5000 nullable: true type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - search_result type: string total_count: description: The total number of objects that match the query, only accurate up to 10,000. type: integer url: maxLength: 5000 type: string GetCustomersCustomerTaxIdsRequest: type: object properties: {} GetCustomersCustomerCashBalanceRequest: type: object properties: {} coupon: description: 'A coupon contains information about a percent-off or amount-off discount you might want to apply to a customer. Coupons may be applied to [subscriptions](https://stripe.com/docs/api#subscriptions), [invoices](https://stripe.com/docs/api#invoices), [checkout sessions](https://stripe.com/docs/api/checkout/sessions), [quotes](https://stripe.com/docs/api#quotes), and more. Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge) or [payment intents](https://stripe.com/docs/api/payment_intents).' properties: amount_off: description: Amount (in the `currency` specified) that will be taken off the subtotal of any invoices for this customer. nullable: true type: integer applies_to: $ref: '#/components/schemas/coupon_applies_to' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: If `amount_off` has been set, the three-letter [ISO code for the currency](https://stripe.com/docs/currencies) of the amount to take off. nullable: true type: string currency_options: additionalProperties: $ref: '#/components/schemas/coupon_currency_option' description: Coupons defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies). type: object duration: description: One of `forever`, `once`, and `repeating`. Describes how long a customer who applies this coupon will get the discount. enum: - forever - once - repeating type: string x-stripeBypassValidation: true duration_in_months: description: If `duration` is `repeating`, the number of months the coupon applies. Null if coupon `duration` is `forever` or `once`. nullable: true type: integer id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean max_redemptions: description: Maximum number of times this coupon can be redeemed, in total, across all customers, before it is no longer valid. nullable: true type: integer metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object name: description: Name of the coupon displayed to customers on for instance invoices or receipts. maxLength: 5000 nullable: true type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - coupon type: string percent_off: description: Percent that will be taken off the subtotal of any invoices for this customer for the duration of the coupon. For example, a coupon with percent_off of 50 will make a $ (or local equivalent)100 invoice $ (or local equivalent)50 instead. nullable: true type: number redeem_by: description: Date after which the coupon can no longer be redeemed. format: unix-time nullable: true type: integer times_redeemed: description: Number of times this coupon has been applied to a customer. type: integer valid: description: Taking account of the above properties, whether this coupon can still be applied to a customer. type: boolean required: - created - duration - id - livemode - object - times_redeemed - valid title: Coupon type: object x-expandableFields: - applies_to - currency_options x-resourceId: coupon SearchResult_3: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/payment_intent' type: array has_more: type: boolean next_page: maxLength: 5000 nullable: true type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - search_result type: string total_count: description: The total number of objects that match the query, only accurate up to 10,000. type: integer url: maxLength: 5000 type: string checkout.session: description: 'A Checkout Session represents your customer''s session as they pay for one-time purchases or subscriptions through [Checkout](https://stripe.com/docs/payments/checkout) or [Payment Links](https://stripe.com/docs/payments/payment-links). We recommend creating a new Session each time your customer attempts to pay. Once payment is successful, the Checkout Session will contain a reference to the [Customer](https://stripe.com/docs/api/customers), and either the successful [PaymentIntent](https://stripe.com/docs/api/payment_intents) or an active [Subscription](https://stripe.com/docs/api/subscriptions). You can create a Checkout Session on your server and redirect to its URL to begin Checkout. Related guide: [Checkout quickstart](https://stripe.com/docs/checkout/quickstart)' properties: after_expiration: anyOf: - $ref: '#/components/schemas/payment_pages_checkout_session_after_expiration' description: When set, provides configuration for actions to take if this Checkout Session expires. nullable: true allow_promotion_codes: description: Enables user redeemable promotion codes. nullable: true type: boolean amount_subtotal: description: Total of all items before discounts or taxes are applied. nullable: true type: integer amount_total: description: Total of all items after discounts and taxes are applied. nullable: true type: integer automatic_tax: $ref: '#/components/schemas/payment_pages_checkout_session_automatic_tax' billing_address_collection: description: Describes whether Checkout should collect the customer's billing address. enum: - auto - required nullable: true type: string cancel_url: description: If set, Checkout displays a back button and customers will be directed to this URL if they decide to cancel payment and return to your website. maxLength: 5000 nullable: true type: string client_reference_id: description: 'A unique string to reference the Checkout Session. This can be a customer ID, a cart ID, or similar, and can be used to reconcile the Session with your internal systems.' maxLength: 5000 nullable: true type: string client_secret: description: Client secret to be used when initializing Stripe.js embedded checkout. maxLength: 5000 nullable: true type: string consent: anyOf: - $ref: '#/components/schemas/payment_pages_checkout_session_consent' description: Results of `consent_collection` for this session. nullable: true consent_collection: anyOf: - $ref: '#/components/schemas/payment_pages_checkout_session_consent_collection' description: When set, provides configuration for the Checkout Session to gather active consent from customers. nullable: true created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). nullable: true type: string currency_conversion: anyOf: - $ref: '#/components/schemas/payment_pages_checkout_session_currency_conversion' description: Currency conversion details for automatic currency conversion sessions nullable: true custom_fields: description: Collect additional information from your customer using custom fields. Up to 2 fields are supported. items: $ref: '#/components/schemas/payment_pages_checkout_session_custom_fields' type: array custom_text: $ref: '#/components/schemas/payment_pages_checkout_session_custom_text' customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: 'The ID of the customer for this Session. For Checkout Sessions in `subscription` mode or Checkout Sessions with `customer_creation` set as `always` in `payment` mode, Checkout will create a new customer object based on information provided during the payment flow unless an existing customer was provided when the Session was created.' nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' customer_creation: description: Configure whether a Checkout Session creates a Customer when the Checkout Session completes. enum: - always - if_required nullable: true type: string customer_details: anyOf: - $ref: '#/components/schemas/payment_pages_checkout_session_customer_details' description: The customer details including the customer's tax exempt status and the customer's tax IDs. Only the customer's email is present on Sessions in `setup` mode. nullable: true customer_email: description: 'If provided, this value will be used when the Customer object is created. If not provided, customers will be asked to enter their email address. Use this parameter to prefill customer data if you already have an email on file. To access information about the customer once the payment flow is complete, use the `customer` attribute.' maxLength: 5000 nullable: true type: string expires_at: description: The timestamp at which the Checkout Session will expire. format: unix-time type: integer id: description: Unique identifier for the object. maxLength: 5000 type: string invoice: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/invoice' description: ID of the invoice created by the Checkout Session, if it exists. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/invoice' invoice_creation: anyOf: - $ref: '#/components/schemas/payment_pages_checkout_session_invoice_creation' description: Details on the state of invoice creation for the Checkout Session. nullable: true line_items: description: The line items purchased by the customer. properties: data: description: Details about each object. items: $ref: '#/components/schemas/item' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string required: - data - has_more - object - url title: PaymentPagesCheckoutSessionListLineItems type: object x-expandableFields: - data livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean locale: description: The IETF language tag of the locale Checkout is displayed in. If blank or `auto`, the browser's locale is used. enum: - auto - bg - cs - da - de - el - en - en-GB - es - es-419 - et - fi - fil - fr - fr-CA - hr - hu - id - it - ja - ko - lt - lv - ms - mt - nb - nl - pl - pt - pt-BR - ro - ru - sk - sl - sv - th - tr - vi - zh - zh-HK - zh-TW nullable: true type: string x-stripeBypassValidation: true metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object mode: description: The mode of the Checkout Session. enum: - payment - setup - subscription type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - checkout.session type: string payment_intent: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/payment_intent' description: The ID of the PaymentIntent for Checkout Sessions in `payment` mode. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/payment_intent' payment_link: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/payment_link' description: The ID of the Payment Link that created this Session. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/payment_link' payment_method_collection: description: Configure whether a Checkout Session should collect a payment method. enum: - always - if_required nullable: true type: string payment_method_configuration_details: anyOf: - $ref: '#/components/schemas/payment_method_config_biz_payment_method_configuration_details' description: Information about the payment method configuration used for this Checkout session if using dynamic payment methods. nullable: true payment_method_options: anyOf: - $ref: '#/components/schemas/checkout_session_payment_method_options' description: Payment-method-specific configuration for the PaymentIntent or SetupIntent of this CheckoutSession. nullable: true payment_method_types: description: 'A list of the types of payment methods (e.g. card) this Checkout Session is allowed to accept.' items: maxLength: 5000 type: string type: array payment_status: description: 'The payment status of the Checkout Session, one of `paid`, `unpaid`, or `no_payment_required`. You can use this value to decide when to fulfill your customer''s order.' enum: - no_payment_required - paid - unpaid type: string phone_number_collection: $ref: '#/components/schemas/payment_pages_checkout_session_phone_number_collection' recovered_from: description: The ID of the original expired Checkout Session that triggered the recovery flow. maxLength: 5000 nullable: true type: string redirect_on_completion: description: 'Applies to Checkout Sessions with `ui_mode: embedded`. By default, Stripe will always redirect to your return_url after a successful confirmation. If you set `redirect_on_completion: ''if_required''`, then we will only redirect if your user chooses a redirect-based payment method.' enum: - always - if_required - never type: string return_url: description: 'Applies to Checkout Sessions with `ui_mode: embedded`. The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method''s app or site.' maxLength: 5000 type: string setup_intent: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/setup_intent' description: The ID of the SetupIntent for Checkout Sessions in `setup` mode. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/setup_intent' shipping_address_collection: anyOf: - $ref: '#/components/schemas/payment_pages_checkout_session_shipping_address_collection' description: When set, provides configuration for Checkout to collect a shipping address from a customer. nullable: true shipping_cost: anyOf: - $ref: '#/components/schemas/payment_pages_checkout_session_shipping_cost' description: The details of the customer cost of shipping, including the customer chosen ShippingRate. nullable: true shipping_details: anyOf: - $ref: '#/components/schemas/shipping' description: Shipping information for this Checkout Session. nullable: true shipping_options: description: The shipping rate options applied to this Session. items: $ref: '#/components/schemas/payment_pages_checkout_session_shipping_option' type: array status: description: The status of the Checkout Session, one of `open`, `complete`, or `expired`. enum: - complete - expired - open nullable: true type: string submit_type: description: 'Describes the type of transaction being performed by Checkout in order to customize relevant text on the page, such as the submit button. `submit_type` can only be specified on Checkout Sessions in `payment` mode, but not Checkout Sessions in `subscription` or `setup` mode. Possible values are `auto`, `pay`, `book`, `donate`. If blank or `auto`, `pay` is used.' enum: - auto - book - donate - pay nullable: true type: string subscription: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/subscription' description: The ID of the subscription for Checkout Sessions in `subscription` mode. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/subscription' success_url: description: 'The URL the customer will be directed to after the payment or subscription creation is successful.' maxLength: 5000 nullable: true type: string tax_id_collection: $ref: '#/components/schemas/payment_pages_checkout_session_tax_id_collection' total_details: anyOf: - $ref: '#/components/schemas/payment_pages_checkout_session_total_details' description: Tax and discount details for the computed total amount. nullable: true ui_mode: description: The UI mode of the Session. Can be `hosted` (default) or `embedded`. enum: - embedded - hosted nullable: true type: string x-stripeBypassValidation: true url: description: 'The URL to the Checkout Session. Redirect customers to this URL to take them to Checkout. If you’re using [Custom Domains](https://stripe.com/docs/payments/checkout/custom-domains), the URL will use your subdomain. Otherwise, it’ll use `checkout.stripe.com.` This value is only present when the session is active.' maxLength: 5000 nullable: true type: string required: - automatic_tax - created - custom_fields - custom_text - expires_at - id - livemode - mode - object - payment_method_types - payment_status - shipping_options title: Session type: object x-expandableFields: - after_expiration - automatic_tax - consent - consent_collection - currency_conversion - custom_fields - custom_text - customer - customer_details - invoice - invoice_creation - line_items - payment_intent - payment_link - payment_method_configuration_details - payment_method_options - phone_number_collection - setup_intent - shipping_address_collection - shipping_cost - shipping_details - shipping_options - subscription - tax_id_collection - total_details x-resourceId: checkout.session InvoiceLinesList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/line_item' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string GetCustomersCustomerCashBalanceTransactionsTransactionRequest: type: object properties: {} financial_connections.session: description: A Financial Connections Session is the secure way to programmatically launch the client-side Stripe.js modal that lets your users link their accounts. properties: account_holder: anyOf: - $ref: '#/components/schemas/bank_connections_resource_accountholder' description: The account holder for whom accounts are collected in this session. nullable: true accounts: description: The accounts that were collected as part of this Session. properties: data: description: Details about each object. items: $ref: '#/components/schemas/financial_connections.account' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/financial_connections/accounts type: string required: - data - has_more - object - url title: BankConnectionsResourceLinkedAccountList type: object x-expandableFields: - data client_secret: description: A value that will be passed to the client to launch the authentication flow. maxLength: 5000 type: string filters: $ref: '#/components/schemas/bank_connections_resource_link_account_session_filters' id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. enum: - financial_connections.session type: string permissions: description: Permissions requested for accounts collected during this session. items: enum: - balances - ownership - payment_method - transactions type: string x-stripeBypassValidation: true type: array prefetch: description: Data features requested to be retrieved upon account creation. items: enum: - balances - ownership - transactions type: string x-stripeBypassValidation: true nullable: true type: array return_url: description: For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app. maxLength: 5000 type: string required: - accounts - client_secret - id - livemode - object - permissions title: BankConnectionsResourceLinkAccountSession type: object x-expandableFields: - account_holder - accounts - filters x-resourceId: financial_connections.session FileResourceFileList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/file' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/files type: string GetBillingPortalConfigurationsConfigurationRequest: type: object properties: {} SubscriptionList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/subscription' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string GetCountrySpecsCountryRequest: type: object properties: {} GetPaymentMethodConfigurationsRequest: type: object properties: {} GetPaymentIntentsIntentRequest: type: object properties: {} IssuingAuthorizationList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/issuing.authorization' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/issuing/authorizations type: string GetBalanceRequest: type: object properties: {} GetEventsIdRequest: type: object properties: {} GetPricesPriceRequest: type: object properties: {} country_spec: description: 'Stripe needs to collect certain pieces of information about each account created. These requirements can differ depending on the account''s country. The Country Specs API makes these rules available to your integration. You can also view the information from this API call as [an online guide](/docs/connect/required-verification-information).' properties: default_currency: description: The default currency for this country. This applies to both payment methods and bank accounts. maxLength: 5000 type: string id: description: Unique identifier for the object. Represented as the ISO country code for this country. maxLength: 5000 type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - country_spec type: string supported_bank_account_currencies: additionalProperties: items: maxLength: 5000 type: string type: array description: Currencies that can be accepted in the specific country (for transfers). type: object supported_payment_currencies: description: Currencies that can be accepted in the specified country (for payments). items: maxLength: 5000 type: string type: array supported_payment_methods: description: Payment methods available in the specified country. You may need to enable some payment methods (e.g., [ACH](https://stripe.com/docs/ach)) on your account before they appear in this list. The `stripe` payment method refers to [charging through your platform](https://stripe.com/docs/connect/destination-charges). items: maxLength: 5000 type: string type: array supported_transfer_countries: description: Countries that can accept transfers from the specified country. items: maxLength: 5000 type: string type: array verification_fields: $ref: '#/components/schemas/country_spec_verification_fields' required: - default_currency - id - object - supported_bank_account_currencies - supported_payment_currencies - supported_payment_methods - supported_transfer_countries - verification_fields title: CountrySpec type: object x-expandableFields: - verification_fields x-resourceId: country_spec GetCustomersCustomerBalanceTransactionsTransactionRequest: type: object properties: {} CustomerResourceCustomerList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/customer' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/customers type: string GetCheckoutSessionsRequest: type: object properties: {} financial_connections.account: description: A Financial Connections Account represents an account that exists outside of Stripe, to which you have been granted some degree of access. properties: account_holder: anyOf: - $ref: '#/components/schemas/bank_connections_resource_accountholder' description: The account holder that this account belongs to. nullable: true balance: anyOf: - $ref: '#/components/schemas/bank_connections_resource_balance' description: The most recent information about the account's balance. nullable: true balance_refresh: anyOf: - $ref: '#/components/schemas/bank_connections_resource_balance_refresh' description: The state of the most recent attempt to refresh the account balance. nullable: true category: description: The type of the account. Account category is further divided in `subcategory`. enum: - cash - credit - investment - other type: string created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer display_name: description: A human-readable name that has been assigned to this account, either by the account holder or by the institution. maxLength: 5000 nullable: true type: string id: description: Unique identifier for the object. maxLength: 5000 type: string institution_name: description: The name of the institution that holds this account. maxLength: 5000 type: string last4: description: The last 4 digits of the account number. If present, this will be 4 numeric characters. maxLength: 5000 nullable: true type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. enum: - financial_connections.account type: string ownership: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/financial_connections.account_ownership' description: The most recent information about the account's owners. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/financial_connections.account_ownership' ownership_refresh: anyOf: - $ref: '#/components/schemas/bank_connections_resource_ownership_refresh' description: The state of the most recent attempt to refresh the account owners. nullable: true permissions: description: The list of permissions granted by this account. items: enum: - balances - ownership - payment_method - transactions type: string nullable: true type: array status: description: The status of the link to the account. enum: - active - disconnected - inactive type: string subcategory: description: "If `category` is `cash`, one of:\n\n - `checking`\n - `savings`\n - `other`\n\nIf `category` is `credit`, one of:\n\n - `mortgage`\n - `line_of_credit`\n - `credit_card`\n - `other`\n\nIf `category` is `investment` or `other`, this will be `other`." enum: - checking - credit_card - line_of_credit - mortgage - other - savings type: string subscriptions: description: The list of data refresh subscriptions requested on this account. items: enum: - transactions type: string x-stripeBypassValidation: true nullable: true type: array supported_payment_method_types: description: The [PaymentMethod type](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type)(s) that can be created from this account. items: enum: - link - us_bank_account type: string type: array transaction_refresh: anyOf: - $ref: '#/components/schemas/bank_connections_resource_transaction_refresh' description: The state of the most recent attempt to refresh the account transactions. nullable: true required: - category - created - id - institution_name - livemode - object - status - subcategory - supported_payment_method_types title: BankConnectionsResourceLinkedAccount type: object x-expandableFields: - account_holder - balance - balance_refresh - ownership - ownership_refresh - transaction_refresh x-resourceId: financial_connections.account GetLinkedAccountsAccountRequest: type: object properties: {} GetCustomersCustomerSubscriptionsSubscriptionExposedIdDiscountRequest: type: object properties: {} TaxIDsList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/tax_id' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string CustomerCashBalanceTransactionList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/customer_cash_balance_transaction' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string file: description: 'This object represents files hosted on Stripe''s servers. You can upload files with the [create file](https://stripe.com/docs/api#create_file) request (for example, when uploading dispute evidence). Stripe also creates files independently (for example, the results of a [Sigma scheduled query](#scheduled_queries)). Related guide: [File upload guide](https://stripe.com/docs/file-upload)' properties: created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer expires_at: description: The file expires and isn't available at this time in epoch seconds. format: unix-time nullable: true type: integer filename: description: The suitable name for saving the file to a filesystem. maxLength: 5000 nullable: true type: string id: description: Unique identifier for the object. maxLength: 5000 type: string links: description: A list of [file links](https://stripe.com/docs/api#file_links) that point at this file. nullable: true properties: data: description: Details about each object. items: $ref: '#/components/schemas/file_link' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/file_links type: string required: - data - has_more - object - url title: FileResourceFileLinkList type: object x-expandableFields: - data object: description: String representing the object's type. Objects of the same type share the same value. enum: - file type: string purpose: description: The [purpose](https://stripe.com/docs/file-upload#uploading-a-file) of the uploaded file. enum: - account_requirement - additional_verification - business_icon - business_logo - customer_signature - dispute_evidence - document_provider_identity_document - finance_report_run - identity_document - identity_document_downloadable - pci_document - selfie - sigma_scheduled_query - tax_document_user_upload - terminal_reader_splashscreen type: string x-stripeBypassValidation: true size: description: The size of the file object in bytes. type: integer title: description: A suitable title for the document. maxLength: 5000 nullable: true type: string type: description: The returned file type (for example, `csv`, `pdf`, `jpg`, or `png`). maxLength: 5000 nullable: true type: string url: description: Use your live secret API key to download the file from this URL. maxLength: 5000 nullable: true type: string required: - created - id - object - purpose - size title: File type: object x-expandableFields: - links x-resourceId: file GetInvoicesUpcomingRequest: type: object properties: {} GetIdentityVerificationSessionsSessionRequest: type: object properties: {} GetIssuingSettlementsRequest: type: object properties: {} GetPaymentIntentsSearchRequest: type: object properties: {} BankConnectionsResourceOwnerList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/financial_connections.account_owner' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string payment_intent: description: 'A PaymentIntent guides you through the process of collecting a payment from your customer. We recommend that you create exactly one PaymentIntent for each order or customer session in your system. You can reference the PaymentIntent later to see the history of payment attempts for a particular session. A PaymentIntent transitions through [multiple statuses](https://stripe.com/docs/payments/intents#intent-statuses) throughout its lifetime as it interfaces with Stripe.js to perform authentication flows and ultimately creates at most one successful charge. Related guide: [Payment Intents API](https://stripe.com/docs/payments/payment-intents)' properties: amount: description: Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). type: integer amount_capturable: description: Amount that can be captured from this PaymentIntent. type: integer amount_details: $ref: '#/components/schemas/payment_flows_amount_details' amount_received: description: Amount that this PaymentIntent collects. type: integer application: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/application' description: ID of the Connect application that created the PaymentIntent. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/application' application_fee_amount: description: The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total payment amount. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). nullable: true type: integer automatic_payment_methods: anyOf: - $ref: '#/components/schemas/payment_flows_automatic_payment_methods_payment_intent' description: Settings to configure compatible payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods) nullable: true canceled_at: description: Populated when `status` is `canceled`, this is the time at which the PaymentIntent was canceled. Measured in seconds since the Unix epoch. format: unix-time nullable: true type: integer cancellation_reason: description: Reason for cancellation of this PaymentIntent, either user-provided (`duplicate`, `fraudulent`, `requested_by_customer`, or `abandoned`) or generated by Stripe internally (`failed_invoice`, `void_invoice`, or `automatic`). enum: - abandoned - automatic - duplicate - failed_invoice - fraudulent - requested_by_customer - void_invoice nullable: true type: string capture_method: description: Controls when the funds will be captured from the customer's account. enum: - automatic - automatic_async - manual type: string client_secret: description: "The client secret of this PaymentIntent. Used for client-side retrieval using a publishable key. \n\nThe client secret can be used to complete a payment from your frontend. It should not be stored, logged, or exposed to anyone other than the customer. Make sure that you have TLS enabled on any page that includes the client secret.\n\nRefer to our docs to [accept a payment](https://stripe.com/docs/payments/accept-a-payment?ui=elements) and learn about how `client_secret` should be handled." maxLength: 5000 nullable: true type: string confirmation_method: description: Describes whether we can confirm this PaymentIntent automatically, or if it requires customer action to confirm the payment. enum: - automatic - manual type: string created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: 'ID of the Customer this PaymentIntent belongs to, if one exists. Payment methods attached to other Customers cannot be used with this PaymentIntent. If present in combination with [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage), this PaymentIntent''s payment method will be attached to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete.' nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: description: An arbitrary string attached to the object. Often useful for displaying to users. maxLength: 5000 nullable: true type: string id: description: Unique identifier for the object. maxLength: 5000 type: string invoice: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/invoice' description: ID of the invoice that created this PaymentIntent, if it exists. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/invoice' last_payment_error: anyOf: - $ref: '#/components/schemas/api_errors' description: The payment error encountered in the previous PaymentIntent confirmation. It will be cleared if the PaymentIntent is later updated for any reason. nullable: true latest_charge: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/charge' description: The latest charge created by this PaymentIntent. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/charge' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Learn more about [storing information in metadata](https://stripe.com/docs/payments/payment-intents/creating-payment-intents#storing-information-in-metadata). type: object next_action: anyOf: - $ref: '#/components/schemas/payment_intent_next_action' description: If present, this property tells you what actions you need to take in order for your customer to fulfill a payment using the provided source. nullable: true object: description: String representing the object's type. Objects of the same type share the same value. enum: - payment_intent type: string on_behalf_of: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/account' description: The account (if any) for which the funds of the PaymentIntent are intended. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts) for details. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/account' payment_method: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/payment_method' description: ID of the payment method used in this PaymentIntent. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/payment_method' payment_method_configuration_details: anyOf: - $ref: '#/components/schemas/payment_method_config_biz_payment_method_configuration_details' description: Information about the payment method configuration used for this PaymentIntent. nullable: true payment_method_options: anyOf: - $ref: '#/components/schemas/payment_intent_payment_method_options' description: Payment-method-specific configuration for this PaymentIntent. nullable: true payment_method_types: description: The list of payment method types (e.g. card) that this PaymentIntent is allowed to use. items: maxLength: 5000 type: string type: array processing: anyOf: - $ref: '#/components/schemas/payment_intent_processing' description: If present, this property tells you about the processing state of the payment. nullable: true receipt_email: description: Email address that the receipt for the resulting payment will be sent to. If `receipt_email` is specified for a payment in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails). maxLength: 5000 nullable: true type: string review: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/review' description: ID of the review associated with this PaymentIntent, if any. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/review' setup_future_usage: description: 'Indicates that you intend to make future payments with this PaymentIntent''s payment method. Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent''s Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes. When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).' enum: - off_session - on_session nullable: true type: string shipping: anyOf: - $ref: '#/components/schemas/shipping' description: Shipping information for this PaymentIntent. nullable: true statement_descriptor: description: For card charges, use [statement_descriptor_suffix](https://stripe.com/docs/payments/account/statement-descriptors#dynamic). Otherwise, you can use this value as the complete description of a charge on your customers' statements. It must contain at least one letter and be 1–22 characters long. maxLength: 5000 nullable: true type: string statement_descriptor_suffix: description: Provides information about a card payment that customers see on their statements. Concatenated with the prefix (shortened descriptor) or statement descriptor that’s set on the account to form the complete statement descriptor. Maximum 22 characters for the concatenated descriptor. maxLength: 5000 nullable: true type: string status: description: Status of this PaymentIntent, one of `requires_payment_method`, `requires_confirmation`, `requires_action`, `processing`, `requires_capture`, `canceled`, or `succeeded`. Read more about each PaymentIntent [status](https://stripe.com/docs/payments/intents#intent-statuses). enum: - canceled - processing - requires_action - requires_capture - requires_confirmation - requires_payment_method - succeeded type: string transfer_data: anyOf: - $ref: '#/components/schemas/transfer_data' description: The data that automatically creates a Transfer after the payment finalizes. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). nullable: true transfer_group: description: A string that identifies the resulting payment as part of a group. Learn more about the [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers). maxLength: 5000 nullable: true type: string required: - amount - capture_method - confirmation_method - created - currency - id - livemode - object - payment_method_types - status title: PaymentIntent type: object x-expandableFields: - amount_details - application - automatic_payment_methods - customer - invoice - last_payment_error - latest_charge - next_action - on_behalf_of - payment_method - payment_method_configuration_details - payment_method_options - processing - review - shipping - transfer_data x-resourceId: payment_intent GetFinancialConnectionsAccountsAccountOwnersRequest: type: object properties: {} issuing.authorization: description: 'When an [issued card](https://stripe.com/docs/issuing) is used to make a purchase, an Issuing `Authorization` object is created. [Authorizations](https://stripe.com/docs/issuing/purchases/authorizations) must be approved for the purchase to be completed successfully. Related guide: [Issued card authorizations](https://stripe.com/docs/issuing/purchases/authorizations)' properties: amount: description: The total amount that was authorized or rejected. This amount is in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). `amount` should be the same as `merchant_amount`, unless `currency` and `merchant_currency` are different. type: integer amount_details: anyOf: - $ref: '#/components/schemas/issuing_authorization_amount_details' description: Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). nullable: true approved: description: Whether the authorization has been approved. type: boolean authorization_method: description: How the card details were provided. enum: - chip - contactless - keyed_in - online - swipe type: string balance_transactions: description: List of balance transactions associated with this authorization. items: $ref: '#/components/schemas/balance_transaction' type: array card: $ref: '#/components/schemas/issuing.card' cardholder: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.cardholder' description: The cardholder to whom this authorization belongs. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.cardholder' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: The currency of the cardholder. This currency can be different from the currency presented at authorization and the `merchant_currency` field on this authorization. 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). type: string id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean merchant_amount: description: The total amount that was authorized or rejected. This amount is in the `merchant_currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). `merchant_amount` should be the same as `amount`, unless `merchant_currency` and `currency` are different. type: integer merchant_currency: description: The local currency that was presented to the cardholder for the authorization. This currency can be different from the cardholder currency and the `currency` field on this authorization. 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). type: string merchant_data: $ref: '#/components/schemas/issuing_authorization_merchant_data' metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object network_data: anyOf: - $ref: '#/components/schemas/issuing_authorization_network_data' description: Details about the authorization, such as identifiers, set by the card network. nullable: true object: description: String representing the object's type. Objects of the same type share the same value. enum: - issuing.authorization type: string pending_request: anyOf: - $ref: '#/components/schemas/issuing_authorization_pending_request' description: The pending authorization request. This field will only be non-null during an `issuing_authorization.request` webhook. nullable: true request_history: description: History of every time a `pending_request` authorization was approved/declined, either by you directly or by Stripe (e.g. based on your spending_controls). If the merchant changes the authorization by performing an incremental authorization, you can look at this field to see the previous requests for the authorization. This field can be helpful in determining why a given authorization was approved/declined. items: $ref: '#/components/schemas/issuing_authorization_request' type: array status: description: The current status of the authorization in its lifecycle. enum: - closed - pending - reversed type: string token: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.token' description: '[Token](https://stripe.com/docs/api/issuing/tokens/object) object used for this authorization. If a network token was not used for this authorization, this field will be null.' nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.token' transactions: description: List of [transactions](https://stripe.com/docs/api/issuing/transactions) associated with this authorization. items: $ref: '#/components/schemas/issuing.transaction' type: array treasury: anyOf: - $ref: '#/components/schemas/issuing_authorization_treasury' description: '[Treasury](https://stripe.com/docs/api/treasury) details related to this authorization if it was created on a [FinancialAccount](https://stripe.com/docs/api/treasury/financial_accounts).' nullable: true verification_data: $ref: '#/components/schemas/issuing_authorization_verification_data' wallet: description: The digital wallet used for this transaction. One of `apple_pay`, `google_pay`, or `samsung_pay`. Will populate as `null` when no digital wallet was utilized. maxLength: 5000 nullable: true type: string required: - amount - approved - authorization_method - balance_transactions - card - created - currency - id - livemode - merchant_amount - merchant_currency - merchant_data - metadata - object - request_history - status - transactions - verification_data title: IssuingAuthorization type: object x-expandableFields: - amount_details - balance_transactions - card - cardholder - merchant_data - network_data - pending_request - request_history - token - transactions - treasury - verification_data x-resourceId: issuing.authorization payment_link: description: 'A payment link is a shareable URL that will take your customers to a hosted payment page. A payment link can be shared and used multiple times. When a customer opens a payment link it will open a new [checkout session](https://stripe.com/docs/api/checkout/sessions) to render the payment page. You can use [checkout session events](https://stripe.com/docs/api/events/types#event_types-checkout.session.completed) to track payments through payment links. Related guide: [Payment Links API](https://stripe.com/docs/payment-links)' properties: active: description: Whether the payment link's `url` is active. If `false`, customers visiting the URL will be shown a page saying that the link has been deactivated. type: boolean after_completion: $ref: '#/components/schemas/payment_links_resource_after_completion' allow_promotion_codes: description: Whether user redeemable promotion codes are enabled. type: boolean application: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/application' - $ref: '#/components/schemas/deleted_application' description: The ID of the Connect application that created the Payment Link. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/application' - $ref: '#/components/schemas/deleted_application' application_fee_amount: description: The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. nullable: true type: integer application_fee_percent: description: This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account. nullable: true type: number automatic_tax: $ref: '#/components/schemas/payment_links_resource_automatic_tax' billing_address_collection: description: Configuration for collecting the customer's billing address. enum: - auto - required type: string consent_collection: anyOf: - $ref: '#/components/schemas/payment_links_resource_consent_collection' description: When set, provides configuration to gather active consent from customers. nullable: true currency: description: 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). type: string custom_fields: description: Collect additional information from your customer using custom fields. Up to 2 fields are supported. items: $ref: '#/components/schemas/payment_links_resource_custom_fields' type: array custom_text: $ref: '#/components/schemas/payment_links_resource_custom_text' customer_creation: description: Configuration for Customer creation during checkout. enum: - always - if_required type: string id: description: Unique identifier for the object. maxLength: 5000 type: string inactive_message: description: The custom message to be displayed to a customer when a payment link is no longer active. maxLength: 5000 nullable: true type: string invoice_creation: anyOf: - $ref: '#/components/schemas/payment_links_resource_invoice_creation' description: Configuration for creating invoice for payment mode payment links. nullable: true line_items: description: The line items representing what is being sold. properties: data: description: Details about each object. items: $ref: '#/components/schemas/item' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string required: - data - has_more - object - url title: PaymentLinksResourceListLineItems type: object x-expandableFields: - data livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object object: description: String representing the object's type. Objects of the same type share the same value. enum: - payment_link type: string on_behalf_of: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/account' description: The account on behalf of which to charge. See the [Connect documentation](https://support.stripe.com/questions/sending-invoices-on-behalf-of-connected-accounts) for details. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/account' payment_intent_data: anyOf: - $ref: '#/components/schemas/payment_links_resource_payment_intent_data' description: Indicates the parameters to be passed to PaymentIntent creation during checkout. nullable: true payment_method_collection: description: Configuration for collecting a payment method during checkout. enum: - always - if_required type: string payment_method_types: description: The list of payment method types that customers can use. When `null`, Stripe will dynamically show relevant payment methods you've enabled in your [payment method settings](https://dashboard.stripe.com/settings/payment_methods). items: enum: - affirm - afterpay_clearpay - alipay - au_becs_debit - bacs_debit - bancontact - blik - boleto - card - cashapp - eps - fpx - giropay - grabpay - ideal - klarna - konbini - link - oxxo - p24 - paynow - paypal - pix - promptpay - sepa_debit - sofort - us_bank_account - wechat_pay type: string x-stripeBypassValidation: true nullable: true type: array phone_number_collection: $ref: '#/components/schemas/payment_links_resource_phone_number_collection' restrictions: anyOf: - $ref: '#/components/schemas/payment_links_resource_restrictions' description: Settings that restrict the usage of a payment link. nullable: true shipping_address_collection: anyOf: - $ref: '#/components/schemas/payment_links_resource_shipping_address_collection' description: Configuration for collecting the customer's shipping address. nullable: true shipping_options: description: The shipping rate options applied to the session. items: $ref: '#/components/schemas/payment_links_resource_shipping_option' type: array submit_type: description: Indicates the type of transaction being performed which customizes relevant text on the page, such as the submit button. enum: - auto - book - donate - pay type: string subscription_data: anyOf: - $ref: '#/components/schemas/payment_links_resource_subscription_data' description: When creating a subscription, the specified configuration data will be used. There must be at least one line item with a recurring price to use `subscription_data`. nullable: true tax_id_collection: $ref: '#/components/schemas/payment_links_resource_tax_id_collection' transfer_data: anyOf: - $ref: '#/components/schemas/payment_links_resource_transfer_data' description: The account (if any) the payments will be attributed to for tax reporting, and where funds from each payment will be transferred to. nullable: true url: description: The public URL that can be shared with customers. maxLength: 5000 type: string required: - active - after_completion - allow_promotion_codes - automatic_tax - billing_address_collection - currency - custom_fields - custom_text - customer_creation - id - livemode - metadata - object - payment_method_collection - phone_number_collection - shipping_options - submit_type - tax_id_collection - url title: PaymentLink type: object x-expandableFields: - after_completion - application - automatic_tax - consent_collection - custom_fields - custom_text - invoice_creation - line_items - on_behalf_of - payment_intent_data - phone_number_collection - restrictions - shipping_address_collection - shipping_options - subscription_data - tax_id_collection - transfer_data x-resourceId: payment_link issuing.dispute: description: 'As a [card issuer](https://stripe.com/docs/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has other issues with. Related guide: [Issuing disputes](https://stripe.com/docs/issuing/purchases/disputes)' properties: amount: description: Disputed amount in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation). type: integer balance_transactions: description: List of balance transactions associated with the dispute. items: $ref: '#/components/schemas/balance_transaction' nullable: true type: array created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: The currency the `transaction` was made in. type: string evidence: $ref: '#/components/schemas/issuing_dispute_evidence' id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object object: description: String representing the object's type. Objects of the same type share the same value. enum: - issuing.dispute type: string status: description: Current status of the dispute. enum: - expired - lost - submitted - unsubmitted - won type: string transaction: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.transaction' description: The transaction being disputed. x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.transaction' treasury: anyOf: - $ref: '#/components/schemas/issuing_dispute_treasury' description: '[Treasury](https://stripe.com/docs/api/treasury) details related to this dispute if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts' nullable: true required: - amount - created - currency - evidence - id - livemode - metadata - object - status - transaction title: IssuingDispute type: object x-expandableFields: - balance_transactions - evidence - transaction - treasury x-resourceId: issuing.dispute GetIdentityVerificationReportsRequest: type: object properties: {} GetPayoutsPayoutRequest: type: object properties: {} GetPaymentIntentsRequest: type: object properties: {} IssuingCardholderList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/issuing.cardholder' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/issuing/cardholders type: string GetPlansRequest: type: object properties: {} ExchangeRateList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/exchange_rate' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/exchange_rates type: string NotificationEventList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/event' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/events type: string plan: description: 'You can now model subscriptions more flexibly using the [Prices API](https://stripe.com/docs/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration. Plans define the base price, currency, and billing cycle for recurring purchases of products. [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and plans help you track pricing. Different physical goods or levels of service should be represented by products, and pricing options should be represented by plans. This approach lets you change prices without having to change your provisioning scheme. For example, you might have a single "gold" product that has plans for $10/month, $100/year, €9/month, and €90/year. Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription) and more about [products and prices](https://stripe.com/docs/products-prices/overview).' properties: active: description: Whether the plan can be used for new purchases. type: boolean aggregate_usage: description: Specifies a usage aggregation strategy for plans of `usage_type=metered`. Allowed values are `sum` for summing up all usage during a period, `last_during_period` for using the last usage record reported within a period, `last_ever` for using the last usage record ever (across period bounds) or `max` which uses the usage record with the maximum reported usage during a period. Defaults to `sum`. enum: - last_during_period - last_ever - max - sum nullable: true type: string amount: description: The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if `billing_scheme=per_unit`. nullable: true type: integer amount_decimal: description: The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if `billing_scheme=per_unit`. format: decimal nullable: true type: string billing_scheme: description: Describes how to compute the price per period. Either `per_unit` or `tiered`. `per_unit` indicates that the fixed amount (specified in `amount`) will be charged per unit in `quantity` (for plans with `usage_type=licensed`), or per unit of total usage (for plans with `usage_type=metered`). `tiered` indicates that the unit pricing will be computed using a tiering strategy as defined using the `tiers` and `tiers_mode` attributes. enum: - per_unit - tiered type: string created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string id: description: Unique identifier for the object. maxLength: 5000 type: string interval: description: The frequency at which a subscription is billed. One of `day`, `week`, `month` or `year`. enum: - day - month - week - year type: string interval_count: description: The number of intervals (specified in the `interval` attribute) between subscription billings. For example, `interval=month` and `interval_count=3` bills every 3 months. type: integer livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object nickname: description: A brief description of the plan, hidden from customers. maxLength: 5000 nullable: true type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - plan type: string product: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/product' - $ref: '#/components/schemas/deleted_product' description: The product whose pricing this plan determines. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/product' - $ref: '#/components/schemas/deleted_product' tiers: description: Each element represents a pricing tier. This parameter requires `billing_scheme` to be set to `tiered`. See also the documentation for `billing_scheme`. items: $ref: '#/components/schemas/plan_tier' type: array tiers_mode: description: Defines if the tiering price should be `graduated` or `volume` based. In `volume`-based tiering, the maximum quantity within a period determines the per unit price. In `graduated` tiering, pricing can change as the quantity grows. enum: - graduated - volume nullable: true type: string transform_usage: anyOf: - $ref: '#/components/schemas/transform_usage' description: Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with `tiers`. nullable: true trial_period_days: description: Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://stripe.com/docs/api#create_subscription-trial_from_plan). nullable: true type: integer usage_type: description: Configures how the quantity per period should be determined. Can be either `metered` or `licensed`. `licensed` automatically bills the `quantity` set when adding it to a subscription. `metered` aggregates the total usage based on usage records. Defaults to `licensed`. enum: - licensed - metered type: string required: - active - billing_scheme - created - currency - id - interval - interval_count - livemode - object - usage_type title: Plan type: object x-expandableFields: - product - tiers - transform_usage x-resourceId: plan GetPaymentLinksPaymentLinkRequest: type: object properties: {} GetCustomersCustomerSubscriptionsSubscriptionExposedIdRequest: type: object properties: {} GetPlansPlanRequest: type: object properties: {} issuing.settlement: description: When a non-stripe BIN is used, any use of an [issued card](https://stripe.com/docs/issuing) must be settled directly with the card network. The net amount owed is represented by an Issuing `Settlement` object. properties: bin: description: The Bank Identification Number reflecting this settlement record. maxLength: 5000 type: string clearing_date: description: The date that the transactions are cleared and posted to user's accounts. type: integer created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string id: description: Unique identifier for the object. maxLength: 5000 type: string interchange_fees: description: The total interchange received as reimbursement for the transactions. type: integer livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object net_total: description: The total net amount required to settle with the network. type: integer network: description: The card network for this settlement report. One of ["visa"] enum: - visa type: string network_fees: description: The total amount of fees owed to the network. type: integer network_settlement_identifier: description: The Settlement Identification Number assigned by the network. maxLength: 5000 type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - issuing.settlement type: string settlement_service: description: One of `international` or `uk_national_net`. maxLength: 5000 type: string transaction_count: description: The total number of transactions reflected in this settlement. type: integer transaction_volume: description: The total transaction amount reflected in this settlement. type: integer required: - bin - clearing_date - created - currency - id - interchange_fees - livemode - metadata - net_total - network - network_fees - network_settlement_identifier - object - settlement_service - transaction_count - transaction_volume title: IssuingSettlement type: object x-expandableFields: [] x-resourceId: issuing.settlement GetCheckoutSessionsSessionLineItemsRequest: type: object properties: {} balance_transaction: description: 'Balance transactions represent funds moving through your Stripe account. Stripe creates them for every type of transaction that enters or leaves your Stripe account balance. Related guide: [Balance transaction types](https://stripe.com/docs/reports/balance-transaction-types)' properties: amount: description: Gross amount of this transaction (in cents (or local equivalent)). A positive value represents funds charged to another party, and a negative value represents funds sent to another party. type: integer available_on: description: The date that the transaction's net funds become available in the Stripe balance. format: unix-time type: integer created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string description: description: An arbitrary string attached to the object. Often useful for displaying to users. maxLength: 5000 nullable: true type: string exchange_rate: description: If applicable, this transaction uses an exchange rate. If money converts from currency A to currency B, then the `amount` in currency A, multipled by the `exchange_rate`, equals the `amount` in currency B. For example, if you charge a customer 10.00 EUR, the PaymentIntent's `amount` is `1000` and `currency` is `eur`. If this converts to 12.34 USD in your Stripe account, the BalanceTransaction's `amount` is `1234`, its `currency` is `usd`, and the `exchange_rate` is `1.234`. nullable: true type: number fee: description: Fees (in cents (or local equivalent)) paid for this transaction. Represented as a positive integer when assessed. type: integer fee_details: description: Detailed breakdown of fees (in cents (or local equivalent)) paid for this transaction. items: $ref: '#/components/schemas/fee' type: array id: description: Unique identifier for the object. maxLength: 5000 type: string net: description: Net impact to a Stripe balance (in cents (or local equivalent)). A positive value represents incrementing a Stripe balance, and a negative value decrementing a Stripe balance. You can calculate the net impact of a transaction on a balance by `amount` - `fee` type: integer object: description: String representing the object's type. Objects of the same type share the same value. enum: - balance_transaction type: string reporting_category: description: Learn more about how [reporting categories](https://stripe.com/docs/reports/reporting-categories) can help you understand balance transactions from an accounting perspective. maxLength: 5000 type: string source: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/application_fee' - $ref: '#/components/schemas/charge' - $ref: '#/components/schemas/connect_collection_transfer' - $ref: '#/components/schemas/customer_cash_balance_transaction' - $ref: '#/components/schemas/dispute' - $ref: '#/components/schemas/fee_refund' - $ref: '#/components/schemas/issuing.authorization' - $ref: '#/components/schemas/issuing.dispute' - $ref: '#/components/schemas/issuing.transaction' - $ref: '#/components/schemas/payout' - $ref: '#/components/schemas/platform_tax_fee' - $ref: '#/components/schemas/refund' - $ref: '#/components/schemas/reserve_transaction' - $ref: '#/components/schemas/tax_deducted_at_source' - $ref: '#/components/schemas/topup' - $ref: '#/components/schemas/transfer' - $ref: '#/components/schemas/transfer_reversal' description: This transaction relates to the Stripe object. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/application_fee' - $ref: '#/components/schemas/charge' - $ref: '#/components/schemas/connect_collection_transfer' - $ref: '#/components/schemas/customer_cash_balance_transaction' - $ref: '#/components/schemas/dispute' - $ref: '#/components/schemas/fee_refund' - $ref: '#/components/schemas/issuing.authorization' - $ref: '#/components/schemas/issuing.dispute' - $ref: '#/components/schemas/issuing.transaction' - $ref: '#/components/schemas/payout' - $ref: '#/components/schemas/platform_tax_fee' - $ref: '#/components/schemas/refund' - $ref: '#/components/schemas/reserve_transaction' - $ref: '#/components/schemas/tax_deducted_at_source' - $ref: '#/components/schemas/topup' - $ref: '#/components/schemas/transfer' - $ref: '#/components/schemas/transfer_reversal' x-stripeBypassValidation: true status: description: The transaction's net funds status in the Stripe balance, which are either `available` or `pending`. maxLength: 5000 type: string type: description: 'Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_inbound`, `obligation_outbound`, `obligation_reversal_inbound`, `obligation_reversal_outbound`, `obligation_payout`, `obligation_payout_failure`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`. Learn more about [balance transaction types and what they represent](https://stripe.com/docs/reports/balance-transaction-types). To classify transactions for accounting purposes, consider `reporting_category` instead.' enum: - adjustment - advance - advance_funding - anticipation_repayment - application_fee - application_fee_refund - charge - climate_order_purchase - climate_order_refund - connect_collection_transfer - contribution - issuing_authorization_hold - issuing_authorization_release - issuing_dispute - issuing_transaction - obligation_inbound - obligation_outbound - obligation_payout - obligation_payout_failure - obligation_reversal_inbound - obligation_reversal_outbound - payment - payment_failure_refund - payment_network_reserve_hold - payment_network_reserve_release - payment_refund - payment_reversal - payment_unreconciled - payout - payout_cancel - payout_failure - refund - refund_failure - reserve_transaction - reserved_funds - stripe_fee - stripe_fx_fee - tax_fee - topup - topup_reversal - transfer - transfer_cancel - transfer_failure - transfer_refund type: string required: - amount - available_on - created - currency - fee - fee_details - id - net - object - reporting_category - status - type title: BalanceTransaction type: object x-expandableFields: - fee_details - source x-resourceId: balance_transaction line_item: description: '' properties: amount: description: The amount, in cents (or local equivalent). type: integer amount_excluding_tax: description: The integer amount in cents (or local equivalent) representing the amount for this line item, excluding all tax and discounts. nullable: true type: integer currency: description: 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). type: string description: description: An arbitrary string attached to the object. Often useful for displaying to users. maxLength: 5000 nullable: true type: string discount_amounts: description: The amount of discount calculated per discount for this line item. items: $ref: '#/components/schemas/discounts_resource_discount_amount' nullable: true type: array discountable: description: If true, discounts will apply to this line item. Always false for prorations. type: boolean discounts: description: The discounts applied to the invoice line item. Line item discounts are applied before invoice discounts. Use `expand[]=discounts` to expand each discount. items: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/discount' x-expansionResources: oneOf: - $ref: '#/components/schemas/discount' nullable: true type: array id: description: Unique identifier for the object. maxLength: 5000 type: string invoice_item: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/invoiceitem' description: The ID of the [invoice item](https://stripe.com/docs/api/Invoice Items) associated with this line item if any. x-expansionResources: oneOf: - $ref: '#/components/schemas/invoiceitem' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Note that for line items with `type=subscription` this will reflect the metadata of the subscription that caused the line item to be created. type: object object: description: String representing the object's type. Objects of the same type share the same value. enum: - line_item type: string period: $ref: '#/components/schemas/invoice_line_item_period' price: anyOf: - $ref: '#/components/schemas/price' description: The price of the line item. nullable: true proration: description: Whether this is a proration. type: boolean proration_details: anyOf: - $ref: '#/components/schemas/invoices_resource_line_items_proration_details' description: Additional details for proration line items nullable: true quantity: description: The quantity of the subscription, if the line item is a subscription or a proration. nullable: true type: integer subscription: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/subscription' description: The subscription that the invoice item pertains to, if any. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/subscription' subscription_item: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/subscription_item' description: The subscription item that generated this line item. Left empty if the line item is not an explicit result of a subscription. x-expansionResources: oneOf: - $ref: '#/components/schemas/subscription_item' tax_amounts: description: The amount of tax calculated per tax rate for this line item items: $ref: '#/components/schemas/invoice_tax_amount' type: array tax_rates: description: The tax rates which apply to the line item. items: $ref: '#/components/schemas/tax_rate' type: array type: description: A string identifying the type of the source of this line item, either an `invoiceitem` or a `subscription`. enum: - invoiceitem - subscription type: string unit_amount_excluding_tax: description: The amount in cents (or local equivalent) representing the unit amount for this line item, excluding all tax and discounts. format: decimal nullable: true type: string required: - amount - currency - discountable - id - livemode - metadata - object - period - proration - type title: InvoiceLineItem type: object x-expandableFields: - discount_amounts - discounts - invoice_item - period - price - proration_details - subscription - subscription_item - tax_amounts - tax_rates x-resourceId: line_item GetBalanceHistoryIdRequest: type: object properties: {} GetBalanceTransactionsRequest: type: object properties: {} GetIdentityVerificationReportsReportRequest: type: object properties: {} GetPricesSearchRequest: type: object properties: {} GetIssuingTransactionsRequest: type: object properties: {} GetFinancialConnectionsTransactionsTransactionRequest: type: object properties: {} PriceList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/price' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/prices type: string CouponsResourceCouponList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/coupon' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/coupons type: string GetIdentityVerificationSessionsRequest: type: object properties: {} billing_portal.configuration: description: A portal configuration describes the functionality and behavior of a portal session. properties: active: description: Whether the configuration is active and can be used to create portal sessions. type: boolean application: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/application' - $ref: '#/components/schemas/deleted_application' description: ID of the Connect Application that created the configuration. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/application' - $ref: '#/components/schemas/deleted_application' business_profile: $ref: '#/components/schemas/portal_business_profile' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer default_return_url: description: The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://stripe.com/docs/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session. maxLength: 5000 nullable: true type: string features: $ref: '#/components/schemas/portal_features' id: description: Unique identifier for the object. maxLength: 5000 type: string is_default: description: Whether the configuration is the default. If `true`, this configuration can be managed in the Dashboard and portal sessions will use this configuration unless it is overriden when creating the session. type: boolean livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean login_page: $ref: '#/components/schemas/portal_login_page' metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object object: description: String representing the object's type. Objects of the same type share the same value. enum: - billing_portal.configuration type: string updated: description: Time at which the object was last updated. Measured in seconds since the Unix epoch. format: unix-time type: integer required: - active - business_profile - created - features - id - is_default - livemode - login_page - object - updated title: PortalConfiguration type: object x-expandableFields: - application - business_profile - features - login_page x-resourceId: billing_portal.configuration GelatoVerificationReportList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/identity.verification_report' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/identity/verification_reports type: string GetCustomersCustomerTaxIdsIdRequest: type: object properties: {} GetCustomersCustomerRequest: type: object properties: {} PaymentMethodConfigResourcePaymentMethodConfigurationsList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/payment_method_configuration' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string PayoutList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/payout' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/payouts type: string GetCreditNotesCreditNoteLinesRequest: type: object properties: {} GetCustomersRequest: type: object properties: {} payout: description: 'A `Payout` object is created when you receive funds from Stripe, or when you initiate a payout to either a bank account or debit card of a [connected Stripe account](/docs/connect/bank-debit-card-payouts). You can retrieve individual payouts, and list all payouts. Payouts are made on [varying schedules](/docs/connect/manage-payout-schedule), depending on your country and industry. Related guide: [Receiving payouts](https://stripe.com/docs/payouts)' properties: amount: description: The amount (in cents (or local equivalent)) that transfers to your bank account or debit card. type: integer arrival_date: description: Date that you can expect the payout to arrive in the bank. This factors in delays to account for weekends or bank holidays. format: unix-time type: integer automatic: description: Returns `true` if the payout is created by an [automated payout schedule](https://stripe.com/docs/payouts#payout-schedule) and `false` if it's [requested manually](https://stripe.com/docs/payouts#manual-payouts). type: boolean balance_transaction: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/balance_transaction' description: ID of the balance transaction that describes the impact of this payout on your account balance. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/balance_transaction' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string description: description: An arbitrary string attached to the object. Often useful for displaying to users. maxLength: 5000 nullable: true type: string destination: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/deleted_bank_account' - $ref: '#/components/schemas/deleted_card' description: ID of the bank account or card the payout is sent to. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/deleted_bank_account' - $ref: '#/components/schemas/deleted_card' x-stripeBypassValidation: true failure_balance_transaction: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/balance_transaction' description: If the payout fails or cancels, this is the ID of the balance transaction that reverses the initial balance transaction and returns the funds from the failed payout back in your balance. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/balance_transaction' failure_code: description: Error code that provides a reason for a payout failure, if available. View our [list of failure codes](https://stripe.com/docs/api#payout_failures). maxLength: 5000 nullable: true type: string failure_message: description: Message that provides the reason for a payout failure, if available. maxLength: 5000 nullable: true type: string id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object method: description: The method used to send this payout, which can be `standard` or `instant`. `instant` is supported for payouts to debit cards and bank accounts in certain countries. Learn more about [bank support for Instant Payouts](https://stripe.com/docs/payouts/instant-payouts-banks). maxLength: 5000 type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - payout type: string original_payout: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/payout' description: If the payout reverses another, this is the ID of the original payout. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/payout' reconciliation_status: description: If `completed`, you can use the [Balance Transactions API](https://stripe.com/docs/api/balance_transactions/list#balance_transaction_list-payout) to list all balance transactions that are paid out in this payout. enum: - completed - in_progress - not_applicable type: string reversed_by: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/payout' description: If the payout reverses, this is the ID of the payout that reverses this payout. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/payout' source_type: description: 'The source balance this payout came from, which can be one of the following: `card`, `fpx`, or `bank_account`.' maxLength: 5000 type: string statement_descriptor: description: Extra information about a payout that displays on the user's bank statement. maxLength: 5000 nullable: true type: string status: description: 'Current status of the payout: `paid`, `pending`, `in_transit`, `canceled` or `failed`. A payout is `pending` until it''s submitted to the bank, when it becomes `in_transit`. The status changes to `paid` if the transaction succeeds, or to `failed` or `canceled` (within 5 business days). Some payouts that fail might initially show as `paid`, then change to `failed`.' maxLength: 5000 type: string type: description: Can be `bank_account` or `card`. enum: - bank_account - card type: string x-stripeBypassValidation: true required: - amount - arrival_date - automatic - created - currency - id - livemode - method - object - reconciliation_status - source_type - status - type title: Payout type: object x-expandableFields: - balance_transaction - destination - failure_balance_transaction - original_payout - reversed_by x-resourceId: payout deleted_customer: description: '' properties: deleted: description: Always true for a deleted object enum: - true type: boolean id: description: Unique identifier for the object. maxLength: 5000 type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - customer type: string required: - deleted - id - object title: DeletedCustomer type: object x-expandableFields: [] x-resourceId: deleted_customer GetCustomersCustomerDiscountRequest: type: object properties: {} CustomerBalanceTransactionList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/customer_balance_transaction' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string GetPaymentMethodConfigurationsConfigurationRequest: type: object properties: {} GetCouponsRequest: type: object properties: {} GetCustomersCustomerCardsRequest: type: object properties: {} apps.secret: description: 'Secret Store is an API that allows Stripe Apps developers to securely persist secrets for use by UI Extensions and app backends. The primary resource in Secret Store is a `secret`. Other apps can''t view secrets created by an app. Additionally, secrets are scoped to provide further permission control. All Dashboard users and the app backend share `account` scoped secrets. Use the `account` scope for secrets that don''t change per-user, like a third-party API key. A `user` scoped secret is accessible by the app backend and one specific Dashboard user. Use the `user` scope for per-user secrets like per-user OAuth tokens, where different users might have different permissions. Related guide: [Store data between page reloads](https://stripe.com/docs/stripe-apps/store-auth-data-custom-objects)' properties: created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer deleted: description: If true, indicates that this secret has been deleted type: boolean expires_at: description: The Unix timestamp for the expiry time of the secret, after which the secret deletes. format: unix-time nullable: true type: integer id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean name: description: A name for the secret that's unique within the scope. maxLength: 5000 type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - apps.secret type: string payload: description: The plaintext secret value to be stored. maxLength: 5000 nullable: true type: string scope: $ref: '#/components/schemas/secret_service_resource_scope' required: - created - id - livemode - name - object - scope title: SecretServiceResourceSecret type: object x-expandableFields: - scope x-resourceId: apps.secret card: description: 'You can store multiple cards on a customer in order to charge the customer later. You can also store multiple debit cards on a recipient in order to transfer to those cards later. Related guide: [Card payments with Sources](https://stripe.com/docs/sources/cards)' properties: account: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/account' description: The account this card belongs to. This attribute will not be in the card object if the card belongs to a customer or recipient instead. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/account' address_city: description: City/District/Suburb/Town/Village. maxLength: 5000 nullable: true type: string address_country: description: Billing address country, if provided when creating card. maxLength: 5000 nullable: true type: string address_line1: description: Address line 1 (Street address/PO Box/Company name). maxLength: 5000 nullable: true type: string address_line1_check: description: 'If `address_line1` was provided, results of the check: `pass`, `fail`, `unavailable`, or `unchecked`.' maxLength: 5000 nullable: true type: string address_line2: description: Address line 2 (Apartment/Suite/Unit/Building). maxLength: 5000 nullable: true type: string address_state: description: State/County/Province/Region. maxLength: 5000 nullable: true type: string address_zip: description: ZIP or postal code. maxLength: 5000 nullable: true type: string address_zip_check: description: 'If `address_zip` was provided, results of the check: `pass`, `fail`, `unavailable`, or `unchecked`.' maxLength: 5000 nullable: true type: string available_payout_methods: description: A set of available payout methods for this card. Only values from this set should be passed as the `method` when creating a payout. items: enum: - instant - standard type: string nullable: true type: array brand: description: Card brand. Can be `American Express`, `Diners Club`, `Discover`, `Eftpos Australia`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`. maxLength: 5000 type: string country: description: Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected. maxLength: 5000 nullable: true type: string currency: description: Three-letter [ISO code for currency](https://stripe.com/docs/payouts). Only applicable on accounts (not customers or recipients). The card can be used as a transfer destination for funds in this currency. nullable: true type: string customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: The customer that this card belongs to. This attribute will not be in the card object if the card belongs to an account or recipient instead. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' cvc_check: description: 'If a CVC was provided, results of the check: `pass`, `fail`, `unavailable`, or `unchecked`. A result of unchecked indicates that CVC was provided but hasn''t been checked yet. Checks are typically performed when attaching a card to a Customer object, or when creating a charge. For more details, see [Check if a card is valid without a charge](https://support.stripe.com/questions/check-if-a-card-is-valid-without-a-charge).' maxLength: 5000 nullable: true type: string default_for_currency: description: Whether this card is the default external account for its currency. nullable: true type: boolean dynamic_last4: description: (For tokenized numbers only.) The last four digits of the device account number. maxLength: 5000 nullable: true type: string exp_month: description: Two-digit number representing the card's expiration month. type: integer exp_year: description: Four-digit number representing the card's expiration year. type: integer fingerprint: description: 'Uniquely identifies this particular card number. You can use this attribute to check whether two customers who’ve signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number. *As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same cardone for India and one for the rest of the world.*' maxLength: 5000 nullable: true type: string funding: description: Card funding type. Can be `credit`, `debit`, `prepaid`, or `unknown`. maxLength: 5000 type: string id: description: Unique identifier for the object. maxLength: 5000 type: string last4: description: The last four digits of the card. maxLength: 5000 type: string metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object name: description: Cardholder name. maxLength: 5000 nullable: true type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - card type: string status: description: For external accounts that are cards, possible values are `new` and `errored`. If a payout fails, the status is set to `errored` and [scheduled payouts](https://stripe.com/docs/payouts#payout-schedule) are stopped until account details are updated. maxLength: 5000 nullable: true type: string tokenization_method: description: If the card number is tokenized, this is the method that was used. Can be `android_pay` (includes Google Pay), `apple_pay`, `masterpass`, `visa_checkout`, or null. maxLength: 5000 nullable: true type: string required: - brand - exp_month - exp_year - funding - id - last4 - object title: Card type: object x-expandableFields: - account - customer x-resourceId: card IssuingSettlementList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/issuing.settlement' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/issuing/settlements type: string GetIssuingAuthorizationsRequest: type: object properties: {} GetBalanceHistoryRequest: type: object properties: {} CreditNoteLinesList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/credit_note_line_item' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string BankAccountList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/bank_account' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string GetCustomersCustomerSourcesRequest: type: object properties: {} GetCustomersCustomerSubscriptionsRequest: type: object properties: {} GetCheckoutSessionsSessionRequest: type: object properties: {} error: description: An error response from the Stripe API properties: error: $ref: '#/components/schemas/api_errors' required: - error type: object discount: description: 'A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes). It contains information about when the discount began, when it will end, and what it is applied to. Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts)' properties: checkout_session: description: The Checkout session that this coupon is applied to, if it is applied to a particular session in payment mode. Will not be present for subscription mode. maxLength: 5000 nullable: true type: string coupon: $ref: '#/components/schemas/coupon' customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: The ID of the customer associated with this discount. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' end: description: If the coupon has a duration of `repeating`, the date that this discount will end. If the coupon has a duration of `once` or `forever`, this attribute will be null. format: unix-time nullable: true type: integer id: description: The ID of the discount object. Discounts cannot be fetched by ID. Use `expand[]=discounts` in API calls to expand discount IDs in an array. maxLength: 5000 type: string invoice: description: The invoice that the discount's coupon was applied to, if it was applied directly to a particular invoice. maxLength: 5000 nullable: true type: string invoice_item: description: The invoice item `id` (or invoice line item `id` for invoice line items of type='subscription') that the discount's coupon was applied to, if it was applied directly to a particular invoice item or invoice line item. maxLength: 5000 nullable: true type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - discount type: string promotion_code: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/promotion_code' description: The promotion code applied to create this discount. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/promotion_code' start: description: Date that the coupon was applied. format: unix-time type: integer subscription: description: The subscription that this coupon is applied to, if it is applied to a particular subscription. maxLength: 5000 nullable: true type: string required: - coupon - id - object - start title: Discount type: object x-expandableFields: - coupon - customer - promotion_code x-resourceId: discount dispute: description: 'A dispute occurs when a customer questions your charge with their card issuer. When this happens, you have the opportunity to respond to the dispute with evidence that shows that the charge is legitimate. Related guide: [Disputes and fraud](https://stripe.com/docs/disputes)' properties: amount: description: Disputed amount. Usually the amount of the charge, but it can differ (usually because of currency fluctuation or because only part of the order is disputed). type: integer balance_transactions: description: List of zero, one, or two balance transactions that show funds withdrawn and reinstated to your Stripe account as a result of this dispute. items: $ref: '#/components/schemas/balance_transaction' type: array charge: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/charge' description: ID of the charge that's disputed. x-expansionResources: oneOf: - $ref: '#/components/schemas/charge' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string evidence: $ref: '#/components/schemas/dispute_evidence' evidence_details: $ref: '#/components/schemas/dispute_evidence_details' id: description: Unique identifier for the object. maxLength: 5000 type: string is_charge_refundable: description: If true, it's still possible to refund the disputed payment. After the payment has been fully refunded, no further funds are withdrawn from your Stripe account as a result of this dispute. type: boolean livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object object: description: String representing the object's type. Objects of the same type share the same value. enum: - dispute type: string payment_intent: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/payment_intent' description: ID of the PaymentIntent that's disputed. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/payment_intent' payment_method_details: $ref: '#/components/schemas/dispute_payment_method_details' reason: description: Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Learn more about [dispute reasons](https://stripe.com/docs/disputes/categories). maxLength: 5000 type: string status: description: Current status of dispute. Possible values are `warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `won`, or `lost`. enum: - lost - needs_response - under_review - warning_closed - warning_needs_response - warning_under_review - won type: string required: - amount - balance_transactions - charge - created - currency - evidence - evidence_details - id - is_charge_refundable - livemode - metadata - object - reason - status title: Dispute type: object x-expandableFields: - balance_transactions - charge - evidence - evidence_details - payment_intent - payment_method_details x-resourceId: dispute GetCreditNotesPreviewRequest: type: object properties: {} payment_source: anyOf: - $ref: '#/components/schemas/account' - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/source' title: Polymorphic x-resourceId: payment_source x-stripeBypassValidation: true balance: description: 'This is an object representing your Stripe balance. You can retrieve it to see the balance currently on your Stripe account. You can also retrieve the balance history, which contains a list of [transactions](https://stripe.com/docs/reporting/balance-transaction-types) that contributed to the balance (charges, payouts, and so forth). The available and pending amounts for each currency are broken down further by payment source types. Related guide: [Understanding Connect account balances](https://stripe.com/docs/connect/account-balances)' properties: available: description: Available funds that you can transfer or pay out automatically by Stripe or explicitly through the [Transfers API](https://stripe.com/docs/api#transfers) or [Payouts API](https://stripe.com/docs/api#payouts). You can find the available balance for each currency and payment type in the `source_types` property. items: $ref: '#/components/schemas/balance_amount' type: array connect_reserved: description: Funds held due to negative balances on connected Custom accounts. You can find the connect reserve balance for each currency and payment type in the `source_types` property. items: $ref: '#/components/schemas/balance_amount' type: array instant_available: description: Funds that you can pay out using Instant Payouts. items: $ref: '#/components/schemas/balance_amount_net' type: array issuing: $ref: '#/components/schemas/balance_detail' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. enum: - balance type: string pending: description: Funds that aren't available in the balance yet. You can find the pending balance for each currency and each payment type in the `source_types` property. items: $ref: '#/components/schemas/balance_amount' type: array required: - available - livemode - object - pending title: Balance type: object x-expandableFields: - available - connect_reserved - instant_available - issuing - pending x-resourceId: balance InvoicesItemsList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/invoiceitem' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/Invoice Items type: string payment_method: description: 'PaymentMethod objects represent your customer''s payment instruments. You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) to collect payments or save them to Customer objects to store instrument details for future payments. Related guides: [Payment Methods](https://stripe.com/docs/payments/payment-methods) and [More Payment Scenarios](https://stripe.com/docs/payments/more-payment-scenarios).' properties: acss_debit: $ref: '#/components/schemas/payment_method_acss_debit' affirm: $ref: '#/components/schemas/payment_method_affirm' afterpay_clearpay: $ref: '#/components/schemas/payment_method_afterpay_clearpay' alipay: $ref: '#/components/schemas/payment_flows_private_payment_methods_alipay' au_becs_debit: $ref: '#/components/schemas/payment_method_au_becs_debit' bacs_debit: $ref: '#/components/schemas/payment_method_bacs_debit' bancontact: $ref: '#/components/schemas/payment_method_bancontact' billing_details: $ref: '#/components/schemas/billing_details' blik: $ref: '#/components/schemas/payment_method_blik' boleto: $ref: '#/components/schemas/payment_method_boleto' card: $ref: '#/components/schemas/payment_method_card' card_present: $ref: '#/components/schemas/payment_method_card_present' cashapp: $ref: '#/components/schemas/payment_method_cashapp' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' description: The ID of the Customer to which this PaymentMethod is saved. This will not be set when the PaymentMethod has not been saved to a Customer. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' customer_balance: $ref: '#/components/schemas/payment_method_customer_balance' eps: $ref: '#/components/schemas/payment_method_eps' fpx: $ref: '#/components/schemas/payment_method_fpx' giropay: $ref: '#/components/schemas/payment_method_giropay' grabpay: $ref: '#/components/schemas/payment_method_grabpay' id: description: Unique identifier for the object. maxLength: 5000 type: string ideal: $ref: '#/components/schemas/payment_method_ideal' interac_present: $ref: '#/components/schemas/payment_method_interac_present' klarna: $ref: '#/components/schemas/payment_method_klarna' konbini: $ref: '#/components/schemas/payment_method_konbini' link: $ref: '#/components/schemas/payment_method_link' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object object: description: String representing the object's type. Objects of the same type share the same value. enum: - payment_method type: string oxxo: $ref: '#/components/schemas/payment_method_oxxo' p24: $ref: '#/components/schemas/payment_method_p24' paynow: $ref: '#/components/schemas/payment_method_paynow' paypal: $ref: '#/components/schemas/payment_method_paypal' pix: $ref: '#/components/schemas/payment_method_pix' promptpay: $ref: '#/components/schemas/payment_method_promptpay' radar_options: $ref: '#/components/schemas/radar_radar_options' revolut_pay: $ref: '#/components/schemas/payment_method_revolut_pay' sepa_debit: $ref: '#/components/schemas/payment_method_sepa_debit' sofort: $ref: '#/components/schemas/payment_method_sofort' type: description: The type of the PaymentMethod. An additional hash is included on the PaymentMethod with a name matching this value. It contains additional information specific to the PaymentMethod type. enum: - acss_debit - affirm - afterpay_clearpay - alipay - au_becs_debit - bacs_debit - bancontact - blik - boleto - card - card_present - cashapp - customer_balance - eps - fpx - giropay - grabpay - ideal - interac_present - klarna - konbini - link - oxxo - p24 - paynow - paypal - pix - promptpay - revolut_pay - sepa_debit - sofort - us_bank_account - wechat_pay - zip type: string x-stripeBypassValidation: true us_bank_account: $ref: '#/components/schemas/payment_method_us_bank_account' wechat_pay: $ref: '#/components/schemas/payment_method_wechat_pay' zip: $ref: '#/components/schemas/payment_method_zip' required: - billing_details - created - id - livemode - object - type title: PaymentMethod type: object x-expandableFields: - acss_debit - affirm - afterpay_clearpay - alipay - au_becs_debit - bacs_debit - bancontact - billing_details - blik - boleto - card - card_present - cashapp - customer - customer_balance - eps - fpx - giropay - grabpay - ideal - interac_present - klarna - konbini - link - oxxo - p24 - paynow - paypal - pix - promptpay - radar_options - revolut_pay - sepa_debit - sofort - us_bank_account - wechat_pay - zip x-resourceId: payment_method PaymentLinksResourcePaymentLinkList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/payment_link' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/payment_links type: string GetFinancialConnectionsAccountsAccountRequest: type: object properties: {} GetCustomersCustomerSourcesIdRequest: type: object properties: {} GetIssuingDisputesRequest: type: object properties: {} GetPaymentMethodsRequest: type: object properties: {} DisputeList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/dispute' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/disputes type: string payment_method_domain: description: 'A payment method domain represents a web domain that you have registered with Stripe. Stripe Elements use registered payment method domains to control where certain payment methods are shown. Related guides: [Payment method domains](https://stripe.com/docs/payments/payment-methods/pmd-registration).' properties: apple_pay: $ref: '#/components/schemas/payment_method_domain_resource_payment_method_status' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer domain_name: description: The domain name that this payment method domain object represents. maxLength: 5000 type: string enabled: description: Whether this payment method domain is enabled. If the domain is not enabled, payment methods that require a payment method domain will not appear in Elements. type: boolean google_pay: $ref: '#/components/schemas/payment_method_domain_resource_payment_method_status' id: description: Unique identifier for the object. maxLength: 5000 type: string link: $ref: '#/components/schemas/payment_method_domain_resource_payment_method_status' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. enum: - payment_method_domain type: string paypal: $ref: '#/components/schemas/payment_method_domain_resource_payment_method_status' required: - apple_pay - created - domain_name - enabled - google_pay - id - link - livemode - object - paypal title: PaymentMethodDomainResourcePaymentMethodDomain type: object x-expandableFields: - apple_pay - google_pay - link - paypal x-resourceId: payment_method_domain GetDisputesDisputeRequest: type: object properties: {} GetCustomersSearchRequest: type: object properties: {} customer_cash_balance_transaction: description: 'Customers with certain payments enabled have a cash balance, representing funds that were paid by the customer to a merchant, but have not yet been allocated to a payment. Cash Balance Transactions represent when funds are moved into or out of this balance. This includes funding by the customer, allocation to payments, and refunds to the customer.' properties: adjusted_for_overdraft: $ref: '#/components/schemas/customer_balance_resource_cash_balance_transaction_resource_adjusted_for_overdraft' applied_to_payment: $ref: '#/components/schemas/customer_balance_resource_cash_balance_transaction_resource_applied_to_payment_transaction' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). maxLength: 5000 type: string customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' description: The customer whose available cash balance changed as a result of this transaction. x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' ending_balance: description: The total available cash balance for the specified currency after this transaction was applied. Represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). type: integer funded: $ref: '#/components/schemas/customer_balance_resource_cash_balance_transaction_resource_funded_transaction' id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean net_amount: description: The amount by which the cash balance changed, represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). A positive value represents funds being added to the cash balance, a negative value represents funds being removed from the cash balance. type: integer object: description: String representing the object's type. Objects of the same type share the same value. enum: - customer_cash_balance_transaction type: string refunded_from_payment: $ref: '#/components/schemas/customer_balance_resource_cash_balance_transaction_resource_refunded_from_payment_transaction' transferred_to_balance: $ref: '#/components/schemas/customer_balance_resource_cash_balance_transaction_resource_transferred_to_balance' type: description: The type of the cash balance transaction. New types may be added in future. See [Customer Balance](https://stripe.com/docs/payments/customer-balance#types) to learn more about these types. enum: - adjusted_for_overdraft - applied_to_payment - funded - funding_reversed - refunded_from_payment - return_canceled - return_initiated - transferred_to_balance - unapplied_from_payment type: string unapplied_from_payment: $ref: '#/components/schemas/customer_balance_resource_cash_balance_transaction_resource_unapplied_from_payment_transaction' required: - created - currency - customer - ending_balance - id - livemode - net_amount - object - type title: CustomerCashBalanceTransaction type: object x-expandableFields: - adjusted_for_overdraft - applied_to_payment - customer - funded - refunded_from_payment - transferred_to_balance - unapplied_from_payment x-resourceId: customer_cash_balance_transaction PortalPublicResourceConfigurationList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/billing_portal.configuration' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/billing_portal/configurations type: string GetCustomersCustomerCashBalanceTransactionsRequest: type: object properties: {} SearchResult_2: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/invoice' type: array has_more: type: boolean next_page: maxLength: 5000 nullable: true type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - search_result type: string total_count: description: The total number of objects that match the query, only accurate up to 10,000. type: integer url: maxLength: 5000 type: string GetFilesFileRequest: type: object properties: {} CardList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/card' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string IssuingCardList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/issuing.card' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/issuing/cards type: string InvoicesList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/invoice' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/invoices type: string GetPaymentMethodDomainsPaymentMethodDomainRequest: type: object properties: {} GetCouponsCouponRequest: type: object properties: {} GetPayoutsRequest: type: object properties: {} GetIssuingTokensRequest: type: object properties: {} GetIssuingCardsRequest: type: object properties: {} price: description: 'Prices define the unit cost, currency, and (optional) billing cycle for both recurring and one-time purchases of products. [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme. For example, you might have a single "gold" product that has prices for $10/month, $100/year, and €9 once. Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription), [create an invoice](https://stripe.com/docs/billing/invoices/create), and more about [products and prices](https://stripe.com/docs/products-prices/overview).' properties: active: description: Whether the price can be used for new purchases. type: boolean billing_scheme: description: Describes how to compute the price per period. Either `per_unit` or `tiered`. `per_unit` indicates that the fixed amount (specified in `unit_amount` or `unit_amount_decimal`) will be charged per unit in `quantity` (for prices with `usage_type=licensed`), or per unit of total usage (for prices with `usage_type=metered`). `tiered` indicates that the unit pricing will be computed using a tiering strategy as defined using the `tiers` and `tiers_mode` attributes. enum: - per_unit - tiered type: string created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string currency_options: additionalProperties: $ref: '#/components/schemas/currency_option' description: Prices defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies). type: object custom_unit_amount: anyOf: - $ref: '#/components/schemas/custom_unit_amount' description: When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links. nullable: true id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean lookup_key: description: A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters. maxLength: 5000 nullable: true type: string metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object nickname: description: A brief description of the price, hidden from customers. maxLength: 5000 nullable: true type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - price type: string product: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/product' - $ref: '#/components/schemas/deleted_product' description: The ID of the product this price is associated with. x-expansionResources: oneOf: - $ref: '#/components/schemas/product' - $ref: '#/components/schemas/deleted_product' recurring: anyOf: - $ref: '#/components/schemas/recurring' description: The recurring components of a price such as `interval` and `usage_type`. nullable: true tax_behavior: description: Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. enum: - exclusive - inclusive - unspecified nullable: true type: string tiers: description: Each element represents a pricing tier. This parameter requires `billing_scheme` to be set to `tiered`. See also the documentation for `billing_scheme`. items: $ref: '#/components/schemas/price_tier' type: array tiers_mode: description: Defines if the tiering price should be `graduated` or `volume` based. In `volume`-based tiering, the maximum quantity within a period determines the per unit price. In `graduated` tiering, pricing can change as the quantity grows. enum: - graduated - volume nullable: true type: string transform_quantity: anyOf: - $ref: '#/components/schemas/transform_quantity' description: Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with `tiers`. nullable: true type: description: One of `one_time` or `recurring` depending on whether the price is for a one-time purchase or a recurring (subscription) purchase. enum: - one_time - recurring type: string unit_amount: description: The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if `billing_scheme=per_unit`. nullable: true type: integer unit_amount_decimal: description: The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if `billing_scheme=per_unit`. format: decimal nullable: true type: string required: - active - billing_scheme - created - currency - id - livemode - metadata - object - product - type title: Price type: object x-expandableFields: - currency_options - custom_unit_amount - product - recurring - tiers - transform_quantity x-resourceId: price PaymentPagesCheckoutSessionListLineItems: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/item' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string GetExchangeRatesRateIdRequest: type: object properties: {} PaymentPagesCheckoutSessionList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/checkout.session' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string exchange_rate: description: '`ExchangeRate` objects allow you to determine the rates that Stripe is currently using to convert from one currency to another. Since this number is variable throughout the day, there are various reasons why you might want to know the current rate (for example, to dynamically price an item for a user with a default payment in a foreign currency). Please refer to our [Exchange Rates API](https://stripe.com/docs/fx-rates) guide for more details. *[Note: this integration path is supported but no longer recommended]* Additionally, you can guarantee that a charge is made with an exchange rate that you expect is current. To do so, you must pass in the exchange_rate to charges endpoints. If the value is no longer up to date, the charge won''t go through. Please refer to our [Using with charges](https://stripe.com/docs/exchange-rates) guide for more details. --   *This Exchange Rates API is a Beta Service and is subject to Stripe''s terms of service. You may use the API solely for the purpose of transacting on Stripe. For example, the API may be queried in order to:* - *localize prices for processing payments on Stripe* - *reconcile Stripe transactions* - *determine how much money to send to a connected account* - *determine app fees to charge a connected account* *Using this Exchange Rates API beta for any purpose other than to transact on Stripe is strictly prohibited and constitutes a violation of Stripe''s terms of service.*' properties: id: description: Unique identifier for the object. Represented as the three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) in lowercase. maxLength: 5000 type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - exchange_rate type: string rates: additionalProperties: type: number description: Hash where the keys are supported currencies and the values are the exchange rate at which the base id currency converts to the key currency. type: object required: - id - object - rates title: ExchangeRate type: object x-expandableFields: [] x-resourceId: exchange_rate customer: description: 'This object represents a customer of your business. Use it to create recurring charges and track payments that belong to the same customer. Related guide: [Save a card during payment](https://stripe.com/docs/payments/save-during-payment)' properties: address: anyOf: - $ref: '#/components/schemas/address' description: The customer's address. nullable: true balance: description: The current balance, if any, that's stored on the customer. If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that's added to their next invoice. The balance only considers amounts that Stripe hasn't successfully applied to any invoice. It doesn't reflect unpaid invoices. This balance is only taken into account after invoices finalize. type: integer cash_balance: anyOf: - $ref: '#/components/schemas/cash_balance' description: The current funds being held by Stripe on behalf of the customer. You can apply these funds towards payment intents when the source is "cash_balance". The `settings[reconciliation_mode]` field describes if these funds apply to these payment intents manually or automatically. nullable: true created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) the customer can be charged in for recurring billing purposes. maxLength: 5000 nullable: true type: string default_source: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/source' description: 'ID of the default payment source for the customer. If you use payment methods created through the PaymentMethods API, see the [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) field instead.' nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/source' x-stripeBypassValidation: true delinquent: description: 'Tracks the most recent state change on any invoice belonging to the customer. Paying an invoice or marking it uncollectible via the API will set this field to false. An automatic payment failure or passing the `invoice.due_date` will set this field to `true`. If an invoice becomes uncollectible by [dunning](https://stripe.com/docs/billing/automatic-collection), `delinquent` doesn''t reset to `false`. If you care whether the customer has paid their most recent subscription invoice, use `subscription.status` instead. Paying or marking uncollectible any customer invoice regardless of whether it is the latest invoice for a subscription will always set this field to `false`.' nullable: true type: boolean description: description: An arbitrary string attached to the object. Often useful for displaying to users. maxLength: 5000 nullable: true type: string discount: anyOf: - $ref: '#/components/schemas/discount' description: Describes the current discount active on the customer, if there is one. nullable: true email: description: The customer's email address. maxLength: 5000 nullable: true type: string id: description: Unique identifier for the object. maxLength: 5000 type: string invoice_credit_balance: additionalProperties: type: integer description: The current multi-currency balances, if any, that's stored on the customer. If positive in a currency, the customer has a credit to apply to their next invoice denominated in that currency. If negative, the customer has an amount owed that's added to their next invoice denominated in that currency. These balances don't apply to unpaid invoices. They solely track amounts that Stripe hasn't successfully applied to any invoice. Stripe only applies a balance in a specific currency to an invoice after that invoice (which is in the same currency) finalizes. type: object invoice_prefix: description: The prefix for the customer used to generate unique invoice numbers. maxLength: 5000 nullable: true type: string invoice_settings: $ref: '#/components/schemas/invoice_setting_customer_setting' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object name: description: The customer's full name or business name. maxLength: 5000 nullable: true type: string next_invoice_sequence: description: The suffix of the customer's next invoice number (for example, 0001). type: integer object: description: String representing the object's type. Objects of the same type share the same value. enum: - customer type: string phone: description: The customer's phone number. maxLength: 5000 nullable: true type: string preferred_locales: description: The customer's preferred locales (languages), ordered by preference. items: maxLength: 5000 type: string nullable: true type: array shipping: anyOf: - $ref: '#/components/schemas/shipping' description: Mailing and shipping address for the customer. Appears on invoices emailed to this customer. nullable: true sources: description: The customer's payment sources, if any. properties: data: description: Details about each object. items: anyOf: - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/source' title: Polymorphic x-stripeBypassValidation: true type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string required: - data - has_more - object - url title: ApmsSourcesSourceList type: object x-expandableFields: - data subscriptions: description: The customer's current subscriptions, if any. properties: data: description: Details about each object. items: $ref: '#/components/schemas/subscription' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string required: - data - has_more - object - url title: SubscriptionList type: object x-expandableFields: - data tax: $ref: '#/components/schemas/customer_tax' tax_exempt: description: 'Describes the customer''s tax exemption status, which is `none`, `exempt`, or `reverse`. When set to `reverse`, invoice and receipt PDFs include the following text: **"Reverse charge"**.' enum: - exempt - none - reverse nullable: true type: string tax_ids: description: The customer's tax IDs. properties: data: description: Details about each object. items: $ref: '#/components/schemas/tax_id' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string required: - data - has_more - object - url title: TaxIDsList type: object x-expandableFields: - data test_clock: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/test_helpers.test_clock' description: ID of the test clock that this customer belongs to. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/test_helpers.test_clock' required: - created - id - livemode - object title: Customer type: object x-expandableFields: - address - cash_balance - default_source - discount - invoice_settings - shipping - sources - subscriptions - tax - tax_ids - test_clock x-resourceId: customer GetBillingPortalConfigurationsRequest: type: object properties: {} GetLinkedAccountsRequest: type: object properties: {} credit_note: description: 'Issue a credit note to adjust an invoice''s amount after the invoice is finalized. Related guide: [Credit notes](https://stripe.com/docs/billing/invoices/credit-notes)' properties: amount: description: The integer amount in cents (or local equivalent) representing the total amount of the credit note, including tax. type: integer amount_shipping: description: This is the sum of all the shipping amounts. type: integer created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: ID of the customer. x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' customer_balance_transaction: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer_balance_transaction' description: Customer balance transaction related to this credit note. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/customer_balance_transaction' discount_amount: description: The integer amount in cents (or local equivalent) representing the total amount of discount that was credited. type: integer discount_amounts: description: The aggregate amounts calculated per discount for all line items. items: $ref: '#/components/schemas/discounts_resource_discount_amount' type: array effective_at: description: The date when this credit note is in effect. Same as `created` unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the credit note PDF. format: unix-time nullable: true type: integer id: description: Unique identifier for the object. maxLength: 5000 type: string invoice: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/invoice' description: ID of the invoice. x-expansionResources: oneOf: - $ref: '#/components/schemas/invoice' lines: description: Line items that make up the credit note properties: data: description: Details about each object. items: $ref: '#/components/schemas/credit_note_line_item' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string required: - data - has_more - object - url title: CreditNoteLinesList type: object x-expandableFields: - data livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean memo: description: Customer-facing text that appears on the credit note PDF. maxLength: 5000 nullable: true type: string metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object number: description: A unique number that identifies this particular credit note and appears on the PDF of the credit note and its associated invoice. maxLength: 5000 type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - credit_note type: string out_of_band_amount: description: Amount that was credited outside of Stripe. nullable: true type: integer pdf: description: The link to download the PDF of the credit note. maxLength: 5000 type: string reason: description: Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory` enum: - duplicate - fraudulent - order_change - product_unsatisfactory nullable: true type: string refund: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/refund' description: Refund related to this credit note. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/refund' shipping_cost: anyOf: - $ref: '#/components/schemas/invoices_shipping_cost' description: The details of the cost of shipping, including the ShippingRate applied to the invoice. nullable: true status: description: Status of this credit note, one of `issued` or `void`. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding). enum: - issued - void type: string subtotal: description: The integer amount in cents (or local equivalent) representing the amount of the credit note, excluding exclusive tax and invoice level discounts. type: integer subtotal_excluding_tax: description: The integer amount in cents (or local equivalent) representing the amount of the credit note, excluding all tax and invoice level discounts. nullable: true type: integer tax_amounts: description: The aggregate amounts calculated per tax rate for all line items. items: $ref: '#/components/schemas/credit_note_tax_amount' type: array total: description: The integer amount in cents (or local equivalent) representing the total amount of the credit note, including tax and all discount. type: integer total_excluding_tax: description: The integer amount in cents (or local equivalent) representing the total amount of the credit note, excluding tax, but including discounts. nullable: true type: integer type: description: Type of this credit note, one of `pre_payment` or `post_payment`. A `pre_payment` credit note means it was issued when the invoice was open. A `post_payment` credit note means it was issued when the invoice was paid. enum: - post_payment - pre_payment type: string voided_at: description: The time that the credit note was voided. format: unix-time nullable: true type: integer required: - amount - amount_shipping - created - currency - customer - discount_amount - discount_amounts - id - invoice - lines - livemode - number - object - pdf - status - subtotal - tax_amounts - total - type title: CreditNote type: object x-expandableFields: - customer - customer_balance_transaction - discount_amounts - invoice - lines - refund - shipping_cost - tax_amounts x-resourceId: credit_note GetIssuingCardholdersRequest: type: object properties: {} PaymentFlowsPaymentMethodList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/payment_method' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/payment_methods type: string GetPaymentMethodsPaymentMethodRequest: type: object properties: {} GelatoVerificationSessionList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/identity.verification_session' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/identity/verification_sessions type: string GetCreditNotesRequest: type: object properties: {} cash_balance: description: A customer's `Cash balance` represents real funds. Customers can add funds to their cash balance by sending a bank transfer. These funds can be used for payment and can eventually be paid out to your bank account. properties: available: additionalProperties: type: integer description: A hash of all cash balances available to this customer. You cannot delete a customer with any cash balances, even if the balance is 0. Amounts are represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). nullable: true type: object customer: description: The ID of the customer whose cash balance this object represents. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. enum: - cash_balance type: string settings: $ref: '#/components/schemas/customer_balance_customer_balance_settings' required: - customer - livemode - object - settings title: cash_balance type: object x-expandableFields: - settings x-resourceId: cash_balance CreditNotesList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/credit_note' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string GetIssuingTransactionsTransactionRequest: type: object properties: {} GetCustomersCustomerCardsIdRequest: type: object properties: {} PlanList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/plan' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/plans type: string identity.verification_report: description: 'A VerificationReport is the result of an attempt to collect and verify data from a user. The collection of verification checks performed is determined from the `type` and `options` parameters used. You can find the result of each verification check performed in the appropriate sub-resource: `document`, `id_number`, `selfie`. Each VerificationReport contains a copy of any data collected by the user as well as reference IDs which can be used to access collected images through the [FileUpload](https://stripe.com/docs/api/files) API. To configure and create VerificationReports, use the [VerificationSession](https://stripe.com/docs/api/identity/verification_sessions) API. Related guides: [Accessing verification results](https://stripe.com/docs/identity/verification-sessions#results).' properties: created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer document: $ref: '#/components/schemas/gelato_document_report' id: description: Unique identifier for the object. maxLength: 5000 type: string id_number: $ref: '#/components/schemas/gelato_id_number_report' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. enum: - identity.verification_report type: string options: $ref: '#/components/schemas/gelato_verification_report_options' selfie: $ref: '#/components/schemas/gelato_selfie_report' type: description: Type of report. enum: - document - id_number type: string x-stripeBypassValidation: true verification_session: description: ID of the VerificationSession that created this report. maxLength: 5000 nullable: true type: string required: - created - id - livemode - object title: GelatoVerificationReport type: object x-expandableFields: - document - id_number - options - selfie x-resourceId: identity.verification_report bank_account: description: 'These bank accounts are payment methods on `Customer` objects. On the other hand [External Accounts](https://stripe.com/docs/api#external_accounts) are transfer destinations on `Account` objects for [Custom accounts](https://stripe.com/docs/connect/custom-accounts). They can be bank accounts or debit cards as well, and are documented in the links above. Related guide: [Bank debits and transfers](https://stripe.com/docs/payments/bank-debits-transfers)' properties: account: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/account' description: The ID of the account that the bank account is associated with. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/account' account_holder_name: description: The name of the person or business that owns the bank account. maxLength: 5000 nullable: true type: string account_holder_type: description: The type of entity that holds the account. This can be either `individual` or `company`. maxLength: 5000 nullable: true type: string account_type: description: The bank account type. This can only be `checking` or `savings` in most countries. In Japan, this can only be `futsu` or `toza`. maxLength: 5000 nullable: true type: string available_payout_methods: description: A set of available payout methods for this bank account. Only values from this set should be passed as the `method` when creating a payout. items: enum: - instant - standard type: string nullable: true type: array bank_name: description: Name of the bank associated with the routing number (e.g., `WELLS FARGO`). maxLength: 5000 nullable: true type: string country: description: Two-letter ISO code representing the country the bank account is located in. maxLength: 5000 type: string currency: description: Three-letter [ISO code for the currency](https://stripe.com/docs/payouts) paid out to the bank account. type: string customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: The ID of the customer that the bank account is associated with. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' default_for_currency: description: Whether this bank account is the default external account for its currency. nullable: true type: boolean fingerprint: description: Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. maxLength: 5000 nullable: true type: string future_requirements: anyOf: - $ref: '#/components/schemas/external_account_requirements' description: Information about the [upcoming new requirements for the bank account](https://stripe.com/docs/connect/custom-accounts/future-requirements), including what information needs to be collected, and by when. nullable: true id: description: Unique identifier for the object. maxLength: 5000 type: string last4: description: The last four digits of the bank account number. maxLength: 5000 type: string metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object object: description: String representing the object's type. Objects of the same type share the same value. enum: - bank_account type: string requirements: anyOf: - $ref: '#/components/schemas/external_account_requirements' description: Information about the requirements for the bank account, including what information needs to be collected. nullable: true routing_number: description: The routing transit number for the bank account. maxLength: 5000 nullable: true type: string status: description: 'For bank accounts, possible values are `new`, `validated`, `verified`, `verification_failed`, or `errored`. A bank account that hasn''t had any activity or validation performed is `new`. If Stripe can determine that the bank account exists, its status will be `validated`. Note that there often isn’t enough information to know (e.g., for smaller credit unions), and the validation is not always run. If customer bank account verification has succeeded, the bank account status will be `verified`. If the verification failed for any reason, such as microdeposit failure, the status will be `verification_failed`. If a payout sent to this bank account fails, we''ll set the status to `errored` and will not continue to send [scheduled payouts](https://stripe.com/docs/payouts#payout-schedule) until the bank details are updated. For external accounts, possible values are `new`, `errored` and `verification_failed`. If a payouts fails, the status is set to `errored` and scheduled payouts are stopped until account details are updated. In India, if we can''t [verify the owner of the bank account](https://support.stripe.com/questions/bank-account-ownership-verification), we''ll set the status to `verification_failed`. Other validations aren''t run against external accounts because they''re only used for payouts. This means the other statuses don''t apply.' maxLength: 5000 type: string required: - country - currency - id - last4 - object - status title: BankAccount type: object x-expandableFields: - account - customer - future_requirements - requirements x-resourceId: bank_account PaymentMethodDomainResourcePaymentMethodDomainList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/payment_method_domain' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/payment_method_domains type: string GetCreditNotesPreviewLinesRequest: type: object properties: {} GetFinancialConnectionsSessionsSessionRequest: type: object properties: {} CustomerPaymentMethodResourceList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/payment_method' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string event: description: 'Events are our way of letting you know when something interesting happens in your account. When an interesting event occurs, we create a new `Event` object. For example, when a charge succeeds, we create a `charge.succeeded` event, and when an invoice payment attempt fails, we create an `invoice.payment_failed` event. Certain API requests might create multiple events. For example, if you create a new subscription for a customer, you receive both a `customer.subscription.created` event and a `charge.succeeded` event. Events occur when the state of another API resource changes. The event''s data field embeds the resource''s state at the time of the change. For example, a `charge.succeeded` event contains a charge, and an `invoice.payment_failed` event contains an invoice. As with other API resources, you can use endpoints to retrieve an [individual event](https://stripe.com/docs/api#retrieve_event) or a [list of events](https://stripe.com/docs/api#list_events) from the API. We also have a separate [webhooks](http://en.wikipedia.org/wiki/Webhook) system for sending the `Event` objects directly to an endpoint on your server. You can manage webhooks in your [account settings](https://dashboard.stripe.com/account/webhooks). Learn how to [listen for events](https://stripe.com/docs/webhooks) so that your integration can automatically trigger reactions. When using [Connect](https://stripe.com/docs/connect), you can also receive event notifications that occur in connected accounts. For these events, there''s an additional `account` attribute in the received `Event` object. We only guarantee access to events through the [Retrieve Event API](https://stripe.com/docs/api#retrieve_event) for 30 days.' properties: account: description: The connected account that originates the event. maxLength: 5000 type: string api_version: description: The Stripe API version used to render `data`. This property is populated only for events on or after October 31, 2014. maxLength: 5000 nullable: true type: string created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer data: $ref: '#/components/schemas/notification_event_data' id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. enum: - event type: string pending_webhooks: description: Number of webhooks that haven't been successfully delivered (for example, to return a 20x response) to the URLs you specify. type: integer request: anyOf: - $ref: '#/components/schemas/notification_event_request' description: Information on the API request that triggers the event. nullable: true type: description: Description of the event (for example, `invoice.created` or `charge.refunded`). maxLength: 5000 type: string required: - created - data - id - livemode - object - pending_webhooks - type title: NotificationEvent type: object x-expandableFields: - data - request x-resourceId: event CountrySpecList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/country_spec' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/country_specs type: string issuing.card: description: You can [create physical or virtual cards](https://stripe.com/docs/issuing/cards) that are issued to cardholders. properties: brand: description: The brand of the card. maxLength: 5000 type: string cancellation_reason: description: The reason why the card was canceled. enum: - design_rejected - lost - stolen nullable: true type: string x-stripeBypassValidation: true cardholder: $ref: '#/components/schemas/issuing.cardholder' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Supported currencies are `usd` in the US, `eur` in the EU, and `gbp` in the UK. type: string cvc: description: The card's CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint. maxLength: 5000 type: string exp_month: description: The expiration month of the card. type: integer exp_year: description: The expiration year of the card. type: integer financial_account: description: The financial account this card is attached to. maxLength: 5000 nullable: true type: string id: description: Unique identifier for the object. maxLength: 5000 type: string last4: description: The last 4 digits of the card number. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object number: description: The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint. maxLength: 5000 type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - issuing.card type: string replaced_by: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.card' description: The latest card that replaces this card, if any. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.card' replacement_for: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.card' description: The card this card replaces, if any. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.card' replacement_reason: description: The reason why the previous card needed to be replaced. enum: - damaged - expired - lost - stolen nullable: true type: string x-stripeBypassValidation: true shipping: anyOf: - $ref: '#/components/schemas/issuing_card_shipping' description: Where and how the card will be shipped. nullable: true spending_controls: $ref: '#/components/schemas/issuing_card_authorization_controls' status: description: Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to `inactive`. enum: - active - canceled - inactive type: string x-stripeBypassValidation: true type: description: The type of the card. enum: - physical - virtual type: string wallets: anyOf: - $ref: '#/components/schemas/issuing_card_wallets' description: Information relating to digital wallets (like Apple Pay and Google Pay). nullable: true required: - brand - cardholder - created - currency - exp_month - exp_year - id - last4 - livemode - metadata - object - spending_controls - status - type title: IssuingCard type: object x-expandableFields: - cardholder - replaced_by - replacement_for - shipping - spending_controls - wallets x-resourceId: issuing.card GetExchangeRatesRequest: type: object properties: {} GetLinkedAccountsAccountOwnersRequest: type: object properties: {} GetIssuingAuthorizationsAuthorizationRequest: type: object properties: {} GetInvoicesSearchRequest: type: object properties: {} GetPricesRequest: type: object properties: {} GetIssuingDisputesDisputeRequest: type: object properties: {} PaymentLinksResourceListLineItems: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/item' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string GetCustomersCustomerPaymentMethodsPaymentMethodRequest: type: object properties: {} GetIssuingSettlementsSettlementRequest: type: object properties: {} GetIssuingCardsCardRequest: type: object properties: {} financial_connections.transaction: description: A Transaction represents a real transaction that affects a Financial Connections Account balance. properties: account: description: The ID of the Financial Connections Account this transaction belongs to. maxLength: 5000 type: string amount: description: The amount of this transaction, in cents (or local equivalent). type: integer currency: description: 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). maxLength: 5000 type: string description: description: The description of this transaction. maxLength: 5000 type: string id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. enum: - financial_connections.transaction type: string status: description: The status of the transaction. enum: - pending - posted - void type: string status_transitions: $ref: '#/components/schemas/bank_connections_resource_transaction_resource_status_transitions' transacted_at: description: Time at which the transaction was transacted. Measured in seconds since the Unix epoch. format: unix-time type: integer transaction_refresh: description: The token of the transaction refresh that last updated or created this transaction. maxLength: 5000 type: string updated: description: Time at which the object was last updated. Measured in seconds since the Unix epoch. format: unix-time type: integer required: - account - amount - currency - description - id - livemode - object - status - status_transitions - transacted_at - transaction_refresh - updated title: BankConnectionsResourceTransaction type: object x-expandableFields: - status_transitions x-resourceId: financial_connections.transaction GetCreditNotesIdRequest: type: object properties: {} GetBalanceTransactionsIdRequest: type: object properties: {} customer_balance_transaction: description: 'Each customer has a [Balance](https://stripe.com/docs/api/customers/object#customer_object-balance) value, which denotes a debit or credit that''s automatically applied to their next invoice upon finalization. You may modify the value directly by using the [update customer API](https://stripe.com/docs/api/customers/update), or by creating a Customer Balance Transaction, which increments or decrements the customer''s `balance` by the specified `amount`. Related guide: [Customer balance](https://stripe.com/docs/billing/customer/balance)' properties: amount: description: The amount of the transaction. A negative value is a credit for the customer's balance, and a positive value is a debit to the customer's `balance`. type: integer created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer credit_note: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/credit_note' description: The ID of the credit note (if any) related to the transaction. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/credit_note' currency: description: 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). type: string customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' description: The ID of the customer the transaction belongs to. x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' description: description: An arbitrary string attached to the object. Often useful for displaying to users. maxLength: 5000 nullable: true type: string ending_balance: description: The customer's `balance` after the transaction was applied. A negative value decreases the amount due on the customer's next invoice. A positive value increases the amount due on the customer's next invoice. type: integer id: description: Unique identifier for the object. maxLength: 5000 type: string invoice: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/invoice' description: The ID of the invoice (if any) related to the transaction. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/invoice' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object object: description: String representing the object's type. Objects of the same type share the same value. enum: - customer_balance_transaction type: string type: description: 'Transaction type: `adjustment`, `applied_to_invoice`, `credit_note`, `initial`, `invoice_overpaid`, `invoice_too_large`, `invoice_too_small`, `unspent_receiver_credit`, or `unapplied_from_invoice`. See the [Customer Balance page](https://stripe.com/docs/billing/customer/balance#types) to learn more about transaction types.' enum: - adjustment - applied_to_invoice - credit_note - initial - invoice_overpaid - invoice_too_large - invoice_too_small - migration - unapplied_from_invoice - unspent_receiver_credit type: string required: - amount - created - currency - customer - ending_balance - id - livemode - object - type title: CustomerBalanceTransaction type: object x-expandableFields: - credit_note - customer - invoice x-resourceId: customer_balance_transaction GetDisputesRequest: type: object properties: {} GetCustomersCustomerBankAccountsIdRequest: type: object properties: {} GetCustomersCustomerBankAccountsRequest: type: object properties: {} issuing.token: description: An issuing token object is created when an issued card is added to a digital wallet. As a [card issuer](https://stripe.com/docs/issuing), you can [view and manage these tokens](https://stripe.com/docs/issuing/controls/token-management) through Stripe. properties: card: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.card' description: Card associated with this token. x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.card' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer device_fingerprint: description: The hashed ID derived from the device ID from the card network associated with the token maxLength: 5000 nullable: true type: string id: description: Unique identifier for the object. maxLength: 5000 type: string last4: description: The last four digits of the token. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean network: description: The token service provider / card network associated with the token. enum: - mastercard - visa type: string network_data: $ref: '#/components/schemas/issuing_network_token_network_data' network_updated_at: description: Time at which the token was last updated by the card network. Measured in seconds since the Unix epoch. format: unix-time type: integer object: description: String representing the object's type. Objects of the same type share the same value. enum: - issuing.token type: string status: description: The usage state of the token. enum: - active - deleted - requested - suspended type: string wallet_provider: description: The digital wallet for this token, if one was used. enum: - apple_pay - google_pay - samsung_pay type: string required: - card - created - id - livemode - network - network_updated_at - object - status title: IssuingNetworkToken type: object x-expandableFields: - card - network_data x-resourceId: issuing.token GetIssuingCardholdersCardholderRequest: type: object properties: {} GetFilesRequest: type: object properties: {} GetFinancialConnectionsAccountsRequest: type: object properties: {} GetPaymentLinksRequest: type: object properties: {} GetIssuingTokensTokenRequest: type: object properties: {} IssuingNetworkTokenList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/issuing.token' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string GetInvoicesRequest: type: object properties: {} GetInvoice ItemsRequest: type: object properties: {} SearchResult: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/customer' type: array has_more: type: boolean next_page: maxLength: 5000 nullable: true type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - search_result type: string total_count: description: The total number of objects that match the query, only accurate up to 10,000. type: integer url: maxLength: 5000 type: string GetFinancialConnectionsTransactionsRequest: type: object properties: {} GetCustomersCustomerPaymentMethodsRequest: type: object properties: {} GetPaymentMethodDomainsRequest: type: object properties: {} GetInvoicesUpcomingLinesRequest: type: object properties: {} issuing.transaction: description: 'Any use of an [issued card](https://stripe.com/docs/issuing) that results in funds entering or leaving your Stripe account, such as a completed purchase or refund, is represented by an Issuing `Transaction` object. Related guide: [Issued card transactions](https://stripe.com/docs/issuing/purchases/transactions)' properties: amount: description: The transaction amount, which will be reflected in your balance. This amount is in your currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). type: integer amount_details: anyOf: - $ref: '#/components/schemas/issuing_transaction_amount_details' description: Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). nullable: true authorization: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.authorization' description: The `Authorization` object that led to this transaction. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.authorization' balance_transaction: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/balance_transaction' description: ID of the [balance transaction](https://stripe.com/docs/api/balance_transactions) associated with this transaction. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/balance_transaction' card: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.card' description: The card used to make this transaction. x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.card' cardholder: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.cardholder' description: The cardholder to whom this transaction belongs. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.cardholder' created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string dispute: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.dispute' description: If you've disputed the transaction, the ID of the dispute. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.dispute' id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean merchant_amount: description: The amount that the merchant will receive, denominated in `merchant_currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). It will be different from `amount` if the merchant is taking payment in a different currency. type: integer merchant_currency: description: The currency with which the merchant is taking payment. type: string merchant_data: $ref: '#/components/schemas/issuing_authorization_merchant_data' metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object network_data: anyOf: - $ref: '#/components/schemas/issuing_transaction_network_data' description: Details about the transaction, such as processing dates, set by the card network. nullable: true object: description: String representing the object's type. Objects of the same type share the same value. enum: - issuing.transaction type: string purchase_details: anyOf: - $ref: '#/components/schemas/issuing_transaction_purchase_details' description: Additional purchase information that is optionally provided by the merchant. nullable: true token: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/issuing.token' description: '[Token](https://stripe.com/docs/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null.' nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/issuing.token' treasury: anyOf: - $ref: '#/components/schemas/issuing_transaction_treasury' description: '[Treasury](https://stripe.com/docs/api/treasury) details related to this transaction if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts' nullable: true type: description: The nature of the transaction. enum: - capture - refund type: string x-stripeBypassValidation: true wallet: description: The digital wallet used for this transaction. One of `apple_pay`, `google_pay`, or `samsung_pay`. enum: - apple_pay - google_pay - samsung_pay nullable: true type: string required: - amount - card - created - currency - id - livemode - merchant_amount - merchant_currency - merchant_data - metadata - object - type title: IssuingTransaction type: object x-expandableFields: - amount_details - authorization - balance_transaction - card - cardholder - dispute - merchant_data - network_data - purchase_details - token - treasury x-resourceId: issuing.transaction GetEventsRequest: type: object properties: {} GetCustomersCustomerBalanceTransactionsRequest: type: object properties: {} invoiceitem: description: 'Invoice Items represent the component lines of an [invoice](https://stripe.com/docs/api/invoices). An invoice item is added to an invoice by creating or updating it with an `invoice` field, at which point it will be included as [an invoice line item](https://stripe.com/docs/api/invoices/line_item) within [invoice.lines](https://stripe.com/docs/api/invoices/object#invoice_object-lines). Invoice Items can be created before you are ready to actually send the invoice. This can be particularly useful when combined with a [subscription](https://stripe.com/docs/api/subscriptions). Sometimes you want to add a charge or credit to a customer, but actually charge or credit the customer’s card only at the end of a regular billing cycle. This is useful for combining several charges (to minimize per-transaction fees), or for having Stripe tabulate your usage-based billing totals. Related guides: [Integrate with the Invoicing API](https://stripe.com/docs/invoicing/integration), [Subscription Invoices](https://stripe.com/docs/billing/invoices/subscription#adding-upcoming-invoice-items).' properties: amount: description: Amount (in the `currency` specified) of the invoice item. This should always be equal to `unit_amount * quantity`. type: integer currency: description: 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). type: string customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: The ID of the customer who will be billed when this invoice item is billed. x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' date: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer description: description: An arbitrary string attached to the object. Often useful for displaying to users. maxLength: 5000 nullable: true type: string discountable: description: If true, discounts will apply to this invoice item. Always false for prorations. type: boolean discounts: description: The discounts which apply to the invoice item. Item discounts are applied before invoice discounts. Use `expand[]=discounts` to expand each discount. items: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/discount' x-expansionResources: oneOf: - $ref: '#/components/schemas/discount' nullable: true type: array id: description: Unique identifier for the object. maxLength: 5000 type: string invoice: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/invoice' description: The ID of the invoice this invoice item belongs to. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/invoice' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object object: description: String representing the object's type. Objects of the same type share the same value. enum: - invoiceitem type: string period: $ref: '#/components/schemas/invoice_line_item_period' price: anyOf: - $ref: '#/components/schemas/price' description: The price of the invoice item. nullable: true proration: description: Whether the invoice item was created automatically as a proration adjustment when the customer switched plans. type: boolean quantity: description: Quantity of units for the invoice item. If the invoice item is a proration, the quantity of the subscription that the proration was computed for. type: integer subscription: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/subscription' description: The subscription that this invoice item has been created for, if any. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/subscription' subscription_item: description: The subscription item that this invoice item has been created for, if any. maxLength: 5000 type: string tax_rates: description: The tax rates which apply to the invoice item. When set, the `default_tax_rates` on the invoice do not apply to this invoice item. items: $ref: '#/components/schemas/tax_rate' nullable: true type: array test_clock: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/test_helpers.test_clock' description: ID of the test clock this invoice item belongs to. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/test_helpers.test_clock' unit_amount: description: Unit amount (in the `currency` specified) of the invoice item. nullable: true type: integer unit_amount_decimal: description: Same as `unit_amount`, but contains a decimal value with at most 12 decimal places. format: decimal nullable: true type: string required: - amount - currency - customer - date - discountable - id - livemode - object - period - proration - quantity title: InvoiceItem type: object x-expandableFields: - customer - discounts - invoice - period - price - subscription - tax_rates - test_clock x-resourceId: invoiceitem BankConnectionsResourceTransactionList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/financial_connections.transaction' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/financial_connections/transactions type: string GetInvoicesInvoiceLinesRequest: type: object properties: {} subscription: description: 'Subscriptions allow you to charge a customer on a recurring basis. Related guide: [Creating subscriptions](https://stripe.com/docs/billing/subscriptions/creating)' properties: application: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/application' - $ref: '#/components/schemas/deleted_application' description: ID of the Connect Application that created the subscription. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/application' - $ref: '#/components/schemas/deleted_application' application_fee_percent: description: A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account. nullable: true type: number automatic_tax: $ref: '#/components/schemas/subscription_automatic_tax' billing_cycle_anchor: description: Determines the date of the first full invoice, and, for plans with `month` or `year` intervals, the day of the month for subsequent invoices. The timestamp is in UTC format. format: unix-time type: integer billing_thresholds: anyOf: - $ref: '#/components/schemas/subscription_billing_thresholds' description: Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period nullable: true cancel_at: description: A date in the future at which the subscription will automatically get canceled format: unix-time nullable: true type: integer cancel_at_period_end: description: If the subscription has been canceled with the `at_period_end` flag set to `true`, `cancel_at_period_end` on the subscription will be true. You can use this attribute to determine whether a subscription that has a status of active is scheduled to be canceled at the end of the current period. type: boolean canceled_at: description: If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with `cancel_at_period_end`, `canceled_at` will reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. format: unix-time nullable: true type: integer cancellation_details: anyOf: - $ref: '#/components/schemas/cancellation_details' description: Details about why this subscription was cancelled nullable: true collection_method: description: Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`. enum: - charge_automatically - send_invoice type: string created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string current_period_end: description: End of the current period that the subscription has been invoiced for. At the end of this period, a new invoice will be created. format: unix-time type: integer current_period_start: description: Start of the current period that the subscription has been invoiced for. format: unix-time type: integer customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: ID of the customer who owns the subscription. x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' days_until_due: description: Number of days a customer has to pay invoices generated by this subscription. This value will be `null` for subscriptions where `collection_method=charge_automatically`. nullable: true type: integer default_payment_method: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/payment_method' description: ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source). nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/payment_method' default_source: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/source' description: ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source). nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/source' x-stripeBypassValidation: true default_tax_rates: description: The tax rates that will apply to any subscription item that does not have `tax_rates` set. Invoices created will have their `default_tax_rates` populated from the subscription. items: $ref: '#/components/schemas/tax_rate' nullable: true type: array description: description: The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs. maxLength: 500 nullable: true type: string discount: anyOf: - $ref: '#/components/schemas/discount' description: Describes the current discount applied to this subscription, if there is one. When billing, a discount applied to a subscription overrides a discount applied on a customer-wide basis. nullable: true ended_at: description: If the subscription has ended, the date the subscription ended. format: unix-time nullable: true type: integer id: description: Unique identifier for the object. maxLength: 5000 type: string items: description: List of subscription items, each with an attached price. properties: data: description: Details about each object. items: $ref: '#/components/schemas/subscription_item' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string required: - data - has_more - object - url title: SubscriptionItemList type: object x-expandableFields: - data latest_invoice: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/invoice' description: The most recent invoice this subscription has generated. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/invoice' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object next_pending_invoice_item_invoice: description: Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at `pending_invoice_item_interval`. format: unix-time nullable: true type: integer object: description: String representing the object's type. Objects of the same type share the same value. enum: - subscription type: string on_behalf_of: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/account' description: The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/account' pause_collection: anyOf: - $ref: '#/components/schemas/subscriptions_resource_pause_collection' description: If specified, payment collection for this subscription will be paused. nullable: true payment_settings: anyOf: - $ref: '#/components/schemas/subscriptions_resource_payment_settings' description: Payment settings passed on to invoices created by the subscription. nullable: true pending_invoice_item_interval: anyOf: - $ref: '#/components/schemas/subscription_pending_invoice_item_interval' description: Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://stripe.com/docs/api#create_invoice) for the given subscription at the specified interval. nullable: true pending_setup_intent: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/setup_intent' description: You can use this [SetupIntent](https://stripe.com/docs/api/setup_intents) to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the [SCA Migration Guide](https://stripe.com/docs/billing/migration/strong-customer-authentication#scenario-2). nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/setup_intent' pending_update: anyOf: - $ref: '#/components/schemas/subscriptions_resource_pending_update' description: If specified, [pending updates](https://stripe.com/docs/billing/subscriptions/pending-updates) that will be applied to the subscription once the `latest_invoice` has been paid. nullable: true schedule: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/subscription_schedule' description: The schedule attached to the subscription nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/subscription_schedule' start_date: description: Date when the subscription was first created. The date might differ from the `created` date due to backdating. format: unix-time type: integer status: description: "Possible values are `incomplete`, `incomplete_expired`, `trialing`, `active`, `past_due`, `canceled`, or `unpaid`. \n\nFor `collection_method=charge_automatically` a subscription moves into `incomplete` if the initial payment attempt fails. A subscription in this state can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into an `active` state. If the first invoice is not paid within 23 hours, the subscription transitions to `incomplete_expired`. This is a terminal state, the open invoice will be voided and no further invoices will be generated. \n\nA subscription that is currently in a trial period is `trialing` and moves to `active` when the trial period is over. \n\nIf subscription `collection_method=charge_automatically`, it becomes `past_due` when payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will become `canceled` or `unpaid` (depending on your subscriptions settings). \n\nIf subscription `collection_method=send_invoice` it becomes `past_due` when its invoice is not paid by the due date, and `canceled` or `unpaid` if it is still not paid by an additional deadline after that. Note that when a subscription has a status of `unpaid`, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices." enum: - active - canceled - incomplete - incomplete_expired - past_due - paused - trialing - unpaid type: string test_clock: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/test_helpers.test_clock' description: ID of the test clock this subscription belongs to. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/test_helpers.test_clock' transfer_data: anyOf: - $ref: '#/components/schemas/subscription_transfer_data' description: The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices. nullable: true trial_end: description: If the subscription has a trial, the end of that trial. format: unix-time nullable: true type: integer trial_settings: anyOf: - $ref: '#/components/schemas/subscriptions_trials_resource_trial_settings' description: Settings related to subscription trials. nullable: true trial_start: description: If the subscription has a trial, the beginning of that trial. format: unix-time nullable: true type: integer required: - automatic_tax - billing_cycle_anchor - cancel_at_period_end - collection_method - created - currency - current_period_end - current_period_start - customer - id - items - livemode - metadata - object - start_date - status title: Subscription type: object x-expandableFields: - application - automatic_tax - billing_thresholds - cancellation_details - customer - default_payment_method - default_source - default_tax_rates - discount - items - latest_invoice - on_behalf_of - pause_collection - payment_settings - pending_invoice_item_interval - pending_setup_intent - pending_update - schedule - test_clock - transfer_data - trial_settings x-resourceId: subscription issuing.cardholder: description: 'An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards. Related guide: [How to create a cardholder](https://stripe.com/docs/issuing/cards#create-cardholder)' properties: billing: $ref: '#/components/schemas/issuing_cardholder_address' company: anyOf: - $ref: '#/components/schemas/issuing_cardholder_company' description: Additional information about a `company` cardholder. nullable: true created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer email: description: The cardholder's email address. maxLength: 5000 nullable: true type: string id: description: Unique identifier for the object. maxLength: 5000 type: string individual: anyOf: - $ref: '#/components/schemas/issuing_cardholder_individual' description: Additional information about an `individual` cardholder. nullable: true livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object name: description: The cardholder's name. This will be printed on cards issued to them. maxLength: 5000 type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - issuing.cardholder type: string phone_number: description: The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://stripe.com/docs/issuing/3d-secure#when-is-3d-secure-applied) for more details. maxLength: 5000 nullable: true type: string preferred_locales: description: "The cardholder’s preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`.\n This changes the language of the [3D Secure flow](https://stripe.com/docs/issuing/3d-secure) and one-time password messages sent to the cardholder." items: enum: - de - en - es - fr - it type: string nullable: true type: array requirements: $ref: '#/components/schemas/issuing_cardholder_requirements' spending_controls: anyOf: - $ref: '#/components/schemas/issuing_cardholder_authorization_controls' description: Rules that control spending across this cardholder's cards. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details. nullable: true status: description: Specifies whether to permit authorizations on this cardholder's cards. enum: - active - blocked - inactive type: string type: description: One of `individual` or `company`. See [Choose a cardholder type](https://stripe.com/docs/issuing/other/choose-cardholder) for more details. enum: - company - individual type: string x-stripeBypassValidation: true required: - billing - created - id - livemode - metadata - name - object - requirements - status - type title: IssuingCardholder type: object x-expandableFields: - billing - company - individual - requirements - spending_controls x-resourceId: issuing.cardholder IssuingDisputeList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/issuing.dispute' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/issuing/disputes type: string invoice: description: 'Invoices are statements of amounts owed by a customer, and are either generated one-off, or generated periodically from a subscription. They contain [invoice items](https://stripe.com/docs/api#Invoice Items), and proration adjustments that may be caused by subscription upgrades/downgrades (if necessary). If your invoice is configured to be billed through automatic charges, Stripe automatically finalizes your invoice and attempts payment. Note that finalizing the invoice, [when automatic](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection), does not happen immediately as the invoice is created. Stripe waits until one hour after the last webhook was successfully sent (or the last webhook timed out after failing). If you (and the platforms you may have connected to) have no webhooks configured, Stripe waits one hour after creation to finalize the invoice. If your invoice is configured to be billed by sending an email, then based on your [email settings](https://dashboard.stripe.com/account/billing/automatic), Stripe will email the invoice to your customer and await payment. These emails can contain a link to a hosted page to pay the invoice. Stripe applies any customer credit on the account before determining the amount due for the invoice (i.e., the amount that will be actually charged). If the amount due for the invoice is less than Stripe''s [minimum allowed charge per currency](/docs/currencies#minimum-and-maximum-charge-amounts), the invoice is automatically marked paid, and we add the amount due to the customer''s credit balance which is applied to the next invoice. More details on the customer''s credit balance are [here](https://stripe.com/docs/billing/customer/balance). Related guide: [Send invoices to customers](https://stripe.com/docs/billing/invoices/sending)' properties: account_country: description: The country of the business associated with this invoice, most often the business creating the invoice. maxLength: 5000 nullable: true type: string account_name: description: The public name of the business associated with this invoice, most often the business creating the invoice. maxLength: 5000 nullable: true type: string account_tax_ids: description: The account tax IDs associated with the invoice. Only editable when the invoice is a draft. items: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/tax_id' - $ref: '#/components/schemas/deleted_tax_id' x-expansionResources: oneOf: - $ref: '#/components/schemas/tax_id' - $ref: '#/components/schemas/deleted_tax_id' nullable: true type: array amount_due: description: Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the `amount_due` may be 0. If there is a positive `starting_balance` for the invoice (the customer owes money), the `amount_due` will also take that into account. The charge that gets generated for the invoice will be for the amount specified in `amount_due`. type: integer amount_paid: description: The amount, in cents (or local equivalent), that was paid. type: integer amount_remaining: description: The difference between amount_due and amount_paid, in cents (or local equivalent). type: integer amount_shipping: description: This is the sum of all the shipping amounts. type: integer application: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/application' - $ref: '#/components/schemas/deleted_application' description: ID of the Connect Application that created the invoice. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/application' - $ref: '#/components/schemas/deleted_application' application_fee_amount: description: The fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account when the invoice is paid. nullable: true type: integer attempt_count: description: Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. type: integer attempted: description: Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the `invoice.created` webhook, for example, so you might not want to display that invoice as unpaid to your users. type: boolean auto_advance: description: Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. type: boolean automatic_tax: $ref: '#/components/schemas/automatic_tax' billing_reason: description: 'Indicates the reason why the invoice was created. * `manual`: Unrelated to a subscription, for example, created via the invoice editor. * `subscription`: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds. * `subscription_create`: A new subscription was created. * `subscription_cycle`: A subscription advanced into a new period. * `subscription_threshold`: A subscription reached a billing threshold. * `subscription_update`: A subscription was updated. * `upcoming`: Reserved for simulated invoices, per the upcoming invoice endpoint.' enum: - automatic_pending_invoice_item_invoice - manual - quote_accept - subscription - subscription_create - subscription_cycle - subscription_threshold - subscription_update - upcoming nullable: true type: string charge: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/charge' description: ID of the latest charge generated for this invoice, if any. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/charge' collection_method: description: Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. enum: - charge_automatically - send_invoice type: string created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer currency: description: 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). type: string custom_fields: description: Custom fields displayed on the invoice. items: $ref: '#/components/schemas/invoice_setting_custom_field' nullable: true type: array customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' description: The ID of the customer who will be billed. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' - $ref: '#/components/schemas/deleted_customer' customer_address: anyOf: - $ref: '#/components/schemas/address' description: The customer's address. Until the invoice is finalized, this field will equal `customer.address`. Once the invoice is finalized, this field will no longer be updated. nullable: true customer_email: description: The customer's email. Until the invoice is finalized, this field will equal `customer.email`. Once the invoice is finalized, this field will no longer be updated. maxLength: 5000 nullable: true type: string customer_name: description: The customer's name. Until the invoice is finalized, this field will equal `customer.name`. Once the invoice is finalized, this field will no longer be updated. maxLength: 5000 nullable: true type: string customer_phone: description: The customer's phone number. Until the invoice is finalized, this field will equal `customer.phone`. Once the invoice is finalized, this field will no longer be updated. maxLength: 5000 nullable: true type: string customer_shipping: anyOf: - $ref: '#/components/schemas/shipping' description: The customer's shipping information. Until the invoice is finalized, this field will equal `customer.shipping`. Once the invoice is finalized, this field will no longer be updated. nullable: true customer_tax_exempt: description: The customer's tax exempt status. Until the invoice is finalized, this field will equal `customer.tax_exempt`. Once the invoice is finalized, this field will no longer be updated. enum: - exempt - none - reverse nullable: true type: string customer_tax_ids: description: The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as `customer.tax_ids`. Once the invoice is finalized, this field will no longer be updated. items: $ref: '#/components/schemas/invoices_resource_invoice_tax_id' nullable: true type: array default_payment_method: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/payment_method' description: ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/payment_method' default_source: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/source' description: ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/source' x-stripeBypassValidation: true default_tax_rates: description: The tax rates applied to this invoice, if any. items: $ref: '#/components/schemas/tax_rate' type: array description: description: An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard. maxLength: 5000 nullable: true type: string discount: anyOf: - $ref: '#/components/schemas/discount' description: Describes the current discount applied to this invoice, if there is one. Not populated if there are multiple discounts. nullable: true discounts: description: The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use `expand[]=discounts` to expand each discount. items: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/discount' - $ref: '#/components/schemas/deleted_discount' x-expansionResources: oneOf: - $ref: '#/components/schemas/discount' - $ref: '#/components/schemas/deleted_discount' nullable: true type: array due_date: description: The date on which payment for this invoice is due. This value will be `null` for invoices where `collection_method=charge_automatically`. format: unix-time nullable: true type: integer effective_at: description: The date when this invoice is in effect. Same as `finalized_at` unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. format: unix-time nullable: true type: integer ending_balance: description: Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null. nullable: true type: integer footer: description: Footer displayed on the invoice. maxLength: 5000 nullable: true type: string from_invoice: anyOf: - $ref: '#/components/schemas/invoices_from_invoice' description: Details of the invoice that was cloned. See the [revision documentation](https://stripe.com/docs/invoicing/invoice-revisions) for more details. nullable: true hosted_invoice_url: description: The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null. maxLength: 5000 nullable: true type: string id: description: Unique identifier for the object. This property is always present unless the invoice is an upcoming invoice. See [Retrieve an upcoming invoice](https://stripe.com/docs/api/invoices/upcoming) for more details. maxLength: 5000 type: string invoice_pdf: description: The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null. maxLength: 5000 nullable: true type: string last_finalization_error: anyOf: - $ref: '#/components/schemas/api_errors' description: The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized. nullable: true latest_revision: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/invoice' description: The ID of the most recent non-draft revision of this invoice nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/invoice' lines: description: 'The individual line items that make up the invoice. `lines` is sorted as follows: (1) pending invoice items (including prorations) in reverse chronological order, (2) subscription items in reverse chronological order, and (3) invoice items added after invoice creation in chronological order.' properties: data: description: Details about each object. items: $ref: '#/components/schemas/line_item' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string required: - data - has_more - object - url title: InvoiceLinesList type: object x-expandableFields: - data livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. nullable: true type: object next_payment_attempt: description: The time at which payment will next be attempted. This value will be `null` for invoices where `collection_method=send_invoice`. format: unix-time nullable: true type: integer number: description: A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified. maxLength: 5000 nullable: true type: string object: description: String representing the object's type. Objects of the same type share the same value. enum: - invoice type: string on_behalf_of: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/account' description: The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the [Invoices with Connect](https://stripe.com/docs/billing/invoices/connect) documentation for details. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/account' paid: description: Whether payment was successfully collected for this invoice. An invoice can be paid (most commonly) with a charge or with credit from the customer's account balance. type: boolean paid_out_of_band: description: Returns true if the invoice was manually marked paid, returns false if the invoice hasn't been paid yet or was paid on Stripe. type: boolean payment_intent: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/payment_intent' description: The PaymentIntent associated with this invoice. The PaymentIntent is generated when the invoice is finalized, and can then be used to pay the invoice. Note that voiding an invoice will cancel the PaymentIntent. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/payment_intent' payment_settings: $ref: '#/components/schemas/invoices_payment_settings' period_end: description: End of the usage period during which invoice items were added to this invoice. format: unix-time type: integer period_start: description: Start of the usage period during which invoice items were added to this invoice. format: unix-time type: integer post_payment_credit_notes_amount: description: Total amount of all post-payment credit notes issued for this invoice. type: integer pre_payment_credit_notes_amount: description: Total amount of all pre-payment credit notes issued for this invoice. type: integer quote: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/quote' description: The quote this invoice was generated from. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/quote' receipt_number: description: This is the transaction number that appears on email receipts sent for this invoice. maxLength: 5000 nullable: true type: string rendering: anyOf: - $ref: '#/components/schemas/invoices_invoice_rendering' description: The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page. nullable: true shipping_cost: anyOf: - $ref: '#/components/schemas/invoices_shipping_cost' description: The details of the cost of shipping, including the ShippingRate applied on the invoice. nullable: true shipping_details: anyOf: - $ref: '#/components/schemas/shipping' description: Shipping details for the invoice. The Invoice PDF will use the `shipping_details` value if it is set, otherwise the PDF will render the shipping address from the customer. nullable: true starting_balance: description: Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice. type: integer statement_descriptor: description: Extra information about an invoice for the customer's credit card statement. maxLength: 5000 nullable: true type: string status: description: The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://stripe.com/docs/billing/invoices/workflow#workflow-overview) enum: - draft - open - paid - uncollectible - void nullable: true type: string x-stripeBypassValidation: true status_transitions: $ref: '#/components/schemas/invoices_status_transitions' subscription: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/subscription' description: The subscription that this invoice was prepared for, if any. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/subscription' subscription_details: anyOf: - $ref: '#/components/schemas/subscription_details_data' description: Details about the subscription that created this invoice. nullable: true subscription_proration_date: description: Only set for upcoming invoices that preview prorations. The time used to calculate prorations. type: integer subtotal: description: Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated type: integer subtotal_excluding_tax: description: The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated nullable: true type: integer tax: description: The amount of tax on this invoice. This is the sum of all the tax amounts on this invoice. nullable: true type: integer test_clock: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/test_helpers.test_clock' description: ID of the test clock this invoice belongs to. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/test_helpers.test_clock' threshold_reason: $ref: '#/components/schemas/invoice_threshold_reason' total: description: Total after discounts and taxes. type: integer total_discount_amounts: description: The aggregate amounts calculated per discount across all line items. items: $ref: '#/components/schemas/discounts_resource_discount_amount' nullable: true type: array total_excluding_tax: description: The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax. nullable: true type: integer total_tax_amounts: description: The aggregate amounts calculated per tax rate for all line items. items: $ref: '#/components/schemas/invoice_tax_amount' type: array transfer_data: anyOf: - $ref: '#/components/schemas/invoice_transfer_data' description: The account (if any) the payment will be attributed to for tax reporting, and where funds from the payment will be transferred to for the invoice. nullable: true webhooks_delivered_at: description: Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have [been exhausted](https://stripe.com/docs/billing/webhooks#understand). This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created. format: unix-time nullable: true type: integer required: - amount_due - amount_paid - amount_remaining - amount_shipping - attempt_count - attempted - automatic_tax - collection_method - created - currency - default_tax_rates - lines - livemode - object - paid - paid_out_of_band - payment_settings - period_end - period_start - post_payment_credit_notes_amount - pre_payment_credit_notes_amount - starting_balance - status_transitions - subtotal - total - total_tax_amounts title: Invoice type: object x-expandableFields: - account_tax_ids - application - automatic_tax - charge - custom_fields - customer - customer_address - customer_shipping - customer_tax_ids - default_payment_method - default_source - default_tax_rates - discount - discounts - from_invoice - last_finalization_error - latest_revision - lines - on_behalf_of - payment_intent - payment_settings - quote - rendering - shipping_cost - shipping_details - status_transitions - subscription - subscription_details - test_clock - threshold_reason - total_discount_amounts - total_tax_amounts - transfer_data x-resourceId: invoice GetInvoicesInvoiceRequest: type: object properties: {} GetInvoice ItemsInvoiceitemRequest: type: object properties: {} GetLinkAccountSessionsSessionRequest: type: object properties: {} PaymentFlowsPaymentIntentList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/payment_intent' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/payment_intents type: string tax_id: description: 'You can add one or multiple tax IDs to a [customer](https://stripe.com/docs/api/customers) or account. Customer and account tax IDs get displayed on related invoices and credit notes. Related guides: [Customer tax identification numbers](https://stripe.com/docs/billing/taxes/tax-ids), [Account tax IDs](https://stripe.com/docs/invoicing/connect#account-tax-ids)' properties: country: description: Two-letter ISO code representing the country of the tax ID. maxLength: 5000 nullable: true type: string created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer customer: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/customer' description: ID of the customer. nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/customer' id: description: Unique identifier for the object. maxLength: 5000 type: string livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. enum: - tax_id type: string type: description: Type of the tax ID, one of `ad_nrt`, `ae_trn`, `ar_cuit`, `au_abn`, `au_arn`, `bg_uic`, `bo_tin`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `pe_ruc`, `ph_tin`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sv_nit`, `th_vat`, `tr_tin`, `tw_vat`, `ua_vat`, `us_ein`, `uy_ruc`, `ve_rif`, `vn_tin`, or `za_vat`. Note that some legacy tax IDs have type `unknown` enum: - ad_nrt - ae_trn - ar_cuit - au_abn - au_arn - bg_uic - bo_tin - br_cnpj - br_cpf - ca_bn - ca_gst_hst - ca_pst_bc - ca_pst_mb - ca_pst_sk - ca_qst - ch_vat - cl_tin - cn_tin - co_nit - cr_tin - do_rcn - ec_ruc - eg_tin - es_cif - eu_oss_vat - eu_vat - gb_vat - ge_vat - hk_br - hu_tin - id_npwp - il_vat - in_gst - is_vat - jp_cn - jp_rn - jp_trn - ke_pin - kr_brn - li_uid - mx_rfc - my_frp - my_itn - my_sst - no_vat - nz_gst - pe_ruc - ph_tin - ro_tin - rs_pib - ru_inn - ru_kpp - sa_vat - sg_gst - sg_uen - si_tin - sv_nit - th_vat - tr_tin - tw_vat - ua_vat - unknown - us_ein - uy_ruc - ve_rif - vn_tin - za_vat type: string value: description: Value of the tax ID. maxLength: 5000 type: string verification: anyOf: - $ref: '#/components/schemas/tax_id_verification' description: Tax ID verification information. nullable: true required: - created - id - livemode - object - type - value title: tax_id type: object x-expandableFields: - customer - verification x-resourceId: tax_id IssuingTransactionList: type: object required: - data - has_more - object - url properties: data: items: $ref: '#/components/schemas/issuing.transaction' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/issuing/transactions type: string ApmsSourcesSourceList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: anyOf: - $ref: '#/components/schemas/bank_account' - $ref: '#/components/schemas/card' - $ref: '#/components/schemas/source' title: Polymorphic x-stripeBypassValidation: true type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 type: string identity.verification_session: description: 'A VerificationSession guides you through the process of collecting and verifying the identities of your users. It contains details about the type of verification, such as what [verification check](/docs/identity/verification-checks) to perform. Only create one VerificationSession for each verification in your system. A VerificationSession transitions through [multiple statuses](/docs/identity/how-sessions-work) throughout its lifetime as it progresses through the verification flow. The VerificationSession contains the user''s verified data after verification checks are complete. Related guide: [The Verification Sessions API](https://stripe.com/docs/identity/verification-sessions)' properties: client_secret: description: The short-lived client secret used by Stripe.js to [show a verification modal](https://stripe.com/docs/js/identity/modal) inside your app. This client secret expires after 24 hours and can only be used once. Don’t store it, log it, embed it in a URL, or expose it to anyone other than the user. Make sure that you have TLS enabled on any page that includes the client secret. Refer to our docs on [passing the client secret to the frontend](https://stripe.com/docs/identity/verification-sessions#client-secret) to learn more. maxLength: 5000 nullable: true type: string created: description: Time at which the object was created. Measured in seconds since the Unix epoch. format: unix-time type: integer id: description: Unique identifier for the object. maxLength: 5000 type: string last_error: anyOf: - $ref: '#/components/schemas/gelato_session_last_error' description: If present, this property tells you the last error encountered when processing the verification. nullable: true last_verification_report: anyOf: - maxLength: 5000 type: string - $ref: '#/components/schemas/identity.verification_report' description: ID of the most recent VerificationReport. [Learn more about accessing detailed verification results.](https://stripe.com/docs/identity/verification-sessions#results) nullable: true x-expansionResources: oneOf: - $ref: '#/components/schemas/identity.verification_report' livemode: description: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. type: boolean metadata: additionalProperties: maxLength: 500 type: string description: Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. type: object object: description: String representing the object's type. Objects of the same type share the same value. enum: - identity.verification_session type: string options: anyOf: - $ref: '#/components/schemas/gelato_verification_session_options' description: A set of options for the session’s verification checks. nullable: true redaction: anyOf: - $ref: '#/components/schemas/verification_session_redaction' description: Redaction status of this VerificationSession. If the VerificationSession is not redacted, this field will be null. nullable: true status: description: Status of this VerificationSession. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work). enum: - canceled - processing - requires_input - verified type: string type: description: The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed. enum: - document - id_number nullable: true type: string x-stripeBypassValidation: true url: description: The short-lived URL that you use to redirect a user to Stripe to submit their identity information. This URL expires after 48 hours and can only be used once. Don’t store it, log it, send it in emails or expose it to anyone other than the user. Refer to our docs on [verifying identity documents](https://stripe.com/docs/identity/verify-identity-documents?platform=web&type=redirect) to learn how to redirect users to Stripe. maxLength: 5000 nullable: true type: string verified_outputs: anyOf: - $ref: '#/components/schemas/gelato_verified_outputs' description: The user’s verified data. nullable: true required: - created - id - livemode - metadata - object - status title: GelatoVerificationSession type: object x-expandableFields: - last_error - last_verification_report - options - redaction - verified_outputs x-resourceId: identity.verification_session GetCountrySpecsRequest: type: object properties: {} BankConnectionsResourceLinkedAccountList: type: object required: - data - has_more - object - url properties: data: description: Details about each object. items: $ref: '#/components/schemas/financial_connections.account' type: array has_more: description: True if this list has another page of items after this one that can be fetched. type: boolean object: description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`. enum: - list type: string url: description: The URL where this list can be accessed. maxLength: 5000 pattern: ^/v1/financial_connections/accounts type: string