From 0d70bd156ea29a618fa49b7374d5444d0c0d9fb9 Mon Sep 17 00:00:00 2001 From: Adyen Automation Date: Tue, 8 Apr 2025 22:22:53 +0200 Subject: [PATCH] spec release --- ...BalancePlatformDisputeNotification-v1.json | 3 +- json/TransactionService-v1.json | 59 +++++++++++- json/TransactionService-v2.json | 59 +++++++++++- json/TransactionService-v3.json | 59 +++++++++++- json/TransactionService-v4.json | 59 +++++++++++- ...BalancePlatformDisputeNotification-v1.yaml | 1 + yaml/TransactionService-v1.yaml | 94 ++++++++++++++++++- yaml/TransactionService-v2.yaml | 94 ++++++++++++++++++- yaml/TransactionService-v3.yaml | 94 ++++++++++++++++++- yaml/TransactionService-v4.yaml | 94 ++++++++++++++++++- 10 files changed, 591 insertions(+), 25 deletions(-) diff --git a/json/BalancePlatformDisputeNotification-v1.json b/json/BalancePlatformDisputeNotification-v1.json index f69d915..b6e9882 100644 --- a/json/BalancePlatformDisputeNotification-v1.json +++ b/json/BalancePlatformDisputeNotification-v1.json @@ -175,7 +175,8 @@ "description" : "The type of dispute raised for the transaction.", "enum" : [ "fraud", - "notDelivered" + "notDelivered", + "duplicate" ], "type" : "string" } diff --git a/json/TransactionService-v1.json b/json/TransactionService-v1.json index 5674fc3..bda92b3 100644 --- a/json/TransactionService-v1.json +++ b/json/TransactionService-v1.json @@ -16,7 +16,7 @@ "url" : "https://github.com/Adyen/adyen-openapi" }, "version" : "1", - "x-timestamp" : "2025-03-21T17:33:57Z" + "x-timestamp" : "2025-04-03T18:36:10Z" }, "tags" : [ { "name" : "Dispute Attachments" @@ -425,7 +425,7 @@ "description" : "The unique reference of the transaction for which you are raising the dispute." }, "type" : { - "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**.", + "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**, **duplicate**.", "$ref" : "#/components/schemas/DisputeType" } } @@ -484,17 +484,43 @@ "required" : [ "descriptionOfIssue", "lastExpectedDate", "whatWasNotDelivered" ], "type" : "object", "properties" : { + "agreedDeliveryLocation" : { + "maxLength" : 2500, + "minLength" : 0, + "type" : "string", + "description" : "The delivery location specified by the cardholder. Required if `deliveredToWrongLocation` is **true**." + }, "dateOfCancellation" : { "type" : "string", "description" : "The date the undelivered goods or services were cancelled in YYYY-MM-DD format.", "format" : "date" }, + "deliveredToWrongLocation" : { + "type" : "boolean", + "description" : "Indicates goods were delivered to the wrong location.\n\nPossible values: **true**, **false**." + }, "descriptionOfIssue" : { "maxLength" : 2500, "minLength" : 0, "type" : "string", "description" : "Your description of the issue for raising a dispute of `type` **notDelivered**." }, + "didCardholderReturn" : { + "type" : "boolean", + "description" : "Indicates if the cardholder returned the goods to the merchant.\n\nPossible values: **true**, **false**." + }, + "isDeliveryLate" : { + "type" : "boolean", + "description" : "Indicates if the goods or services were delivered late.\n\nPossible values: **true**, **false**." + }, + "isMerchantBankrupt" : { + "type" : "boolean", + "description" : "Indicates if the transaction was processed by a bankrupt merchant.\n\nPossible values: **true**, **false**." + }, + "isNonFiatOrNft" : { + "type" : "boolean", + "description" : "Indicates if the transaction is non-fiat or non-fungible token (NFT) related.\n\nPossible values: **true**, **false**." + }, "lastExpectedDate" : { "type" : "string", "description" : "The date the undelivered goods or services were expected to be delivered in YYYY-MM-DD format.", @@ -532,6 +558,7 @@ "$ref" : "#/components/schemas/Amount" }, "duplicateInfo" : { + "description" : "Additional information for raising a dispute of `type` **duplicate**. Required for disputes of `type` **duplicate**.", "$ref" : "#/components/schemas/DuplicateInfo" }, "fraudInfo" : { @@ -556,7 +583,7 @@ "description" : "The unique reference of the transaction for which you are raising the dispute." }, "type" : { - "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**.", + "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**, **duplicate**.", "$ref" : "#/components/schemas/DisputeType" } } @@ -645,17 +672,43 @@ "PatchableNotDeliveredInfo" : { "type" : "object", "properties" : { + "agreedDeliveryLocation" : { + "maxLength" : 2500, + "minLength" : 0, + "type" : [ "string", "null" ], + "description" : "The delivery location specified by the cardholder. Required if `deliveredToWrongLocation` is **true**." + }, "dateOfCancellation" : { "type" : [ "string", "null" ], "description" : "The date the undelivered goods or services were cancelled in YYYY-MM-DD format.", "format" : "date" }, + "deliveredToWrongLocation" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates goods were delivered to the wrong location.\n\nPossible values: **true**, **false**." + }, "descriptionOfIssue" : { "maxLength" : 2500, "minLength" : 0, "type" : "string", "description" : "Your description of the issue for raising a dispute of `type` **notDelivered**." }, + "didCardholderReturn" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the cardholder returned the goods to the merchant.\n\nPossible values: **true**, **false**." + }, + "isDeliveryLate" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the goods or services were delivered late.\n\nPossible values: **true**, **false**." + }, + "isMerchantBankrupt" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the transaction was processed by a bankrupt merchant.\n\nPossible values: **true**, **false**." + }, + "isNonFiatOrNft" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the transaction is non-fiat or non-fungible token (NFT) related.\n\nPossible values: **true**, **false**." + }, "lastExpectedDate" : { "type" : "string", "description" : "The date the undelivered goods or services were expected to be delivered in YYYY-MM-DD format.", diff --git a/json/TransactionService-v2.json b/json/TransactionService-v2.json index f9100fa..d5b2d42 100644 --- a/json/TransactionService-v2.json +++ b/json/TransactionService-v2.json @@ -16,7 +16,7 @@ "url" : "https://github.com/Adyen/adyen-openapi" }, "version" : "2", - "x-timestamp" : "2025-03-21T17:33:58Z" + "x-timestamp" : "2025-04-03T18:36:11Z" }, "tags" : [ { "name" : "Dispute Attachments" @@ -425,7 +425,7 @@ "description" : "The unique reference of the transaction for which you are raising the dispute." }, "type" : { - "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**.", + "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**, **duplicate**.", "$ref" : "#/components/schemas/DisputeType" } } @@ -484,17 +484,43 @@ "required" : [ "descriptionOfIssue", "lastExpectedDate", "whatWasNotDelivered" ], "type" : "object", "properties" : { + "agreedDeliveryLocation" : { + "maxLength" : 2500, + "minLength" : 0, + "type" : "string", + "description" : "The delivery location specified by the cardholder. Required if `deliveredToWrongLocation` is **true**." + }, "dateOfCancellation" : { "type" : "string", "description" : "The date the undelivered goods or services were cancelled in YYYY-MM-DD format.", "format" : "date" }, + "deliveredToWrongLocation" : { + "type" : "boolean", + "description" : "Indicates goods were delivered to the wrong location.\n\nPossible values: **true**, **false**." + }, "descriptionOfIssue" : { "maxLength" : 2500, "minLength" : 0, "type" : "string", "description" : "Your description of the issue for raising a dispute of `type` **notDelivered**." }, + "didCardholderReturn" : { + "type" : "boolean", + "description" : "Indicates if the cardholder returned the goods to the merchant.\n\nPossible values: **true**, **false**." + }, + "isDeliveryLate" : { + "type" : "boolean", + "description" : "Indicates if the goods or services were delivered late.\n\nPossible values: **true**, **false**." + }, + "isMerchantBankrupt" : { + "type" : "boolean", + "description" : "Indicates if the transaction was processed by a bankrupt merchant.\n\nPossible values: **true**, **false**." + }, + "isNonFiatOrNft" : { + "type" : "boolean", + "description" : "Indicates if the transaction is non-fiat or non-fungible token (NFT) related.\n\nPossible values: **true**, **false**." + }, "lastExpectedDate" : { "type" : "string", "description" : "The date the undelivered goods or services were expected to be delivered in YYYY-MM-DD format.", @@ -532,6 +558,7 @@ "$ref" : "#/components/schemas/Amount" }, "duplicateInfo" : { + "description" : "Additional information for raising a dispute of `type` **duplicate**. Required for disputes of `type` **duplicate**.", "$ref" : "#/components/schemas/DuplicateInfo" }, "fraudInfo" : { @@ -556,7 +583,7 @@ "description" : "The unique reference of the transaction for which you are raising the dispute." }, "type" : { - "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**.", + "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**, **duplicate**.", "$ref" : "#/components/schemas/DisputeType" } } @@ -645,17 +672,43 @@ "PatchableNotDeliveredInfo" : { "type" : "object", "properties" : { + "agreedDeliveryLocation" : { + "maxLength" : 2500, + "minLength" : 0, + "type" : [ "string", "null" ], + "description" : "The delivery location specified by the cardholder. Required if `deliveredToWrongLocation` is **true**." + }, "dateOfCancellation" : { "type" : [ "string", "null" ], "description" : "The date the undelivered goods or services were cancelled in YYYY-MM-DD format.", "format" : "date" }, + "deliveredToWrongLocation" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates goods were delivered to the wrong location.\n\nPossible values: **true**, **false**." + }, "descriptionOfIssue" : { "maxLength" : 2500, "minLength" : 0, "type" : "string", "description" : "Your description of the issue for raising a dispute of `type` **notDelivered**." }, + "didCardholderReturn" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the cardholder returned the goods to the merchant.\n\nPossible values: **true**, **false**." + }, + "isDeliveryLate" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the goods or services were delivered late.\n\nPossible values: **true**, **false**." + }, + "isMerchantBankrupt" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the transaction was processed by a bankrupt merchant.\n\nPossible values: **true**, **false**." + }, + "isNonFiatOrNft" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the transaction is non-fiat or non-fungible token (NFT) related.\n\nPossible values: **true**, **false**." + }, "lastExpectedDate" : { "type" : "string", "description" : "The date the undelivered goods or services were expected to be delivered in YYYY-MM-DD format.", diff --git a/json/TransactionService-v3.json b/json/TransactionService-v3.json index 2b5c494..72cb8b6 100644 --- a/json/TransactionService-v3.json +++ b/json/TransactionService-v3.json @@ -16,7 +16,7 @@ "url" : "https://github.com/Adyen/adyen-openapi" }, "version" : "3", - "x-timestamp" : "2025-03-21T17:33:58Z" + "x-timestamp" : "2025-04-03T18:36:11Z" }, "tags" : [ { "name" : "Dispute Attachments" @@ -425,7 +425,7 @@ "description" : "The unique reference of the transaction for which you are raising the dispute." }, "type" : { - "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**.", + "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**, **duplicate**.", "$ref" : "#/components/schemas/DisputeType" } } @@ -484,17 +484,43 @@ "required" : [ "descriptionOfIssue", "lastExpectedDate", "whatWasNotDelivered" ], "type" : "object", "properties" : { + "agreedDeliveryLocation" : { + "maxLength" : 2500, + "minLength" : 0, + "type" : "string", + "description" : "The delivery location specified by the cardholder. Required if `deliveredToWrongLocation` is **true**." + }, "dateOfCancellation" : { "type" : "string", "description" : "The date the undelivered goods or services were cancelled in YYYY-MM-DD format.", "format" : "date" }, + "deliveredToWrongLocation" : { + "type" : "boolean", + "description" : "Indicates goods were delivered to the wrong location.\n\nPossible values: **true**, **false**." + }, "descriptionOfIssue" : { "maxLength" : 2500, "minLength" : 0, "type" : "string", "description" : "Your description of the issue for raising a dispute of `type` **notDelivered**." }, + "didCardholderReturn" : { + "type" : "boolean", + "description" : "Indicates if the cardholder returned the goods to the merchant.\n\nPossible values: **true**, **false**." + }, + "isDeliveryLate" : { + "type" : "boolean", + "description" : "Indicates if the goods or services were delivered late.\n\nPossible values: **true**, **false**." + }, + "isMerchantBankrupt" : { + "type" : "boolean", + "description" : "Indicates if the transaction was processed by a bankrupt merchant.\n\nPossible values: **true**, **false**." + }, + "isNonFiatOrNft" : { + "type" : "boolean", + "description" : "Indicates if the transaction is non-fiat or non-fungible token (NFT) related.\n\nPossible values: **true**, **false**." + }, "lastExpectedDate" : { "type" : "string", "description" : "The date the undelivered goods or services were expected to be delivered in YYYY-MM-DD format.", @@ -532,6 +558,7 @@ "$ref" : "#/components/schemas/Amount" }, "duplicateInfo" : { + "description" : "Additional information for raising a dispute of `type` **duplicate**. Required for disputes of `type` **duplicate**.", "$ref" : "#/components/schemas/DuplicateInfo" }, "fraudInfo" : { @@ -556,7 +583,7 @@ "description" : "The unique reference of the transaction for which you are raising the dispute." }, "type" : { - "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**.", + "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**, **duplicate**.", "$ref" : "#/components/schemas/DisputeType" } } @@ -645,17 +672,43 @@ "PatchableNotDeliveredInfo" : { "type" : "object", "properties" : { + "agreedDeliveryLocation" : { + "maxLength" : 2500, + "minLength" : 0, + "type" : [ "string", "null" ], + "description" : "The delivery location specified by the cardholder. Required if `deliveredToWrongLocation` is **true**." + }, "dateOfCancellation" : { "type" : [ "string", "null" ], "description" : "The date the undelivered goods or services were cancelled in YYYY-MM-DD format.", "format" : "date" }, + "deliveredToWrongLocation" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates goods were delivered to the wrong location.\n\nPossible values: **true**, **false**." + }, "descriptionOfIssue" : { "maxLength" : 2500, "minLength" : 0, "type" : "string", "description" : "Your description of the issue for raising a dispute of `type` **notDelivered**." }, + "didCardholderReturn" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the cardholder returned the goods to the merchant.\n\nPossible values: **true**, **false**." + }, + "isDeliveryLate" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the goods or services were delivered late.\n\nPossible values: **true**, **false**." + }, + "isMerchantBankrupt" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the transaction was processed by a bankrupt merchant.\n\nPossible values: **true**, **false**." + }, + "isNonFiatOrNft" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the transaction is non-fiat or non-fungible token (NFT) related.\n\nPossible values: **true**, **false**." + }, "lastExpectedDate" : { "type" : "string", "description" : "The date the undelivered goods or services were expected to be delivered in YYYY-MM-DD format.", diff --git a/json/TransactionService-v4.json b/json/TransactionService-v4.json index 8731247..d4a5b0d 100644 --- a/json/TransactionService-v4.json +++ b/json/TransactionService-v4.json @@ -16,7 +16,7 @@ "url" : "https://github.com/Adyen/adyen-openapi" }, "version" : "4", - "x-timestamp" : "2025-03-21T17:33:58Z" + "x-timestamp" : "2025-04-03T18:36:11Z" }, "tags" : [ { "name" : "Dispute Attachments" @@ -425,7 +425,7 @@ "description" : "The unique reference of the transaction for which you are raising the dispute." }, "type" : { - "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**.", + "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**, **duplicate**.", "$ref" : "#/components/schemas/DisputeType" } } @@ -484,17 +484,43 @@ "required" : [ "descriptionOfIssue", "lastExpectedDate", "whatWasNotDelivered" ], "type" : "object", "properties" : { + "agreedDeliveryLocation" : { + "maxLength" : 2500, + "minLength" : 0, + "type" : "string", + "description" : "The delivery location specified by the cardholder. Required if `deliveredToWrongLocation` is **true**." + }, "dateOfCancellation" : { "type" : "string", "description" : "The date the undelivered goods or services were cancelled in YYYY-MM-DD format.", "format" : "date" }, + "deliveredToWrongLocation" : { + "type" : "boolean", + "description" : "Indicates goods were delivered to the wrong location.\n\nPossible values: **true**, **false**." + }, "descriptionOfIssue" : { "maxLength" : 2500, "minLength" : 0, "type" : "string", "description" : "Your description of the issue for raising a dispute of `type` **notDelivered**." }, + "didCardholderReturn" : { + "type" : "boolean", + "description" : "Indicates if the cardholder returned the goods to the merchant.\n\nPossible values: **true**, **false**." + }, + "isDeliveryLate" : { + "type" : "boolean", + "description" : "Indicates if the goods or services were delivered late.\n\nPossible values: **true**, **false**." + }, + "isMerchantBankrupt" : { + "type" : "boolean", + "description" : "Indicates if the transaction was processed by a bankrupt merchant.\n\nPossible values: **true**, **false**." + }, + "isNonFiatOrNft" : { + "type" : "boolean", + "description" : "Indicates if the transaction is non-fiat or non-fungible token (NFT) related.\n\nPossible values: **true**, **false**." + }, "lastExpectedDate" : { "type" : "string", "description" : "The date the undelivered goods or services were expected to be delivered in YYYY-MM-DD format.", @@ -532,6 +558,7 @@ "$ref" : "#/components/schemas/Amount" }, "duplicateInfo" : { + "description" : "Additional information for raising a dispute of `type` **duplicate**. Required for disputes of `type` **duplicate**.", "$ref" : "#/components/schemas/DuplicateInfo" }, "fraudInfo" : { @@ -556,7 +583,7 @@ "description" : "The unique reference of the transaction for which you are raising the dispute." }, "type" : { - "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**.", + "description" : "The type of the dispute.\n\nPossible values: **notDelivered**, **fraud**, **duplicate**.", "$ref" : "#/components/schemas/DisputeType" } } @@ -645,17 +672,43 @@ "PatchableNotDeliveredInfo" : { "type" : "object", "properties" : { + "agreedDeliveryLocation" : { + "maxLength" : 2500, + "minLength" : 0, + "type" : [ "string", "null" ], + "description" : "The delivery location specified by the cardholder. Required if `deliveredToWrongLocation` is **true**." + }, "dateOfCancellation" : { "type" : [ "string", "null" ], "description" : "The date the undelivered goods or services were cancelled in YYYY-MM-DD format.", "format" : "date" }, + "deliveredToWrongLocation" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates goods were delivered to the wrong location.\n\nPossible values: **true**, **false**." + }, "descriptionOfIssue" : { "maxLength" : 2500, "minLength" : 0, "type" : "string", "description" : "Your description of the issue for raising a dispute of `type` **notDelivered**." }, + "didCardholderReturn" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the cardholder returned the goods to the merchant.\n\nPossible values: **true**, **false**." + }, + "isDeliveryLate" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the goods or services were delivered late.\n\nPossible values: **true**, **false**." + }, + "isMerchantBankrupt" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the transaction was processed by a bankrupt merchant.\n\nPossible values: **true**, **false**." + }, + "isNonFiatOrNft" : { + "type" : [ "boolean", "null" ], + "description" : "Indicates if the transaction is non-fiat or non-fungible token (NFT) related.\n\nPossible values: **true**, **false**." + }, "lastExpectedDate" : { "type" : "string", "description" : "The date the undelivered goods or services were expected to be delivered in YYYY-MM-DD format.", diff --git a/yaml/BalancePlatformDisputeNotification-v1.yaml b/yaml/BalancePlatformDisputeNotification-v1.yaml index 989e951..6697b3d 100644 --- a/yaml/BalancePlatformDisputeNotification-v1.yaml +++ b/yaml/BalancePlatformDisputeNotification-v1.yaml @@ -133,6 +133,7 @@ components: enum: - fraud - notDelivered + - duplicate type: string type: object DisputeNotificationRequest: diff --git a/yaml/TransactionService-v1.yaml b/yaml/TransactionService-v1.yaml index 50d398e..c570581 100644 --- a/yaml/TransactionService-v1.yaml +++ b/yaml/TransactionService-v1.yaml @@ -30,7 +30,7 @@ info: name: Adyen Developer Experience team url: https://github.com/Adyen/adyen-openapi version: '1' - x-timestamp: '2025-03-21T17:33:57Z' + x-timestamp: '2025-04-03T18:36:10Z' tags: - name: Dispute Attachments - name: Raise Disputes @@ -397,7 +397,7 @@ components: description: 'The type of the dispute. - Possible values: **notDelivered**, **fraud**.' + Possible values: **notDelivered**, **fraud**, **duplicate**.' $ref: '#/components/schemas/DisputeType' DisputeStatus: type: string @@ -465,17 +465,54 @@ components: - whatWasNotDelivered type: object properties: + agreedDeliveryLocation: + maxLength: 2500 + minLength: 0 + type: string + description: The delivery location specified by the cardholder. Required + if `deliveredToWrongLocation` is **true**. dateOfCancellation: type: string description: The date the undelivered goods or services were cancelled in YYYY-MM-DD format. format: date + deliveredToWrongLocation: + type: boolean + description: 'Indicates goods were delivered to the wrong location. + + + Possible values: **true**, **false**.' descriptionOfIssue: maxLength: 2500 minLength: 0 type: string description: Your description of the issue for raising a dispute of `type` **notDelivered**. + didCardholderReturn: + type: boolean + description: 'Indicates if the cardholder returned the goods to the merchant. + + + Possible values: **true**, **false**.' + isDeliveryLate: + type: boolean + description: 'Indicates if the goods or services were delivered late. + + + Possible values: **true**, **false**.' + isMerchantBankrupt: + type: boolean + description: 'Indicates if the transaction was processed by a bankrupt merchant. + + + Possible values: **true**, **false**.' + isNonFiatOrNft: + type: boolean + description: 'Indicates if the transaction is non-fiat or non-fungible token + (NFT) related. + + + Possible values: **true**, **false**.' lastExpectedDate: type: string description: The date the undelivered goods or services were expected to @@ -519,6 +556,8 @@ components: an amount, the entire transaction amount will be disputed. $ref: '#/components/schemas/Amount' duplicateInfo: + description: Additional information for raising a dispute of `type` **duplicate**. + Required for disputes of `type` **duplicate**. $ref: '#/components/schemas/DuplicateInfo' fraudInfo: description: Additional information for raising a dispute of `type` **fraud**. @@ -550,7 +589,7 @@ components: description: 'The type of the dispute. - Possible values: **notDelivered**, **fraud**.' + Possible values: **notDelivered**, **fraud**, **duplicate**.' $ref: '#/components/schemas/DisputeType' PatchableDisputeRequest: type: object @@ -633,6 +672,14 @@ components: PatchableNotDeliveredInfo: type: object properties: + agreedDeliveryLocation: + maxLength: 2500 + minLength: 0 + type: + - string + - 'null' + description: The delivery location specified by the cardholder. Required + if `deliveredToWrongLocation` is **true**. dateOfCancellation: type: - string @@ -640,12 +687,53 @@ components: description: The date the undelivered goods or services were cancelled in YYYY-MM-DD format. format: date + deliveredToWrongLocation: + type: + - boolean + - 'null' + description: 'Indicates goods were delivered to the wrong location. + + + Possible values: **true**, **false**.' descriptionOfIssue: maxLength: 2500 minLength: 0 type: string description: Your description of the issue for raising a dispute of `type` **notDelivered**. + didCardholderReturn: + type: + - boolean + - 'null' + description: 'Indicates if the cardholder returned the goods to the merchant. + + + Possible values: **true**, **false**.' + isDeliveryLate: + type: + - boolean + - 'null' + description: 'Indicates if the goods or services were delivered late. + + + Possible values: **true**, **false**.' + isMerchantBankrupt: + type: + - boolean + - 'null' + description: 'Indicates if the transaction was processed by a bankrupt merchant. + + + Possible values: **true**, **false**.' + isNonFiatOrNft: + type: + - boolean + - 'null' + description: 'Indicates if the transaction is non-fiat or non-fungible token + (NFT) related. + + + Possible values: **true**, **false**.' lastExpectedDate: type: string description: The date the undelivered goods or services were expected to diff --git a/yaml/TransactionService-v2.yaml b/yaml/TransactionService-v2.yaml index 5854429..134bcc9 100644 --- a/yaml/TransactionService-v2.yaml +++ b/yaml/TransactionService-v2.yaml @@ -30,7 +30,7 @@ info: name: Adyen Developer Experience team url: https://github.com/Adyen/adyen-openapi version: '2' - x-timestamp: '2025-03-21T17:33:58Z' + x-timestamp: '2025-04-03T18:36:11Z' tags: - name: Dispute Attachments - name: Raise Disputes @@ -397,7 +397,7 @@ components: description: 'The type of the dispute. - Possible values: **notDelivered**, **fraud**.' + Possible values: **notDelivered**, **fraud**, **duplicate**.' $ref: '#/components/schemas/DisputeType' DisputeStatus: type: string @@ -465,17 +465,54 @@ components: - whatWasNotDelivered type: object properties: + agreedDeliveryLocation: + maxLength: 2500 + minLength: 0 + type: string + description: The delivery location specified by the cardholder. Required + if `deliveredToWrongLocation` is **true**. dateOfCancellation: type: string description: The date the undelivered goods or services were cancelled in YYYY-MM-DD format. format: date + deliveredToWrongLocation: + type: boolean + description: 'Indicates goods were delivered to the wrong location. + + + Possible values: **true**, **false**.' descriptionOfIssue: maxLength: 2500 minLength: 0 type: string description: Your description of the issue for raising a dispute of `type` **notDelivered**. + didCardholderReturn: + type: boolean + description: 'Indicates if the cardholder returned the goods to the merchant. + + + Possible values: **true**, **false**.' + isDeliveryLate: + type: boolean + description: 'Indicates if the goods or services were delivered late. + + + Possible values: **true**, **false**.' + isMerchantBankrupt: + type: boolean + description: 'Indicates if the transaction was processed by a bankrupt merchant. + + + Possible values: **true**, **false**.' + isNonFiatOrNft: + type: boolean + description: 'Indicates if the transaction is non-fiat or non-fungible token + (NFT) related. + + + Possible values: **true**, **false**.' lastExpectedDate: type: string description: The date the undelivered goods or services were expected to @@ -519,6 +556,8 @@ components: an amount, the entire transaction amount will be disputed. $ref: '#/components/schemas/Amount' duplicateInfo: + description: Additional information for raising a dispute of `type` **duplicate**. + Required for disputes of `type` **duplicate**. $ref: '#/components/schemas/DuplicateInfo' fraudInfo: description: Additional information for raising a dispute of `type` **fraud**. @@ -550,7 +589,7 @@ components: description: 'The type of the dispute. - Possible values: **notDelivered**, **fraud**.' + Possible values: **notDelivered**, **fraud**, **duplicate**.' $ref: '#/components/schemas/DisputeType' PatchableDisputeRequest: type: object @@ -633,6 +672,14 @@ components: PatchableNotDeliveredInfo: type: object properties: + agreedDeliveryLocation: + maxLength: 2500 + minLength: 0 + type: + - string + - 'null' + description: The delivery location specified by the cardholder. Required + if `deliveredToWrongLocation` is **true**. dateOfCancellation: type: - string @@ -640,12 +687,53 @@ components: description: The date the undelivered goods or services were cancelled in YYYY-MM-DD format. format: date + deliveredToWrongLocation: + type: + - boolean + - 'null' + description: 'Indicates goods were delivered to the wrong location. + + + Possible values: **true**, **false**.' descriptionOfIssue: maxLength: 2500 minLength: 0 type: string description: Your description of the issue for raising a dispute of `type` **notDelivered**. + didCardholderReturn: + type: + - boolean + - 'null' + description: 'Indicates if the cardholder returned the goods to the merchant. + + + Possible values: **true**, **false**.' + isDeliveryLate: + type: + - boolean + - 'null' + description: 'Indicates if the goods or services were delivered late. + + + Possible values: **true**, **false**.' + isMerchantBankrupt: + type: + - boolean + - 'null' + description: 'Indicates if the transaction was processed by a bankrupt merchant. + + + Possible values: **true**, **false**.' + isNonFiatOrNft: + type: + - boolean + - 'null' + description: 'Indicates if the transaction is non-fiat or non-fungible token + (NFT) related. + + + Possible values: **true**, **false**.' lastExpectedDate: type: string description: The date the undelivered goods or services were expected to diff --git a/yaml/TransactionService-v3.yaml b/yaml/TransactionService-v3.yaml index 2ee0c65..d651d89 100644 --- a/yaml/TransactionService-v3.yaml +++ b/yaml/TransactionService-v3.yaml @@ -30,7 +30,7 @@ info: name: Adyen Developer Experience team url: https://github.com/Adyen/adyen-openapi version: '3' - x-timestamp: '2025-03-21T17:33:58Z' + x-timestamp: '2025-04-03T18:36:11Z' tags: - name: Dispute Attachments - name: Raise Disputes @@ -397,7 +397,7 @@ components: description: 'The type of the dispute. - Possible values: **notDelivered**, **fraud**.' + Possible values: **notDelivered**, **fraud**, **duplicate**.' $ref: '#/components/schemas/DisputeType' DisputeStatus: type: string @@ -465,17 +465,54 @@ components: - whatWasNotDelivered type: object properties: + agreedDeliveryLocation: + maxLength: 2500 + minLength: 0 + type: string + description: The delivery location specified by the cardholder. Required + if `deliveredToWrongLocation` is **true**. dateOfCancellation: type: string description: The date the undelivered goods or services were cancelled in YYYY-MM-DD format. format: date + deliveredToWrongLocation: + type: boolean + description: 'Indicates goods were delivered to the wrong location. + + + Possible values: **true**, **false**.' descriptionOfIssue: maxLength: 2500 minLength: 0 type: string description: Your description of the issue for raising a dispute of `type` **notDelivered**. + didCardholderReturn: + type: boolean + description: 'Indicates if the cardholder returned the goods to the merchant. + + + Possible values: **true**, **false**.' + isDeliveryLate: + type: boolean + description: 'Indicates if the goods or services were delivered late. + + + Possible values: **true**, **false**.' + isMerchantBankrupt: + type: boolean + description: 'Indicates if the transaction was processed by a bankrupt merchant. + + + Possible values: **true**, **false**.' + isNonFiatOrNft: + type: boolean + description: 'Indicates if the transaction is non-fiat or non-fungible token + (NFT) related. + + + Possible values: **true**, **false**.' lastExpectedDate: type: string description: The date the undelivered goods or services were expected to @@ -519,6 +556,8 @@ components: an amount, the entire transaction amount will be disputed. $ref: '#/components/schemas/Amount' duplicateInfo: + description: Additional information for raising a dispute of `type` **duplicate**. + Required for disputes of `type` **duplicate**. $ref: '#/components/schemas/DuplicateInfo' fraudInfo: description: Additional information for raising a dispute of `type` **fraud**. @@ -550,7 +589,7 @@ components: description: 'The type of the dispute. - Possible values: **notDelivered**, **fraud**.' + Possible values: **notDelivered**, **fraud**, **duplicate**.' $ref: '#/components/schemas/DisputeType' PatchableDisputeRequest: type: object @@ -633,6 +672,14 @@ components: PatchableNotDeliveredInfo: type: object properties: + agreedDeliveryLocation: + maxLength: 2500 + minLength: 0 + type: + - string + - 'null' + description: The delivery location specified by the cardholder. Required + if `deliveredToWrongLocation` is **true**. dateOfCancellation: type: - string @@ -640,12 +687,53 @@ components: description: The date the undelivered goods or services were cancelled in YYYY-MM-DD format. format: date + deliveredToWrongLocation: + type: + - boolean + - 'null' + description: 'Indicates goods were delivered to the wrong location. + + + Possible values: **true**, **false**.' descriptionOfIssue: maxLength: 2500 minLength: 0 type: string description: Your description of the issue for raising a dispute of `type` **notDelivered**. + didCardholderReturn: + type: + - boolean + - 'null' + description: 'Indicates if the cardholder returned the goods to the merchant. + + + Possible values: **true**, **false**.' + isDeliveryLate: + type: + - boolean + - 'null' + description: 'Indicates if the goods or services were delivered late. + + + Possible values: **true**, **false**.' + isMerchantBankrupt: + type: + - boolean + - 'null' + description: 'Indicates if the transaction was processed by a bankrupt merchant. + + + Possible values: **true**, **false**.' + isNonFiatOrNft: + type: + - boolean + - 'null' + description: 'Indicates if the transaction is non-fiat or non-fungible token + (NFT) related. + + + Possible values: **true**, **false**.' lastExpectedDate: type: string description: The date the undelivered goods or services were expected to diff --git a/yaml/TransactionService-v4.yaml b/yaml/TransactionService-v4.yaml index 41903b6..39801ba 100644 --- a/yaml/TransactionService-v4.yaml +++ b/yaml/TransactionService-v4.yaml @@ -30,7 +30,7 @@ info: name: Adyen Developer Experience team url: https://github.com/Adyen/adyen-openapi version: '4' - x-timestamp: '2025-03-21T17:33:58Z' + x-timestamp: '2025-04-03T18:36:11Z' tags: - name: Dispute Attachments - name: Raise Disputes @@ -397,7 +397,7 @@ components: description: 'The type of the dispute. - Possible values: **notDelivered**, **fraud**.' + Possible values: **notDelivered**, **fraud**, **duplicate**.' $ref: '#/components/schemas/DisputeType' DisputeStatus: type: string @@ -465,17 +465,54 @@ components: - whatWasNotDelivered type: object properties: + agreedDeliveryLocation: + maxLength: 2500 + minLength: 0 + type: string + description: The delivery location specified by the cardholder. Required + if `deliveredToWrongLocation` is **true**. dateOfCancellation: type: string description: The date the undelivered goods or services were cancelled in YYYY-MM-DD format. format: date + deliveredToWrongLocation: + type: boolean + description: 'Indicates goods were delivered to the wrong location. + + + Possible values: **true**, **false**.' descriptionOfIssue: maxLength: 2500 minLength: 0 type: string description: Your description of the issue for raising a dispute of `type` **notDelivered**. + didCardholderReturn: + type: boolean + description: 'Indicates if the cardholder returned the goods to the merchant. + + + Possible values: **true**, **false**.' + isDeliveryLate: + type: boolean + description: 'Indicates if the goods or services were delivered late. + + + Possible values: **true**, **false**.' + isMerchantBankrupt: + type: boolean + description: 'Indicates if the transaction was processed by a bankrupt merchant. + + + Possible values: **true**, **false**.' + isNonFiatOrNft: + type: boolean + description: 'Indicates if the transaction is non-fiat or non-fungible token + (NFT) related. + + + Possible values: **true**, **false**.' lastExpectedDate: type: string description: The date the undelivered goods or services were expected to @@ -519,6 +556,8 @@ components: an amount, the entire transaction amount will be disputed. $ref: '#/components/schemas/Amount' duplicateInfo: + description: Additional information for raising a dispute of `type` **duplicate**. + Required for disputes of `type` **duplicate**. $ref: '#/components/schemas/DuplicateInfo' fraudInfo: description: Additional information for raising a dispute of `type` **fraud**. @@ -550,7 +589,7 @@ components: description: 'The type of the dispute. - Possible values: **notDelivered**, **fraud**.' + Possible values: **notDelivered**, **fraud**, **duplicate**.' $ref: '#/components/schemas/DisputeType' PatchableDisputeRequest: type: object @@ -633,6 +672,14 @@ components: PatchableNotDeliveredInfo: type: object properties: + agreedDeliveryLocation: + maxLength: 2500 + minLength: 0 + type: + - string + - 'null' + description: The delivery location specified by the cardholder. Required + if `deliveredToWrongLocation` is **true**. dateOfCancellation: type: - string @@ -640,12 +687,53 @@ components: description: The date the undelivered goods or services were cancelled in YYYY-MM-DD format. format: date + deliveredToWrongLocation: + type: + - boolean + - 'null' + description: 'Indicates goods were delivered to the wrong location. + + + Possible values: **true**, **false**.' descriptionOfIssue: maxLength: 2500 minLength: 0 type: string description: Your description of the issue for raising a dispute of `type` **notDelivered**. + didCardholderReturn: + type: + - boolean + - 'null' + description: 'Indicates if the cardholder returned the goods to the merchant. + + + Possible values: **true**, **false**.' + isDeliveryLate: + type: + - boolean + - 'null' + description: 'Indicates if the goods or services were delivered late. + + + Possible values: **true**, **false**.' + isMerchantBankrupt: + type: + - boolean + - 'null' + description: 'Indicates if the transaction was processed by a bankrupt merchant. + + + Possible values: **true**, **false**.' + isNonFiatOrNft: + type: + - boolean + - 'null' + description: 'Indicates if the transaction is non-fiat or non-fungible token + (NFT) related. + + + Possible values: **true**, **false**.' lastExpectedDate: type: string description: The date the undelivered goods or services were expected to