{
  "$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"
    }
  }
}