payment_pages_checkout_session_optional_item_adjustable_quantity
{
"type": "object",
"title": "PaymentPagesCheckoutSessionOptionalItemAdjustableQuantity",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean",
"description": "Set to true if the quantity can be adjusted to any non-negative integer."
},
"maximum": {
"type": "integer",
"nullable": true,
"description": "The maximum quantity of this item the customer can purchase. By default this value is 99. You can specify a value up to 999999."
},
"minimum": {
"type": "integer",
"nullable": true,
"description": "The minimum quantity of this item the customer must purchase, if they choose to purchase it. Because this item is optional, the customer will always be able to remove it from their order, even if the `minimum` configured here is greater than 0. By default this value is 0."
}
},
"description": "",
"x-expandableFields": []
}
payment_pages_checkout_session_payment_method_reuse_agreement
{
"type": "object",
"title": "PaymentPagesCheckoutSessionPaymentMethodReuseAgreement",
"required": [
"position"
],
"properties": {
"position": {
"enum": [
"auto",
"hidden"
],
"type": "string",
"description": "Determines the position and visibility of the payment method reuse agreement in the UI. When set to `auto`, Stripe's defaults will be used.\n\nWhen set to `hidden`, the payment method reuse agreement text will always be hidden in the UI."
}
},
"description": "",
"x-expandableFields": []
}
payment_pages_checkout_session_permissions
{
"type": "object",
"title": "PaymentPagesCheckoutSessionPermissions",
"properties": {
"update_shipping_details": {
"enum": [
"client_only",
"server_only"
],
"type": "string",
"nullable": true,
"description": "Determines which entity is allowed to update the shipping details.\n\nDefault is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.\n\nWhen set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API."
}
},
"description": "",
"x-expandableFields": []
}
payment_pages_checkout_session_phone_number_collection
{
"type": "object",
"title": "PaymentPagesCheckoutSessionPhoneNumberCollection",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean",
"description": "Indicates whether phone number collection is enabled for the session"
}
},
"description": "",
"x-expandableFields": []
}
payment_pages_checkout_session_saved_payment_method_options
{
"type": "object",
"title": "PaymentPagesCheckoutSessionSavedPaymentMethodOptions",
"properties": {
"payment_method_save": {
"enum": [
"disabled",
"enabled"
],
"type": "string",
"nullable": true,
"description": "Enable customers to choose if they wish to save their payment method for future use. Disabled by default."
},
"payment_method_remove": {
"enum": [
"disabled",
"enabled"
],
"type": "string",
"nullable": true,
"description": "Enable customers to choose if they wish to remove their saved payment methods. Disabled by default."
},
"allow_redisplay_filters": {
"type": "array",
"items": {
"enum": [
"always",
"limited",
"unspecified"
],
"type": "string"
},
"nullable": true,
"description": "Uses the `allow_redisplay` value of each saved payment method to filter the set presented to a returning customer. By default, only saved payment methods with ’allow_redisplay: ‘always’ are shown in Checkout."
}
},
"description": "",
"x-expandableFields": []
}
payment_pages_checkout_session_shipping_address_collection
{
"type": "object",
"title": "PaymentPagesCheckoutSessionShippingAddressCollection",
"required": [
"allowed_countries"
],
"properties": {
"allowed_countries": {
"type": "array",
"items": {
"enum": [
"AC",
"AD",
"AE",
"AF",
"AG",
"AI",
"AL",
"AM",
"AO",
"AQ",
"AR",
"AT",
"AU",
"AW",
"AX",
"AZ",
"BA",
"BB",
"BD",
"BE",
"BF",
"BG",
"BH",
"BI",
"BJ",
"BL",
"BM",
"BN",
"BO",
"BQ",
"BR",
"BS",
"BT",
"BV",
"BW",
"BY",
"BZ",
"CA",
"CD",
"CF",
"CG",
"CH",
"CI",
"CK",
"CL",
"CM",
"CN",
"CO",
"CR",
"CV",
"CW",
"CY",
"CZ",
"DE",
"DJ",
"DK",
"DM",
"DO",
"DZ",
"EC",
"EE",
"EG",
"EH",
"ER",
"ES",
"ET",
"FI",
"FJ",
"FK",
"FO",
"FR",
"GA",
"GB",
"GD",
"GE",
"GF",
"GG",
"GH",
"GI",
"GL",
"GM",
"GN",
"GP",
"GQ",
"GR",
"GS",
"GT",
"GU",
"GW",
"GY",
"HK",
"HN",
"HR",
"HT",
"HU",
"ID",
"IE",
"IL",
"IM",
"IN",
"IO",
"IQ",
"IS",
"IT",
"JE",
"JM",
"JO",
"JP",
"KE",
"KG",
"KH",
"KI",
"KM",
"KN",
"KR",
"KW",
"KY",
"KZ",
"LA",
"LB",
"LC",
"LI",
"LK",
"LR",
"LS",
"LT",
"LU",
"LV",
"LY",
"MA",
"MC",
"MD",
"ME",
"MF",
"MG",
"MK",
"ML",
"MM",
"MN",
"MO",
"MQ",
"MR",
"MS",
"MT",
"MU",
"MV",
"MW",
"MX",
"MY",
"MZ",
"NA",
"NC",
"NE",
"NG",
"NI",
"NL",
"NO",
"NP",
"NR",
"NU",
"NZ",
"OM",
"PA",
"PE",
"PF",
"PG",
"PH",
"PK",
"PL",
"PM",
"PN",
"PR",
"PS",
"PT",
"PY",
"QA",
"RE",
"RO",
"RS",
"RU",
"RW",
"SA",
"SB",
"SC",
"SD",
"SE",
"SG",
"SH",
"SI",
"SJ",
"SK",
"SL",
"SM",
"SN",
"SO",
"SR",
"SS",
"ST",
"SV",
"SX",
"SZ",
"TA",
"TC",
"TD",
"TF",
"TG",
"TH",
"TJ",
"TK",
"TL",
"TM",
"TN",
"TO",
"TR",
"TT",
"TV",
"TW",
"TZ",
"UA",
"UG",
"US",
"UY",
"UZ",
"VA",
"VC",
"VE",
"VG",
"VN",
"VU",
"WF",
"WS",
"XK",
"YE",
"YT",
"ZA",
"ZM",
"ZW",
"ZZ"
],
"type": "string"
},
"description": "An array of two-letter ISO country codes representing which countries Checkout should provide as options for\nshipping locations. Unsupported country codes: `AS, CX, CC, CU, HM, IR, KP, MH, FM, NF, MP, PW, SY, UM, VI`."
}
},
"description": "",
"x-expandableFields": []
}
payment_pages_checkout_session_shipping_cost
{
"type": "object",
"title": "PaymentPagesCheckoutSessionShippingCost",
"required": [
"amount_subtotal",
"amount_tax",
"amount_total"
],
"properties": {
"taxes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/line_items_tax_amount"
},
"description": "The taxes applied to the shipping rate."
},
"amount_tax": {
"type": "integer",
"description": "Total tax amount applied due to shipping costs. If no tax was applied, defaults to 0."
},
"amount_total": {
"type": "integer",
"description": "Total shipping cost after discounts and taxes are applied."
},
"shipping_rate": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"$ref": "#/components/schemas/shipping_rate"
}
],
"nullable": true,
"description": "The ID of the ShippingRate for this order.",
"x-expansionResources": {
"oneOf": [
{
"$ref": "#/components/schemas/shipping_rate"
}
]
}
},
"amount_subtotal": {
"type": "integer",
"description": "Total shipping cost before any discounts or taxes are applied."
}
},
"description": "",
"x-expandableFields": [
"shipping_rate",
"taxes"
]
}
payment_pages_checkout_session_shipping_option
{
"type": "object",
"title": "PaymentPagesCheckoutSessionShippingOption",
"required": [
"shipping_amount",
"shipping_rate"
],
"properties": {
"shipping_rate": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"$ref": "#/components/schemas/shipping_rate"
}
],
"description": "The shipping rate.",
"x-expansionResources": {
"oneOf": [
{
"$ref": "#/components/schemas/shipping_rate"
}
]
}
},
"shipping_amount": {
"type": "integer",
"description": "A non-negative integer in cents representing how much to charge."
}
},
"description": "",
"x-expandableFields": [
"shipping_rate"
]
}
payment_pages_checkout_session_tax_id
{
"type": "object",
"title": "PaymentPagesCheckoutSessionTaxID",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"ad_nrt",
"ae_trn",
"al_tin",
"am_tin",
"ao_tin",
"ar_cuit",
"au_abn",
"au_arn",
"aw_tin",
"az_tin",
"ba_tin",
"bb_tin",
"bd_bin",
"bf_ifu",
"bg_uic",
"bh_vat",
"bj_ifu",
"bo_tin",
"br_cnpj",
"br_cpf",
"bs_tin",
"by_tin",
"ca_bn",
"ca_gst_hst",
"ca_pst_bc",
"ca_pst_mb",
"ca_pst_sk",
"ca_qst",
"cd_nif",
"ch_uid",
"ch_vat",
"cl_tin",
"cm_niu",
"cn_tin",
"co_nit",
"cr_tin",
"cv_nif",
"de_stn",
"do_rcn",
"ec_ruc",
"eg_tin",
"es_cif",
"et_tin",
"eu_oss_vat",
"eu_vat",
"fo_vat",
"gb_vat",
"ge_vat",
"gi_tin",
"gn_nif",
"hk_br",
"hr_oib",
"hu_tin",
"id_npwp",
"il_vat",
"in_gst",
"is_vat",
"it_cf",
"jp_cn",
"jp_rn",
"jp_trn",
"ke_pin",
"kg_tin",
"kh_tin",
"kr_brn",
"kz_bin",
"la_tin",
"li_uid",
"li_vat",
"lk_vat",
"ma_vat",
"md_vat",
"me_pib",
"mk_vat",
"mr_nif",
"mx_rfc",
"my_frp",
"my_itn",
"my_sst",
"ng_tin",
"no_vat",
"no_voec",
"np_pan",
"nz_gst",
"om_vat",
"pe_ruc",
"ph_tin",
"pl_nip",
"py_ruc",
"ro_tin",
"rs_pib",
"ru_inn",
"ru_kpp",
"sa_vat",
"sg_gst",
"sg_uen",
"si_tin",
"sn_ninea",
"sr_fin",
"sv_nit",
"th_vat",
"tj_tin",
"tr_tin",
"tw_vat",
"tz_vat",
"ua_vat",
"ug_tin",
"unknown",
"us_ein",
"uy_ruc",
"uz_tin",
"uz_vat",
"ve_rif",
"vn_tin",
"za_vat",
"zm_tin",
"zw_tin"
],
"type": "string",
"description": "The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`"
},
"value": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The value of the tax ID."
}
},
"description": "",
"x-expandableFields": []
}
payment_pages_checkout_session_tax_id_collection
{
"type": "object",
"title": "PaymentPagesCheckoutSessionTaxIDCollection",
"required": [
"enabled",
"required"
],
"properties": {
"enabled": {
"type": "boolean",
"description": "Indicates whether tax ID collection is enabled for the session"
},
"required": {
"enum": [
"if_supported",
"never"
],
"type": "string",
"description": "Indicates whether a tax ID is required on the payment page"
}
},
"description": "",
"x-expandableFields": []
}
payment_pages_checkout_session_total_details
{
"type": "object",
"title": "PaymentPagesCheckoutSessionTotalDetails",
"required": [
"amount_discount",
"amount_tax"
],
"properties": {
"breakdown": {
"$ref": "#/components/schemas/payment_pages_checkout_session_total_details_resource_breakdown"
},
"amount_tax": {
"type": "integer",
"description": "This is the sum of all the tax amounts."
},
"amount_discount": {
"type": "integer",
"description": "This is the sum of all the discounts."
},
"amount_shipping": {
"type": "integer",
"nullable": true,
"description": "This is the sum of all the shipping amounts."
}
},
"description": "",
"x-expandableFields": [
"breakdown"
]
}
payment_pages_checkout_session_total_details_resource_breakdown
{
"type": "object",
"title": "PaymentPagesCheckoutSessionTotalDetailsResourceBreakdown",
"required": [
"discounts",
"taxes"
],
"properties": {
"taxes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/line_items_tax_amount"
},
"description": "The aggregated tax amounts by rate."
},
"discounts": {
"type": "array",
"items": {
"$ref": "#/components/schemas/line_items_discount_amount"
},
"description": "The aggregated discounts."
}
},
"description": "",
"x-expandableFields": [
"discounts",
"taxes"
]
}
payment_pages_private_card_payment_method_options_resource_restrictions
{
"type": "object",
"title": "PaymentPagesPrivateCardPaymentMethodOptionsResourceRestrictions",
"properties": {
"brands_blocked": {
"type": "array",
"items": {
"enum": [
"american_express",
"discover_global_network",
"mastercard",
"visa"
],
"type": "string"
},
"description": "Specify the card brands to block in the Checkout Session. If a customer enters or selects a card belonging to a blocked brand, they can't complete the Session."
}
},
"description": "",
"x-expandableFields": []
}
payment_record
{
"type": "object",
"title": "PaymentRecord",
"required": [
"amount",
"amount_authorized",
"amount_canceled",
"amount_failed",
"amount_guaranteed",
"amount_refunded",
"amount_requested",
"created",
"id",
"livemode",
"metadata",
"object",
"processor_details",
"reported_by"
],
"properties": {
"id": {
"type": "string",
"maxLength": 5000,
"description": "Unique identifier for the object."
},
"amount": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_amount"
},
"object": {
"enum": [
"payment_record"
],
"type": "string",
"description": "String representing the object's type. Objects of the same type share the same value."
},
"created": {
"type": "integer",
"format": "unix-time",
"description": "Time at which the object was created. Measured in seconds since the Unix epoch."
},
"livemode": {
"type": "boolean",
"description": "If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`."
},
"metadata": {
"type": "object",
"description": "Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.",
"additionalProperties": {
"type": "string",
"maxLength": 500
}
},
"application": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "ID of the Connect application that created the PaymentRecord."
},
"description": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "An arbitrary string attached to the object. Often useful for displaying to users."
},
"reported_by": {
"enum": [
"self",
"stripe"
],
"type": "string",
"description": "Indicates who reported the payment."
},
"amount_failed": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_amount"
},
"amount_canceled": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_amount"
},
"amount_refunded": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_amount"
},
"amount_requested": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_amount"
},
"customer_details": {
"anyOf": [
{
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_customer_details"
}
],
"nullable": true,
"description": "Customer information for this payment."
},
"shipping_details": {
"anyOf": [
{
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_shipping_details"
}
],
"nullable": true,
"description": "Shipping information for this payment."
},
"amount_authorized": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_amount"
},
"amount_guaranteed": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_amount"
},
"customer_presence": {
"enum": [
"off_session",
"on_session"
],
"type": "string",
"nullable": true,
"description": "Indicates whether the customer was present in your checkout flow during this payment."
},
"processor_details": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_processor_details"
},
"payment_method_details": {
"anyOf": [
{
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_details"
}
],
"nullable": true,
"description": "Information about the Payment Method debited for this payment."
},
"latest_payment_attempt_record": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "ID of the latest Payment Attempt Record attached to this Payment Record."
}
},
"description": "A Payment Record is a resource that allows you to represent payments that occur on- or off-Stripe.\nFor example, you can create a Payment Record to model a payment made on a different payment processor,\nin order to mark an Invoice as paid and a Subscription as active. Payment Records consist of one or\nmore Payment Attempt Records, which represent individual attempts made on a payment network.",
"x-resourceId": "payment_record",
"x-expandableFields": [
"amount",
"amount_authorized",
"amount_canceled",
"amount_failed",
"amount_guaranteed",
"amount_refunded",
"amount_requested",
"customer_details",
"payment_method_details",
"processor_details",
"shipping_details"
]
}
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
}
payments_primitives_payment_records_resource_address
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourceAddress",
"properties": {
"city": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "City, district, suburb, town, or village."
},
"line1": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Address line 1, such as the street, PO Box, or company name."
},
"line2": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Address line 2, such as the apartment, suite, unit, or building."
},
"state": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2))."
},
"country": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2))."
},
"postal_code": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "ZIP or postal code."
}
},
"description": "A representation of a physical address.",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_amount
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourceAmount",
"required": [
"currency",
"value"
],
"properties": {
"value": {
"type": "integer",
"description": "A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY."
},
"currency": {
"type": "string",
"format": "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)."
}
},
"description": "A representation of an amount of money, consisting of an amount and a currency.",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_billing_details
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourceBillingDetails",
"required": [
"address"
],
"properties": {
"name": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The billing name associated with the method of payment."
},
"email": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The billing email associated with the method of payment."
},
"phone": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The billing phone number associated with the method of payment."
},
"address": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_address"
}
},
"description": "Billing details used by the customer for this payment.",
"x-expandableFields": [
"address"
]
}
payments_primitives_payment_records_resource_customer_details
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourceCustomerDetails",
"properties": {
"name": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The customer's name."
},
"email": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The customer's email address."
},
"phone": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The customer's phone number."
},
"customer": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "ID of the Stripe Customer associated with this payment."
}
},
"description": "Information about the customer for this payment.",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_alma_details_resource_installments
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodAlmaDetailsResourceInstallments",
"properties": {
"count": {
"type": "integer",
"nullable": true,
"description": "The number of installments."
}
},
"description": "",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_amazon_pay_details_resource_funding
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodAmazonPayDetailsResourceFunding",
"properties": {
"card": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_amazon_pay_details_resource_funding_resource_funding_card"
},
"type": {
"enum": [
"card"
],
"type": "string",
"nullable": true,
"description": "funding type of the underlying payment method."
}
},
"description": "",
"x-expandableFields": [
"card"
]
}
payments_primitives_payment_records_resource_payment_method_amazon_pay_details_resource_funding_resource_funding_card
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodAmazonPayDetailsResourceFundingResourceFundingCard",
"properties": {
"brand": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`."
},
"last4": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The last four digits of the card."
},
"country": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"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."
},
"funding": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Card funding type. Can be `credit`, `debit`, `prepaid`, or `unknown`."
},
"exp_year": {
"type": "integer",
"nullable": true,
"description": "Four-digit number representing the card's expiration year."
},
"exp_month": {
"type": "integer",
"nullable": true,
"description": "Two-digit number representing the card's expiration month."
}
},
"description": "",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_card_details
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCardDetails",
"properties": {
"iin": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Issuer identification number of the card."
},
"brand": {
"enum": [
"amex",
"cartes_bancaires",
"diners",
"discover",
"eftpos_au",
"interac",
"jcb",
"link",
"mastercard",
"unionpay",
"unknown",
"visa"
],
"type": "string",
"nullable": true,
"description": "Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`."
},
"last4": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The last four digits of the card."
},
"checks": {
"anyOf": [
{
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_card_details_resource_checks"
}
],
"nullable": true,
"description": "Check results by Card networks on Card address and CVC at time of payment."
},
"issuer": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The name of the card's issuing bank."
},
"wallet": {
"anyOf": [
{
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_card_details_resource_wallet"
}
],
"nullable": true,
"description": "If this Card is part of a card wallet, this contains the details of the card wallet."
},
"country": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"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."
},
"funding": {
"enum": [
"credit",
"debit",
"prepaid",
"unknown"
],
"type": "string",
"nullable": true,
"description": "Card funding type. Can be `credit`, `debit`, `prepaid`, or `unknown`."
},
"network": {
"enum": [
"amex",
"cartes_bancaires",
"diners",
"discover",
"eftpos_au",
"interac",
"jcb",
"link",
"mastercard",
"unionpay",
"unknown",
"visa"
],
"type": "string",
"nullable": true,
"description": "Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `interac`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`."
},
"exp_year": {
"type": "integer",
"nullable": true,
"description": "Four-digit number representing the card's expiration year."
},
"exp_month": {
"type": "integer",
"nullable": true,
"description": "Two-digit number representing the card's expiration month."
},
"description": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "A high-level description of the type of cards issued in this range."
},
"fingerprint": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"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.\n\n*As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card---one for India and one for the rest of the world.*"
},
"installments": {
"anyOf": [
{
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_card_details_resource_installments"
}
],
"nullable": true,
"description": "Installment details for this payment."
},
"network_token": {
"anyOf": [
{
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_card_details_resource_network_token"
}
],
"nullable": true,
"description": "If this card has network token credentials, this contains the details of the network token credentials."
},
"capture_before": {
"type": "integer",
"format": "unix-time",
"description": "When using manual capture, a future timestamp at which the charge will be automatically refunded if uncaptured."
},
"three_d_secure": {
"anyOf": [
{
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_card_details_resource_three_d_secure"
}
],
"nullable": true,
"description": "Populated if this transaction used 3D Secure authentication."
},
"authorization_code": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The authorization code of the payment."
},
"network_advice_code": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Advice code from the card network for the failed payment."
},
"network_decline_code": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Decline code from the card network for the failed payment."
},
"network_transaction_id": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. This value will be present if it is returned by the financial network in the authorization response, and null otherwise."
},
"stored_credential_usage": {
"enum": [
"recurring",
"unscheduled"
],
"type": "string",
"nullable": true,
"description": "The transaction type that was passed for an off-session, Merchant-Initiated transaction, one of `recurring` or `unscheduled`."
}
},
"description": "Details of the card used for this payment attempt.",
"x-expandableFields": [
"checks",
"installments",
"network_token",
"three_d_secure",
"wallet"
]
}
payments_primitives_payment_records_resource_payment_method_card_details_resource_checks
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCardDetailsResourceChecks",
"properties": {
"cvc_check": {
"enum": [
"fail",
"pass",
"unavailable",
"unchecked"
],
"type": "string",
"nullable": true,
"description": "If you provide a CVC, the check results is one of `pass`, `fail`, `unavailable`, or `unchecked`."
},
"address_line1_check": {
"enum": [
"fail",
"pass",
"unavailable",
"unchecked"
],
"type": "string",
"nullable": true,
"description": "If you provide a value for `address.line1`, the check result is one of `pass`, `fail`, `unavailable`, or `unchecked`."
},
"address_postal_code_check": {
"enum": [
"fail",
"pass",
"unavailable",
"unchecked"
],
"type": "string",
"nullable": true,
"description": "If you provide a address postal code, the check result is one of `pass`, `fail`, `unavailable`, or `unchecked`."
}
},
"description": "",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_card_details_resource_installment_plan
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCardDetailsResourceInstallmentPlan",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"bonus",
"fixed_count",
"revolving"
],
"type": "string",
"description": "Type of installment plan, one of `fixed_count`, `revolving`, or `bonus`."
},
"count": {
"type": "integer",
"nullable": true,
"description": "For `fixed_count` installment plans, this is the number of installment payments your customer will make to their credit card."
},
"interval": {
"enum": [
"month"
],
"type": "string",
"nullable": true,
"description": "For `fixed_count` installment plans, this is the interval between installment payments your customer will make to their credit card. One of `month`."
}
},
"description": "",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_card_details_resource_installments
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCardDetailsResourceInstallments",
"properties": {
"plan": {
"anyOf": [
{
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_card_details_resource_installment_plan"
}
],
"nullable": true,
"description": "Installment plan selected for the payment."
}
},
"description": "",
"x-expandableFields": [
"plan"
]
}
payments_primitives_payment_records_resource_payment_method_card_details_resource_network_token
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCardDetailsResourceNetworkToken",
"required": [
"used"
],
"properties": {
"used": {
"type": "boolean",
"description": "Indicates if Stripe used a network token, either user provided or Stripe managed when processing the transaction."
}
},
"description": "",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_card_details_resource_three_d_secure
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCardDetailsResourceThreeDSecure",
"properties": {
"result": {
"enum": [
"attempt_acknowledged",
"authenticated",
"exempted",
"failed",
"not_supported",
"processing_error"
],
"type": "string",
"nullable": true,
"description": "Indicates the outcome of 3D Secure authentication."
},
"version": {
"enum": [
"1.0.2",
"2.1.0",
"2.2.0"
],
"type": "string",
"nullable": true,
"description": "The version of 3D Secure that was used."
},
"cryptogram": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The 3D Secure cryptogram, also known as the \"authentication value\" (AAV, CAVV or AEVV)."
},
"result_reason": {
"enum": [
"abandoned",
"bypassed",
"canceled",
"card_not_enrolled",
"network_not_supported",
"protocol_error",
"rejected"
],
"type": "string",
"nullable": true,
"description": "Additional information about why 3D Secure succeeded or failed, based on the `result`."
},
"authentication_flow": {
"enum": [
"challenge",
"frictionless"
],
"type": "string",
"nullable": true,
"description": "For authenticated transactions: Indicates how the issuing bank authenticated the customer."
},
"exemption_indicator": {
"enum": [
"low_risk",
"none"
],
"type": "string",
"nullable": true,
"description": "The exemption requested via 3DS and accepted by the issuer at authentication time."
},
"exemption_indicator_applied": {
"type": "boolean",
"nullable": true,
"description": "Whether Stripe requested the value of `exemption_indicator` in the transaction. This will depend on the outcome of Stripe's internal risk assessment."
},
"electronic_commerce_indicator": {
"enum": [
"01",
"02",
"03",
"04",
"05",
"06",
"07"
],
"type": "string",
"nullable": true,
"description": "The Electronic Commerce Indicator (ECI). A protocol-level field indicating what degree of authentication was performed."
}
},
"description": "",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_card_details_resource_wallet
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCardDetailsResourceWallet",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"maxLength": 5000,
"description": "The type of the card wallet, one of `apple_pay` or `google_pay`. An additional hash is included on the Wallet subhash with a name matching this value. It contains additional information specific to the card wallet type."
},
"apple_pay": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_card_details_resource_wallet_resource_apple_pay"
},
"google_pay": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_card_details_resource_wallet_resource_google_pay"
},
"dynamic_last4": {
"type": "string",
"maxLength": 5000,
"description": "(For tokenized numbers only.) The last four digits of the device account number."
}
},
"description": "",
"x-expandableFields": [
"apple_pay",
"google_pay"
]
}
payments_primitives_payment_records_resource_payment_method_card_details_resource_wallet_resource_apple_pay
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCardDetailsResourceWalletResourceApplePay",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"maxLength": 5000,
"description": "Type of the apple_pay transaction, one of `apple_pay` or `apple_pay_later`."
}
},
"description": "",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_card_details_resource_wallet_resource_google_pay
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCardDetailsResourceWalletResourceGooglePay",
"properties": {},
"description": "",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_custom_details
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetails",
"required": [
"display_name"
],
"properties": {
"type": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The custom payment method type associated with this payment."
},
"display_name": {
"type": "string",
"maxLength": 5000,
"description": "Display name for the custom (user-defined) payment method type used to make this payment."
}
},
"description": "Custom Payment Methods represent Payment Method types not modeled directly in\nthe Stripe API. This resource consists of details about the custom payment method\nused for this payment attempt.",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_details
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodDetails",
"required": [
"type"
],
"properties": {
"eps": {
"$ref": "#/components/schemas/payment_method_details_payment_record_eps"
},
"fpx": {
"$ref": "#/components/schemas/payment_method_details_fpx"
},
"p24": {
"$ref": "#/components/schemas/payment_method_details_p24"
},
"pix": {
"$ref": "#/components/schemas/payment_method_details_payment_record_pix"
},
"upi": {
"$ref": "#/components/schemas/payment_method_details_payment_record_upi"
},
"zip": {
"$ref": "#/components/schemas/payment_method_details_payment_record_zip"
},
"alma": {
"$ref": "#/components/schemas/payment_method_details_payment_record_alma"
},
"blik": {
"$ref": "#/components/schemas/payment_method_details_payment_record_blik"
},
"card": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_card_details"
},
"link": {
"$ref": "#/components/schemas/payment_method_details_link"
},
"oxxo": {
"$ref": "#/components/schemas/payment_method_details_payment_record_oxxo"
},
"type": {
"type": "string",
"maxLength": 5000,
"description": "The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://docs.stripe.com/api/payment_methods/object#payment_method_object-type) for the full list of possible types.\nAn additional hash is included on `payment_method_details` with a name matching this value.\nIt contains information specific to the payment method."
},
"ideal": {
"$ref": "#/components/schemas/payment_method_details_payment_record_ideal"
},
"payco": {
"$ref": "#/components/schemas/payment_method_details_payment_record_payco"
},
"payto": {
"$ref": "#/components/schemas/payment_method_details_payto"
},
"swish": {
"$ref": "#/components/schemas/payment_method_details_payment_record_swish"
},
"twint": {
"$ref": "#/components/schemas/payment_method_details_payment_record_twint"
},
"affirm": {
"$ref": "#/components/schemas/payment_method_details_payment_record_affirm"
},
"alipay": {
"$ref": "#/components/schemas/payment_flows_private_payment_methods_alipay_details"
},
"billie": {
"$ref": "#/components/schemas/payment_method_details_payment_record_billie"
},
"boleto": {
"$ref": "#/components/schemas/payment_method_details_payment_record_boleto"
},
"crypto": {
"$ref": "#/components/schemas/payment_method_details_crypto"
},
"custom": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_payment_method_custom_details"
},
"klarna": {
"$ref": "#/components/schemas/payment_method_details_klarna"
},
"mb_way": {
"$ref": "#/components/schemas/payment_method_details_payment_record_mb_way"
},
"paynow": {
"$ref": "#/components/schemas/payment_method_details_payment_record_paynow"
},
"paypal": {
"$ref": "#/components/schemas/payment_method_details_paypal"
},
"sofort": {
"$ref": "#/components/schemas/payment_method_details_payment_record_sofort"
},
"sunbit": {
"$ref": "#/components/schemas/payment_method_details_sunbit"
},
"wechat": {
"$ref": "#/components/schemas/payment_method_details_wechat"
},
"cashapp": {
"$ref": "#/components/schemas/payment_method_details_payment_record_cashapp"
},
"giropay": {
"$ref": "#/components/schemas/payment_method_details_payment_record_giropay"
},
"grabpay": {
"$ref": "#/components/schemas/payment_method_details_grabpay"
},
"konbini": {
"$ref": "#/components/schemas/payment_method_details_payment_record_konbini"
},
"kr_card": {
"$ref": "#/components/schemas/payment_method_details_kr_card"
},
"satispay": {
"$ref": "#/components/schemas/payment_method_details_satispay"
},
"ach_debit": {
"$ref": "#/components/schemas/payment_method_details_ach_debit"
},
"kakao_pay": {
"$ref": "#/components/schemas/payment_method_details_payment_record_kakao_pay"
},
"mobilepay": {
"$ref": "#/components/schemas/payment_method_details_payment_record_mobilepay"
},
"naver_pay": {
"$ref": "#/components/schemas/payment_method_details_payment_record_naver_pay"
},
"promptpay": {
"$ref": "#/components/schemas/payment_method_details_payment_record_promptpay"
},
"acss_debit": {
"$ref": "#/components/schemas/payment_method_details_payment_record_acss_debit"
},
"amazon_pay": {
"$ref": "#/components/schemas/payment_method_details_payment_record_amazon_pay"
},
"bacs_debit": {
"$ref": "#/components/schemas/payment_method_details_bacs_debit"
},
"bancontact": {
"$ref": "#/components/schemas/payment_method_details_payment_record_bancontact"
},
"multibanco": {
"$ref": "#/components/schemas/payment_method_details_payment_record_multibanco"
},
"sepa_debit": {
"$ref": "#/components/schemas/payment_method_details_payment_record_sepa_debit"
},
"wechat_pay": {
"$ref": "#/components/schemas/payment_method_details_payment_record_wechat_pay"
},
"pay_by_bank": {
"$ref": "#/components/schemas/payment_method_details_payment_record_pay_by_bank"
},
"revolut_pay": {
"$ref": "#/components/schemas/payment_method_details_revolut_pay"
},
"samsung_pay": {
"$ref": "#/components/schemas/payment_method_details_payment_record_samsung_pay"
},
"card_present": {
"$ref": "#/components/schemas/payment_method_details_card_present"
},
"au_becs_debit": {
"$ref": "#/components/schemas/payment_method_details_au_becs_debit"
},
"payment_method": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "ID of the Stripe PaymentMethod used to make this payment."
},
"stripe_account": {
"$ref": "#/components/schemas/payment_method_details_stripe_account"
},
"billing_details": {
"anyOf": [
{
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_billing_details"
}
],
"nullable": true,
"description": "The billing details associated with the method of payment."
},
"interac_present": {
"$ref": "#/components/schemas/payment_method_details_interac_present"
},
"nz_bank_account": {
"$ref": "#/components/schemas/payment_method_details_nz_bank_account"
},
"us_bank_account": {
"$ref": "#/components/schemas/payment_method_details_payment_record_us_bank_account"
},
"customer_balance": {
"$ref": "#/components/schemas/payment_method_details_customer_balance"
},
"afterpay_clearpay": {
"$ref": "#/components/schemas/payment_method_details_payment_record_afterpay_clearpay"
},
"ach_credit_transfer": {
"$ref": "#/components/schemas/payment_method_details_ach_credit_transfer"
}
},
"description": "Details about the Payment Method used in this payment attempt.",
"x-expandableFields": [
"ach_credit_transfer",
"ach_debit",
"acss_debit",
"affirm",
"afterpay_clearpay",
"alipay",
"alma",
"amazon_pay",
"au_becs_debit",
"bacs_debit",
"bancontact",
"billie",
"billing_details",
"blik",
"boleto",
"card",
"card_present",
"cashapp",
"crypto",
"custom",
"customer_balance",
"eps",
"fpx",
"giropay",
"grabpay",
"ideal",
"interac_present",
"kakao_pay",
"klarna",
"konbini",
"kr_card",
"link",
"mb_way",
"mobilepay",
"multibanco",
"naver_pay",
"nz_bank_account",
"oxxo",
"p24",
"pay_by_bank",
"payco",
"paynow",
"paypal",
"payto",
"pix",
"promptpay",
"revolut_pay",
"samsung_pay",
"satispay",
"sepa_debit",
"sofort",
"stripe_account",
"sunbit",
"swish",
"twint",
"upi",
"us_bank_account",
"wechat",
"wechat_pay",
"zip"
]
}
payments_primitives_payment_records_resource_payment_method_konbini_details_resource_store
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodKonbiniDetailsResourceStore",
"properties": {
"chain": {
"enum": [
"familymart",
"lawson",
"ministop",
"seicomart"
],
"type": "string",
"nullable": true,
"description": "The name of the convenience store chain where the payment was completed.",
"x-stripeBypassValidation": true
}
},
"description": "",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_payment_method_mobilepay_details_resource_card
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourcePaymentMethodMobilepayDetailsResourceCard",
"properties": {
"brand": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Brand of the card used in the transaction"
},
"last4": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The last 4 digits of the card"
},
"country": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Two-letter ISO code representing the country of the card"
},
"exp_year": {
"type": "integer",
"nullable": true,
"description": "Two digit number representing the card's expiration year"
},
"exp_month": {
"type": "integer",
"nullable": true,
"description": "Two digit number representing the card's expiration month"
}
},
"description": "",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_processor_details
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourceProcessorDetails",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"custom"
],
"type": "string",
"description": "The processor used for this payment attempt.",
"x-stripeBypassValidation": true
},
"custom": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_processor_details_resource_custom_details"
}
},
"description": "Processor information associated with this payment.",
"x-expandableFields": [
"custom"
]
}
payments_primitives_payment_records_resource_processor_details_resource_custom_details
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourceProcessorDetailsResourceCustomDetails",
"properties": {
"payment_reference": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID."
}
},
"description": "Custom processors represent payment processors not modeled directly in\nthe Stripe API. This resource consists of details about the custom processor\nused for this payment attempt.",
"x-expandableFields": []
}
payments_primitives_payment_records_resource_shipping_details
{
"type": "object",
"title": "PaymentsPrimitivesPaymentRecordsResourceShippingDetails",
"required": [
"address"
],
"properties": {
"name": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The shipping recipient's name."
},
"phone": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The shipping recipient's phone number."
},
"address": {
"$ref": "#/components/schemas/payments_primitives_payment_records_resource_address"
}
},
"description": "The customer's shipping information associated with this payment.",
"x-expandableFields": [
"address"
]
}
payout
{
"type": "object",
"title": "Payout",
"required": [
"amount",
"arrival_date",
"automatic",
"created",
"currency",
"id",
"livemode",
"method",
"object",
"reconciliation_status",
"source_type",
"status",
"type"
],
"properties": {
"id": {
"type": "string",
"maxLength": 5000,
"description": "Unique identifier for the object."
},
"type": {
"enum": [
"bank_account",
"card"
],
"type": "string",
"description": "Can be `bank_account` or `card`.",
"x-stripeBypassValidation": true
},
"amount": {
"type": "integer",
"description": "The amount (in cents (or local equivalent)) that transfers to your bank account or debit card."
},
"method": {
"type": "string",
"maxLength": 5000,
"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)."
},
"object": {
"enum": [
"payout"
],
"type": "string",
"description": "String representing the object's type. Objects of the same type share the same value."
},
"status": {
"type": "string",
"maxLength": 5000,
"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`."
},
"created": {
"type": "integer",
"format": "unix-time",
"description": "Time at which the object was created. Measured in seconds since the Unix epoch."
},
"currency": {
"type": "string",
"format": "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)."
},
"livemode": {
"type": "boolean",
"description": "If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`."
},
"metadata": {
"type": "object",
"nullable": true,
"description": "Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.",
"additionalProperties": {
"type": "string",
"maxLength": 500
}
},
"trace_id": {
"anyOf": [
{
"$ref": "#/components/schemas/payouts_trace_id"
}
],
"nullable": true,
"description": "A value that generates from the beneficiary's bank that allows users to track payouts with their bank. Banks might call this a \"reference number\" or something similar."
},
"automatic": {
"type": "boolean",
"description": "Returns `true` if the payout is created by an [automated payout schedule](https://docs.stripe.com/payouts#payout-schedule) and `false` if it's [requested manually](https://stripe.com/docs/payouts#manual-payouts)."
},
"description": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "An arbitrary string attached to the object. Often useful for displaying to users."
},
"destination": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"$ref": "#/components/schemas/bank_account"
},
{
"$ref": "#/components/schemas/card"
},
{
"$ref": "#/components/schemas/deleted_bank_account"
},
{
"$ref": "#/components/schemas/deleted_card"
}
],
"nullable": true,
"description": "ID of the bank account or card the payout is sent to.",
"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
},
"reversed_by": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"$ref": "#/components/schemas/payout"
}
],
"nullable": true,
"description": "If the payout reverses, this is the ID of the payout that reverses this payout.",
"x-expansionResources": {
"oneOf": [
{
"$ref": "#/components/schemas/payout"
}
]
}
},
"source_type": {
"type": "string",
"maxLength": 5000,
"description": "The source balance this payout came from, which can be one of the following: `card`, `fpx`, or `bank_account`."
},
"arrival_date": {
"type": "integer",
"format": "unix-time",
"description": "Date that you can expect the payout to arrive in the bank. This factors in delays to account for weekends or bank holidays."
},
"failure_code": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Error code that provides a reason for a payout failure, if available. View our [list of failure codes](https://docs.stripe.com/api#payout_failures)."
},
"payout_method": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "ID of the v2 FinancialAccount the funds are sent to."
},
"application_fee": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"$ref": "#/components/schemas/application_fee"
}
],
"nullable": true,
"description": "The application fee (if any) for the payout. [See the Connect documentation](https://docs.stripe.com/connect/instant-payouts#monetization-and-fees) for details.",
"x-expansionResources": {
"oneOf": [
{
"$ref": "#/components/schemas/application_fee"
}
]
}
},
"failure_message": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Message that provides the reason for a payout failure, if available."
},
"original_payout": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"$ref": "#/components/schemas/payout"
}
],
"nullable": true,
"description": "If the payout reverses another, this is the ID of the original payout.",
"x-expansionResources": {
"oneOf": [
{
"$ref": "#/components/schemas/payout"
}
]
}
},
"balance_transaction": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"$ref": "#/components/schemas/balance_transaction"
}
],
"nullable": true,
"description": "ID of the balance transaction that describes the impact of this payout on your account balance.",
"x-expansionResources": {
"oneOf": [
{
"$ref": "#/components/schemas/balance_transaction"
}
]
}
},
"statement_descriptor": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Extra information about a payout that displays on the user's bank statement."
},
"reconciliation_status": {
"enum": [
"completed",
"in_progress",
"not_applicable"
],
"type": "string",
"description": "If `completed`, you can use the [Balance Transactions API](https://docs.stripe.com/api/balance_transactions/list#balance_transaction_list-payout) to list all balance transactions that are paid out in this payout."
},
"application_fee_amount": {
"type": "integer",
"nullable": true,
"description": "The amount of the application fee (if any) requested for the payout. [See the Connect documentation](https://docs.stripe.com/connect/instant-payouts#monetization-and-fees) for details."
},
"failure_balance_transaction": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"$ref": "#/components/schemas/balance_transaction"
}
],
"nullable": true,
"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.",
"x-expansionResources": {
"oneOf": [
{
"$ref": "#/components/schemas/balance_transaction"
}
]
}
}
},
"description": "A `Payout` object is created when you receive funds from Stripe, or when you\ninitiate a payout to either a bank account or debit card of a [connected\nStripe account](/docs/connect/bank-debit-card-payouts). You can retrieve individual payouts,\nand list all payouts. Payouts are made on [varying\nschedules](/docs/connect/manage-payout-schedule), depending on your country and\nindustry.\n\nRelated guide: [Receiving payouts](https://docs.stripe.com/payouts)",
"x-resourceId": "payout",
"x-expandableFields": [
"application_fee",
"balance_transaction",
"destination",
"failure_balance_transaction",
"original_payout",
"reversed_by",
"trace_id"
]
}
payouts_trace_id
{
"type": "object",
"title": "PayoutsTraceID",
"required": [
"status"
],
"properties": {
"value": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The trace ID value if `trace_id.status` is `supported`, otherwise `nil`."
},
"status": {
"type": "string",
"maxLength": 5000,
"description": "Possible values are `pending`, `supported`, and `unsupported`. When `payout.status` is `pending` or `in_transit`, this will be `pending`. When the payout transitions to `paid`, `failed`, or `canceled`, this status will become `supported` or `unsupported` shortly after in most cases. In some cases, this may appear as `pending` for up to 10 days after `arrival_date` until transitioning to `supported` or `unsupported`."
}
},
"description": "",
"x-expandableFields": []
}
paypal_seller_protection
{
"type": "object",
"title": "paypal_seller_protection",
"required": [
"status"
],
"properties": {
"status": {
"enum": [
"eligible",
"not_eligible",
"partially_eligible"
],
"type": "string",
"description": "Indicates whether the transaction is eligible for PayPal's seller protection."
},
"dispute_categories": {
"type": "array",
"items": {
"enum": [
"fraudulent",
"product_not_received"
],
"type": "string",
"x-stripeBypassValidation": true
},
"nullable": true,
"description": "An array of conditions that are covered for the transaction, if applicable."
}
},
"description": "",
"x-expandableFields": []
}
person
{
"type": "object",
"title": "Person",
"required": [
"account",
"created",
"id",
"object"
],
"properties": {
"id": {
"type": "string",
"maxLength": 5000,
"description": "Unique identifier for the object."
},
"dob": {
"$ref": "#/components/schemas/legal_entity_dob"
},
"email": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The person's email address. Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`."
},
"phone": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The person's phone number."
},
"gender": {
"type": "string",
"nullable": true,
"description": "The person's gender."
},
"object": {
"enum": [
"person"
],
"type": "string",
"description": "String representing the object's type. Objects of the same type share the same value."
},
"account": {
"type": "string",
"maxLength": 5000,
"description": "The account the person is associated with."
},
"address": {
"$ref": "#/components/schemas/address"
},
"created": {
"type": "integer",
"format": "unix-time",
"description": "Time at which the object was created. Measured in seconds since the Unix epoch."
},
"metadata": {
"type": "object",
"description": "Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.",
"additionalProperties": {
"type": "string",
"maxLength": 500
}
},
"last_name": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The person's last name. Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`."
},
"first_name": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The person's first name. Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`."
},
"maiden_name": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The person's maiden name."
},
"nationality": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The country where the person is a national."
},
"address_kana": {
"anyOf": [
{
"$ref": "#/components/schemas/legal_entity_japan_address"
}
],
"nullable": true
},
"relationship": {
"$ref": "#/components/schemas/person_relationship"
},
"requirements": {
"anyOf": [
{
"$ref": "#/components/schemas/person_requirements"
}
],
"nullable": true
},
"us_cfpb_data": {
"anyOf": [
{
"$ref": "#/components/schemas/person_us_cfpb_data"
}
],
"nullable": true,
"description": "Demographic data related to the person."
},
"verification": {
"$ref": "#/components/schemas/legal_entity_person_verification"
},
"address_kanji": {
"anyOf": [
{
"$ref": "#/components/schemas/legal_entity_japan_address"
}
],
"nullable": true
},
"last_name_kana": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The Kana variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`."
},
"first_name_kana": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The Kana variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`."
},
"last_name_kanji": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The Kanji variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`."
},
"first_name_kanji": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The Kanji variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`."
},
"full_name_aliases": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000
},
"description": "A list of alternate names or aliases that the person is known by. Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`."
},
"id_number_provided": {
"type": "boolean",
"description": "Whether the person's `id_number` was provided. True if either the full ID number was provided or if only the required part of the ID number was provided (ex. last four of an individual's SSN for the US indicated by `ssn_last_4_provided`)."
},
"political_exposure": {
"enum": [
"existing",
"none"
],
"type": "string",
"description": "Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction."
},
"registered_address": {
"$ref": "#/components/schemas/address"
},
"future_requirements": {
"anyOf": [
{
"$ref": "#/components/schemas/person_future_requirements"
}
],
"nullable": true
},
"ssn_last_4_provided": {
"type": "boolean",
"description": "Whether the last four digits of the person's Social Security number have been provided (U.S. only)."
},
"additional_tos_acceptances": {
"$ref": "#/components/schemas/person_additional_tos_acceptances"
},
"id_number_secondary_provided": {
"type": "boolean",
"description": "Whether the person's `id_number_secondary` was provided."
}
},
"description": "This is an object representing a person associated with a Stripe account.\n\nA platform can only access a subset of data in a person for an account where [account.controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.\n\nSee the [Standard onboarding](/connect/standard-accounts) or [Express onboarding](/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](/connect/handling-api-verification#person-information).",
"x-resourceId": "person",
"x-expandableFields": [
"additional_tos_acceptances",
"address",
"address_kana",
"address_kanji",
"dob",
"future_requirements",
"registered_address",
"relationship",
"requirements",
"us_cfpb_data",
"verification"
]
}
person_additional_tos_acceptance
{
"type": "object",
"title": "PersonAdditionalTOSAcceptance",
"properties": {
"ip": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The IP address from which the legal guardian accepted the service agreement."
},
"date": {
"type": "integer",
"format": "unix-time",
"nullable": true,
"description": "The Unix timestamp marking when the legal guardian accepted the service agreement."
},
"user_agent": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The user agent of the browser from which the legal guardian accepted the service agreement."
}
},
"description": "",
"x-expandableFields": []
}
person_additional_tos_acceptances
{
"type": "object",
"title": "PersonAdditionalTOSAcceptances",
"properties": {
"account": {
"anyOf": [
{
"$ref": "#/components/schemas/person_additional_tos_acceptance"
}
],
"nullable": true,
"description": "Details on the legal guardian's acceptance of the main Stripe service agreement."
}
},
"description": "",
"x-expandableFields": [
"account"
]
}
person_ethnicity_details
{
"type": "object",
"title": "PersonEthnicityDetails",
"properties": {
"ethnicity": {
"type": "array",
"items": {
"enum": [
"cuban",
"hispanic_or_latino",
"mexican",
"not_hispanic_or_latino",
"other_hispanic_or_latino",
"prefer_not_to_answer",
"puerto_rican"
],
"type": "string"
},
"nullable": true,
"description": "The persons ethnicity"
},
"ethnicity_other": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Please specify your origin, when other is selected."
}
},
"description": "",
"x-expandableFields": []
}
person_future_requirements
{
"type": "object",
"title": "PersonFutureRequirements",
"required": [
"currently_due",
"errors",
"eventually_due",
"past_due",
"pending_verification"
],
"properties": {
"errors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/account_requirements_error"
},
"description": "Details about validation and verification failures for `due` requirements that must be resolved."
},
"past_due": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000
},
"description": "Fields that haven't been resolved by the account's `requirements.current_deadline`. These fields need to be resolved to enable the person's account. `future_requirements.past_due` is a subset of `requirements.past_due`."
},
"alternatives": {
"type": "array",
"items": {
"$ref": "#/components/schemas/account_requirements_alternative"
},
"nullable": true,
"description": "Fields that are due and can be resolved by providing the corresponding alternative fields instead. Many alternatives can list the same `original_fields_due`, and any of these alternatives can serve as a pathway for attempting to resolve the fields again. Re-providing `original_fields_due` also serves as a pathway for attempting to resolve the fields again."
},
"currently_due": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000
},
"description": "Fields that need to be resolved to keep the person's account enabled. If not resolved by the account's `future_requirements[current_deadline]`, these fields will transition to the main `requirements` hash, and may immediately become `past_due`, but the account may also be given a grace period depending on the account's enablement state prior to transition."
},
"eventually_due": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000
},
"description": "Fields you must collect when all thresholds are reached. As they become required, they appear in `currently_due` as well, and the account's `future_requirements[current_deadline]` becomes set."
},
"pending_verification": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000
},
"description": "Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending."
}
},
"description": "",
"x-expandableFields": [
"alternatives",
"errors"
]
}
person_race_details
{
"type": "object",
"title": "PersonRaceDetails",
"properties": {
"race": {
"type": "array",
"items": {
"enum": [
"african_american",
"american_indian_or_alaska_native",
"asian",
"asian_indian",
"black_or_african_american",
"chinese",
"ethiopian",
"filipino",
"guamanian_or_chamorro",
"haitian",
"jamaican",
"japanese",
"korean",
"native_hawaiian",
"native_hawaiian_or_other_pacific_islander",
"nigerian",
"other_asian",
"other_black_or_african_american",
"other_pacific_islander",
"prefer_not_to_answer",
"samoan",
"somali",
"vietnamese",
"white"
],
"type": "string"
},
"nullable": true,
"description": "The persons race."
},
"race_other": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "Please specify your race, when other is selected."
}
},
"description": "",
"x-expandableFields": []
}
person_relationship
{
"type": "object",
"title": "PersonRelationship",
"properties": {
"owner": {
"type": "boolean",
"nullable": true,
"description": "Whether the person is an owner of the account’s legal entity."
},
"title": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The person's title (e.g., CEO, Support Engineer)."
},
"director": {
"type": "boolean",
"nullable": true,
"description": "Whether the person is a director of the account's legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations."
},
"executive": {
"type": "boolean",
"nullable": true,
"description": "Whether the person has significant responsibility to control, manage, or direct the organization."
},
"authorizer": {
"type": "boolean",
"nullable": true,
"description": "Whether the person is the authorizer of the account's representative."
},
"legal_guardian": {
"type": "boolean",
"nullable": true,
"description": "Whether the person is the legal guardian of the account's representative."
},
"representative": {
"type": "boolean",
"nullable": true,
"description": "Whether the person is authorized as the primary representative of the account. This is the person nominated by the business to provide information about themselves, and general information about the account. There can only be one representative at any given time. At the time the account is created, this person should be set to the person responsible for opening the account."
},
"percent_ownership": {
"type": "number",
"nullable": true,
"description": "The percent owned by the person of the account's legal entity."
}
},
"description": "",
"x-expandableFields": []
}
person_requirements
{
"type": "object",
"title": "PersonRequirements",
"required": [
"currently_due",
"errors",
"eventually_due",
"past_due",
"pending_verification"
],
"properties": {
"errors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/account_requirements_error"
},
"description": "Details about validation and verification failures for `due` requirements that must be resolved."
},
"past_due": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000
},
"description": "Fields that haven't been resolved by `current_deadline`. These fields need to be resolved to enable the person's account."
},
"alternatives": {
"type": "array",
"items": {
"$ref": "#/components/schemas/account_requirements_alternative"
},
"nullable": true,
"description": "Fields that are due and can be resolved by providing the corresponding alternative fields instead. Many alternatives can list the same `original_fields_due`, and any of these alternatives can serve as a pathway for attempting to resolve the fields again. Re-providing `original_fields_due` also serves as a pathway for attempting to resolve the fields again."
},
"currently_due": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000
},
"description": "Fields that need to be resolved to keep the person's account enabled. If not resolved by the account's `current_deadline`, these fields will appear in `past_due` as well, and the account is disabled."
},
"eventually_due": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000
},
"description": "Fields you must collect when all thresholds are reached. As they become required, they appear in `currently_due` as well, and the account's `current_deadline` becomes set."
},
"pending_verification": {
"type": "array",
"items": {
"type": "string",
"maxLength": 5000
},
"description": "Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending."
}
},
"description": "",
"x-expandableFields": [
"alternatives",
"errors"
]
}
person_us_cfpb_data
{
"type": "object",
"title": "PersonUSCfpbData",
"properties": {
"race_details": {
"anyOf": [
{
"$ref": "#/components/schemas/person_race_details"
}
],
"nullable": true,
"description": "The persons race details"
},
"ethnicity_details": {
"anyOf": [
{
"$ref": "#/components/schemas/person_ethnicity_details"
}
],
"nullable": true,
"description": "The persons ethnicity details"
},
"self_identified_gender": {
"type": "string",
"nullable": true,
"maxLength": 5000,
"description": "The persons self-identified gender"
}
},
"description": "",
"x-expandableFields": [
"ethnicity_details",
"race_details"
]
}