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 |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/PaymentRefundResponse",
"title": "PaymentRefundResponse",
"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"
],
"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/adyen-paymentrefundresponse"
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.