RefundRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/outpost-ai/json-schema/outpost-ai-refund-request-schema.json",
  "title": "RefundRequest",
  "description": "Optional body for `POST /api/payments/{paymentId}/refund`. Omit for a\nfull refund of the unrefunded remainder.\n",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/outpost-ai-stripe-mor.yaml#/components/schemas/RefundRequest",
  "type": "object",
  "properties": {
    "amount": {
      "type": "integer",
      "minimum": 1,
      "description": "Smallest currency unit. Defaults to the unrefunded remainder of\nthe payment (full refund). Must be ≤ remaining refundable amount.\n"
    },
    "reason": {
      "type": "string",
      "description": "One of `requested_by_customer`, `duplicate`, `fraudulent`.\nFree-form strings are also accepted and forwarded to the PSP.\n"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Arbitrary key/value pairs persisted on the refund and forwarded to\nthe PSP refund object.\n"
    }
  }
}