Adyen · Schema

PaymentRefundResponse

PaymentRefundResponse schema from Adyen API

PaymentsFinancial ServicesFintech

Properties

Name	Type	Description
amount	object	The refund amount.
lineItems	array	Price and product information of the refunded items, required for [partial refunds](https://docs.adyen.com/online-payments/refund#refund-a-payment). > This field is required for partial refunds with 3
merchantAccount	string	The merchant account that is used to process the payment.
merchantRefundReason	string	Your reason for the refund request.
paymentPspReference	string	The [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference) of the payment to refund.
pspReference	string	Adyen's 16-character reference associated with the refund request.
reference	string	Your reference for the refund request.
splits	array	An array of objects specifying how the amount should be split between accounts when using Adyen for Platforms. For details, refer to [Providing split information](https://docs.adyen.com/marketplaces-a
status	string	The status of your request. This will always have the value received.
store	string	The online store or [physical store](https://docs.adyen.com/point-of-sale/design-your-integration/determine-account-structure/#create-stores) that is processing the refund. This must be the same as th

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-schema/checkout-payment-refund-response-schema.json",
  "title": "PaymentRefundResponse",
  "description": "PaymentRefundResponse schema from Adyen API",
  "type": "object",
  "properties": {
    "amount": {
      "description": "The refund amount.",
      "$ref": "#/components/schemas/Amount"
    },
    "lineItems": {
      "description": "Price and product information of the refunded items, required for [partial refunds](https://docs.adyen.com/online-payments/refund#refund-a-payment).\n> This field is required for partial refunds with 3x 4x Oney, Affirm, Afterpay, Atome, Clearpay, Klarna, Ratepay, Walley, and Zip.",
      "items": {
        "$ref": "#/components/schemas/LineItem"
      },
      "type": "array"
    },
    "merchantAccount": {
      "description": "The merchant account that is used to process the payment.",
      "type": "string"
    },
    "merchantRefundReason": {
      "description": "Your reason for the refund request.",
      "enum": [
        "FRAUD",
        "CUSTOMER REQUEST",
        "RETURN",
        "DUPLICATE",
        "OTHER"
      ],
      "type": "string"
    },
    "paymentPspReference": {
      "description": "The [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference) of the payment to refund. ",
      "type": "string"
    },
    "pspReference": {
      "description": "Adyen's 16-character reference associated with the refund request.",
      "type": "string"
    },
    "reference": {
      "description": "Your reference for the refund request.",
      "type": "string"
    },
    "splits": {
      "description": "An array of objects specifying how the amount should be split between accounts when using Adyen for Platforms. For details, refer to [Providing split information](https://docs.adyen.com/marketplaces-and-platforms/processing-payments#providing-split-information).",
      "items": {
        "$ref": "#/components/schemas/Split"
      },
      "type": "array"
    },
    "status": {
      "description": "The status of your request. This will always have the value **received**.",
      "enum": [
        "received"
      ],
      "type": "string"
    },
    "store": {
      "description": "The online store or [physical store](https://docs.adyen.com/point-of-sale/design-your-integration/determine-account-structure/#create-stores) that is processing the refund. This must be the same as the store name configured in your Customer Area.  Otherwise, you get an error and the refund fails.",
      "type": "string"
    }
  },
  "required": [
    "status",
    "merchantAccount",
    "amount",
    "pspReference",
    "paymentPspReference"
  ]
}