Refund Request

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/refund_request",
  "title": "Refund Request",
  "type": "object",
  "description": "Refunds a captured payment, by ID. For a full refund, include an empty request body. For a partial refund, include an <code>amount</code> object in the request body.",
  "properties": {
    "amount": {
      "description": "The amount to refund. To refund a portion of the captured amount, specify an amount. If amount is not specified, an amount equal to <code>captured amount - previous refunds</code> is refunded. The amount must be a positive number and in the same currency as the one in which the payment was captured.",
      "$ref": "#/components/schemas/money"
    },
    "custom_id": {
      "type": "string",
      "description": "The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports. The pattern is defined by an external party and supports Unicode.",
      "minLength": 1,
      "maxLength": 127,
      "pattern": "^.*$"
    },
    "invoice_id": {
      "type": "string",
      "description": "The API caller-provided external invoice ID for this order. The pattern is defined by an external party and supports Unicode.",
      "minLength": 1,
      "maxLength": 127,
      "pattern": "^.*$"
    },
    "note_to_payer": {
      "type": "string",
      "description": "The reason for the refund. Appears in both the payer's transaction history and the emails that the payer receives. The pattern is defined by an external party and supports Unicode.",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^.*$"
    },
    "payment_instruction": {
      "description": "Any additional refund instructions to be set during refund payment processing. This object is only applicable to merchants that have been enabled for PayPal Commerce Platform for Marketplaces and Platforms capability. Please speak to your account manager if you want to use this capability.",
      "$ref": "#/components/schemas/payment_instruction-2"
    }
  }
}