Stripe · Schema
PostIssuingDisputesRequest
CommerceFinancial ServicesFintechPaymentsT1StripeAgentic CommercePoint-of-SalePayment Processing
Properties
| Name | Type | Description |
|---|---|---|
| amount | integer | The dispute amount in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If not set, defaults to the full transaction amount. |
| evidence | object | Evidence provided for the dispute. |
| expand | array | Specifies which fields in the response should be expanded. |
| metadata | object | 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. Individu |
| transaction | string | The ID of the issuing transaction to create a dispute for. For transaction on Treasury FinancialAccounts, use `treasury.received_debit`. |
| treasury | object | Params for disputes related to Treasury FinancialAccounts |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/stripe/main/json-schema/stripe-post-issuing-disputes-request-schema.json",
"title": "PostIssuingDisputesRequest",
"x-generated": "2026-10-12",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/stripe-issuing-api-openapi.yml#/components/schemas/PostIssuingDisputesRequest",
"type": "object",
"properties": {
"amount": {
"description": "The dispute amount in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If not set, defaults to the full transaction amount.",
"type": "integer"
},
"evidence": {
"description": "Evidence provided for the dispute.",
"properties": {
"canceled": {
"anyOf": [
{
"properties": {
"additional_documentation": {
"anyOf": [
{
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"canceled_at": {
"anyOf": [
{
"format": "unix-time",
"type": "integer"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"cancellation_policy_provided": {
"anyOf": [
{
"type": "boolean"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"cancellation_reason": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"expected_at": {
"anyOf": [
{
"format": "unix-time",
"type": "integer"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"explanation": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"product_description": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"product_type": {
"enum": [
"",
"merchandise",
"service"
],
"type": "string"
},
"return_status": {
"enum": [
"",
"merchant_rejected",
"successful"
],
"type": "string"
},
"returned_at": {
"anyOf": [
{
"format": "unix-time",
"type": "integer"
},
{
"enum": [
""
],
"type": "string"
}
]
}
},
"title": "canceled",
"type": "object"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"duplicate": {
"anyOf": [
{
"properties": {
"additional_documentation": {
"anyOf": [
{
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"card_statement": {
"anyOf": [
{
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"cash_receipt": {
"anyOf": [
{
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"check_image": {
"anyOf": [
{
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"explanation": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"original_transaction": {
"maxLength": 5000,
"type": "string"
}
},
"title": "duplicate",
"type": "object"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"fraudulent": {
"anyOf": [
{
"properties": {
"additional_documentation": {
"anyOf": [
{
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"explanation": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
}
},
"title": "fraudulent",
"type": "object"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"merchandise_not_as_described": {
"anyOf": [
{
"properties": {
"additional_documentation": {
"anyOf": [
{
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"explanation": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"received_at": {
"anyOf": [
{
"format": "unix-time",
"type": "integer"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"return_description": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"return_status": {
"enum": [
"",
"merchant_rejected",
"successful"
],
"type": "string"
},
"returned_at": {
"anyOf": [
{
"format": "unix-time",
"type": "integer"
},
{
"enum": [
""
],
"type": "string"
}
]
}
},
"title": "merchandise_not_as_described",
"type": "object"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"not_received": {
"anyOf": [
{
"properties": {
"additional_documentation": {
"anyOf": [
{
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"expected_at": {
"anyOf": [
{
"format": "unix-time",
"type": "integer"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"explanation": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"product_description": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"product_type": {
"enum": [
"",
"merchandise",
"service"
],
"type": "string"
}
},
"title": "not_received",
"type": "object"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"other": {
"anyOf": [
{
"properties": {
"additional_documentation": {
"anyOf": [
{
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"explanation": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"product_description": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"product_type": {
"enum": [
"",
"merchandise",
"service"
],
"type": "string"
}
},
"title": "other",
"type": "object"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"reason": {
"enum": [
"canceled",
"duplicate",
"fraudulent",
"merchandise_not_as_described",
"not_received",
"other",
"service_not_as_described"
],
"type": "string",
"x-stripeBypassValidation": true
},
"service_not_as_described": {
"anyOf": [
{
"properties": {
"additional_documentation": {
"anyOf": [
{
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"canceled_at": {
"anyOf": [
{
"format": "unix-time",
"type": "integer"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"cancellation_reason": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"explanation": {
"anyOf": [
{
"maxLength": 1500,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
},
"received_at": {
"anyOf": [
{
"format": "unix-time",
"type": "integer"
},
{
"enum": [
""
],
"type": "string"
}
]
}
},
"title": "service_not_as_described",
"type": "object"
},
{
"enum": [
""
],
"type": "string"
}
]
}
},
"title": "evidence_param",
"type": "object"
},
"expand": {
"description": "Specifies which fields in the response should be expanded.",
"items": {
"maxLength": 5000,
"type": "string"
},
"type": "array"
},
"metadata": {
"additionalProperties": {
"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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.",
"type": "object"
},
"transaction": {
"description": "The ID of the issuing transaction to create a dispute for. For transaction on Treasury FinancialAccounts, use `treasury.received_debit`.",
"maxLength": 5000,
"type": "string"
},
"treasury": {
"description": "Params for disputes related to Treasury FinancialAccounts",
"properties": {
"received_debit": {
"maxLength": 5000,
"type": "string"
}
},
"required": [
"received_debit"
],
"title": "treasury_param",
"type": "object"
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/stripe-post-issuing-disputes-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.