{"title":"Raise a dispute for cancelled goods or services","category":"default","creationDate":1792071081,"content":"<p>If your cardholder has a dispute based on cancelled goods or services, and they made efforts to contact the merchant responsible for providing those goods or services without resolution, they can ask you to raise a dispute on their behalf.<\/p>\n<p>Before you raise a dispute on behalf of a cardholder, make sure the merchant has not already provided a refund for the disputed transaction.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the requirements, limitations, and preparations described under <a href=\"\/issuing\/raise-disputes#requirements\">Raise disputes<\/a>.<\/p>\n<h2>1. Raise a cancelled dispute<\/h2>\n<ol>\n<li>\n<p>Find the transaction ID for which you want to raise the dispute.<br \/>\nYou can find a transaction ID in one of the following locations:<\/p>\n<ul>\n<li>within the <a href=\"\/issuing\/report-types\/balance-platform-accounting-report\">Balance Platform Accounting Report<\/a><\/li>\n<li>from the <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a><\/li>\n<li>from  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/overview\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Transfer webhooks<\/a><\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/disputes<\/a> request, specifying the following parameters:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: left;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes#request-description\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">description<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Your reference for the dispute. The description appears in dispute webhooks for your information. Do not include any personally-identifiable information (PII) in this field. Maximum length: 50 characters.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes#request-disputedAmount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">disputedAmount<\/a><\/td>\n<td style=\"text-align: left;\">object<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The amount for which you dispute the transaction. The disputed amount cannot be greater than the transaction amount. If you do not provide an amount, the entire transaction amount will be disputed.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes#request-disputedAmount-currency\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">disputedAmount.currency<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The three-character <a href=\"\/development-resources\/currency-codes\">ISO currency code<\/a>. Required if the <code>disputedAmount<\/code> object is included with the dispute.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes#request-disputedAmount-value\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">disputedAmount.value<\/a><\/td>\n<td style=\"text-align: left;\">integer<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The amount of the transaction, <a href=\"\/development-resources\/currency-codes\">in minor units<\/a>. Required if the <code>disputedAmount<\/code> object is included with the dispute.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo<\/code><\/td>\n<td style=\"text-align: left;\">object<\/td>\n<td style=\"text-align: left;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The object containing additional information for raising a dispute of <code>type<\/code> <span translate=\"no\"><strong>cancelled<\/strong>.<\/span> Required for disputes of <code>type<\/code> <span translate=\"no\"><strong>cancelled<\/strong>.<\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.attemptedToReturn<\/code><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Indicates if the cardholder attempted to return the merchandise but was unable to.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>true<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>false<\/strong><\/span><\/li><\/ul><\/br>Required if the value of <code>didCardholderReturn<\/code> is <span translate=\"no\"><strong>false<\/strong><\/span>.<\/br><\/br>If the value of this parameter is <span translate=\"no\"><strong>true<\/strong><\/span>, provide information in <code>descriptionOfIssue<\/code> about how the cardholder attempted to return the goods, and what they did with the goods (for example, destroyed them).<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.certificationGuaranteedReservation<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The certification code for the guaranteed reservation.<\/br><\/br>Required if the value of <code>serviceType<\/code> is <span translate=\"no\"><strong>G<\/strong><\/span> (a guaranteed reservation).<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>GR<\/strong><\/span>: The cardholder properly cancelled the guaranteed reservation.<\/li><li markdown=\"1\"><span translate=\"no\"><strong>RC<\/strong><\/span>: The cardholder attempted to cancel within 24 hours of delivery of the reservation confirmation.<\/li><li markdown=\"1\"><span translate=\"no\"><strong>AR<\/strong><\/span>: The merchant billed a \"no-show transaction\" for more than one day's accommodation or rental.<\/li>&lt;\/ul<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.dateOfAttemptedReturn<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, when the cardholder attempted to return the goods they purchased.<\/br><\/br>Required when the value of <code>attemptedToReturn<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.dateOfCancellation<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, when the purchase was cancelled.<\/br><\/br>Required if the value of <code>certificationGuaranteedReservation<\/code> is <span translate=\"no\"><strong>GR<\/strong><\/span> or <span translate=\"no\"><strong>RC<\/strong><\/span>, or if the cardholder cancelled the purchase before shipment.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.dateOfReturn<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, that the cardholder shipped or handed back the merchandise.<\/br><\/br>Required if the value of <code>didCardholderReturn<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.dateOfService<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, that the service was scheduled to take place.<\/br><\/br>Required if the value of <code>serviceType<\/code> is <span translate=\"no\"><strong>O<\/strong><\/span> (other), or <span translate=\"no\"><strong>G<\/strong><\/span> (guaranteed reservation).<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.dateReturnReceived<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, that the merchant received the returned merchandise.<\/br><\/br>Required if the value of <code>didCardholderReturn<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.descriptionOfIssue<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Your description of the issue for raising a dispute of <code>type<\/code> <span translate=\"no\"><strong>cancelled<\/strong><\/span>. Make sure the cardholder provides information that covers the following:<ul><li markdown=\"1\">A description of the goods or services purchased, and why they are cancelling the purchase.<\/li><li markdown=\"1\">If the goods or services were cancelled before shipment: A description of how the cardholder attempted to cancel the goods or services.<\/li><li markdown=\"1\">If the cardholder attempted to return the goods: A description of how the cardholder attempted to return the goods, and what they did with the goods (for example, destroyed them).<\/li><li markdown=\"1\">If the cardholder attempted to return the goods in a way other than through direct return shipment or face-to-face return at a merchant, how they attempted to return the goods.<\/li><\/ul><\/br><\/br>Maximum length: 2500 characters<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.didCardholderCancelBeforeShipment<\/code><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Indicates if the cardholder cancelled the purchase before the goods were shipped.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>true<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>false<\/strong><\/span><\/li><\/ul><\/br>If the value of this parameter is <span translate=\"no\"><strong>true<\/strong><\/span>, provide information in <code>descriptionOfIssue<\/code> about how the cardholder attempted to cancel the goods or services.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.didCardholderReceiveGoods<\/code><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Indicates if the cardholder received the merchandise.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>true<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>false<\/strong><\/span><\/li><\/ul><\/br>Required if the value of <code>goodsOrServices<\/code> is <span translate=\"no\"><strong>goods<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.didCardholderReturn<\/code><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">Indicates if the cardholder returned the merchandise to the merchant.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>true<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>false<\/strong><\/span><\/li><\/ul><\/br>Required if the value of <code>didCardholderReceiveGoods<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.goodsOrServices<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The type of purchase being disputed.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>goods<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>services<\/strong><\/span><\/li><\/ul>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.lastExpectedDate<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, that the merchant promised delivery.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.merchantRefuseAdvise<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The reason the merchant gave for refusing the return.<\/br><\/br>Required if the value of <code>attemptedToReturn<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>MRRA<\/strong><\/span>: The merchant refused to provide return authorization.<\/li><li markdown=\"1\"><span translate=\"no\"><strong>MRRM<\/strong><\/span>: The merchant refused to accept returned merchandise.<\/li><li markdown=\"1\"><span translate=\"no\"><strong>MICNRM<\/strong><\/span>: The merchant informed cardholder not to return the merchandise.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.returnMethod<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The method used to return the merchandise. <\/br><\/br>Required if the value of <code>didCardholderReturn<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>FF<\/strong><\/span>: Face to face<\/li><li markdown=\"1\"><span translate=\"no\"><strong>FE<\/strong><\/span>: FedEx<\/li><li markdown=\"1\"><span translate=\"no\"><strong>D<\/strong><\/span>: DHL<\/li><li markdown=\"1\"><span translate=\"no\"><strong>U<\/strong><\/span>: UPS<\/li><li markdown=\"1\"><span translate=\"no\"><strong>P<\/strong><\/span>: Postal Service<\/li><li markdown=\"1\"><span translate=\"no\"><strong>O<\/strong><\/span>: Other<\/li><\/ul><\/br><\/br>If the value of this parameter is <span translate=\"no\"><strong>O<\/strong><\/span> (Other), or if the cardholder attempted a return but did not complete it, provide information in <code>descriptionOfIssue<\/code> about how the cardholder attempted to return the goods or services.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.serviceType<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The type of service purchased.<\/br><\/br>Required if the value of <code>goodsOrServices<\/code> is <span translate=\"no\"><strong>services<\/strong><\/span>.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>T<\/strong><\/span>: timeshare<\/li><li markdown=\"1\"><span translate=\"no\"><strong>G<\/strong><\/span>: guaranteed reservation (for example, a hotel or a car rental booking)<\/li><li markdown=\"1\"><span translate=\"no\"><strong>O<\/strong><\/span>: any other type of service.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.shippingTrackingNumber<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The tracking number for the shipment used to return the merchandise.<\/br><\/br>Maximum length: 50.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.timeshareDate<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, associated with the timeshare purchase.<\/br><\/br>Required if the value of <code>serviceType<\/code> is <span translate=\"no\"><strong>T<\/strong> (timeshare).<\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.whoCancelled<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">The party that initiated the cancellation of the purchase.<\/br><\/br>Required if the value of <code>serviceType<\/code> is <span translate=\"no\"><strong>G<\/strong><\/span> (a guaranteed reservation), the cardholder did not receive the goods, or the cardholder cancelled before shipment.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>cardholder<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>merchant<\/strong><\/span><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes#request-transactionId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">transactionId<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The unique reference of the transaction for which you are raising the dispute.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes#request-type\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">type<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The type of the dispute. When raising a dispute for cancelled goods or services, the value must be <span translate=\"no\"><strong>cancelled<\/strong><\/span>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Raise a dispute for cancelled goods or services'\" :id=\"'raise-cancelled-dispute-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/balanceplatform-api-test.adyen.com\\\/btl\\\/api\\\/v4\\\/disputes \\\\\\n-H 'x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST  \\\\\\n-d '{\\n      \\&quot;description\\&quot;: \\&quot;MyCompanyReference-123-545765-0789\\&quot;,\\n      \\&quot;type\\&quot;: \\&quot;cancelled\\&quot;,\\n      \\&quot;transactionId\\&quot;: \\&quot;UYHR22POX788923I8OP3UYH4N7851USD\\&quot;,\\n      \\&quot;disputedAmount\\&quot;: {\\n         \\&quot;currency\\&quot;: \\&quot;USD\\&quot;,\\n         \\&quot;value\\&quot;: 8500\\n      },\\n   \\&quot;cancelledInfo\\&quot;: {\\n        \\&quot;didAttemptToResolve\\&quot;: true,\\n        \\&quot;didCardholderCancelBeforeShipment\\&quot;: false,\\n        \\&quot;didCardholderReceiveGoods\\&quot;: false,\\n        \\&quot;dateOfCancellation\\&quot;: \\&quot;2025-06-28\\&quot;,\\n        \\&quot;descriptionOfIssue\\&quot;: \\&quot;Widget never arrived. Ordered on March 14. Waited for three weeks, contacted Widgets Inc who told me product was on the way, but gave me no shipment tracking number. It has been more than 3 months since I ordered my widget, and I want my money back. Including a copy of my email communication with Widgets Inc\\&quot;,\\n        \\&quot;lastExpectedDate\\&quot;: \\&quot;2025-04-29\\&quot;,\\n        \\&quot;whoCancelled\\&quot;: \\&quot;cardholder\\&quot;,\\n        \\&quot;goodsOrServices\\&quot;: \\&quot;goods\\&quot;\\n   }\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>Make a note of the dispute  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes#responses-200-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a> in the response. You need this ID to <a href=\"\/issuing\/raise-disputes\/attach-supporting-information\">provide supporting information<\/a> as an attachment, update the dispute, submit the dispute for cancelled goods or services, close the dispute, or follow the lifecycle of the dispute.<\/p>\n<p>The response includes the following additional parameters:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes#responses-200-arn\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">arn<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The unique <span translate=\"no\">Acquirer Reference Number (arn)<\/span> generated by the card scheme for each capture. You can use the <code>arn<\/code> to trace the transaction through its lifecycle.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes#responses-200-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The unique identifier of the raised dispute.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes#responses-200-status\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">status<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The current status of the dispute. You can update a dispute to <span translate=\"no\"><strong>submitted<\/strong><\/span> or <span translate=\"no\"><strong>closed<\/strong><\/span>. Possible values: <span translate=\"no\"><strong>draft<\/strong><\/span>, <span translate=\"no\"><strong>submitted<\/strong><\/span>, <span translate=\"no\"><strong>closed<\/strong><\/span>, <span translate=\"no\"><strong>won<\/strong><\/span>, <span translate=\"no\"><strong>chargeback<\/strong><\/span>, <span translate=\"no\"><strong>secondPresentment<\/strong><\/span>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Response'\" :id=\"'raise-cancelled-dispute-response'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"id\\\": \\\"7GHL2L64T8OH8898\\\",\\n   \\\"transactionId\\\": \\\"UYHR22POX788923I8OP3UYH4N7851USD\\\",\\n   \\\"description\\\": \\\"MyCompanyReference-123-545765-0789\\\",\\n   \\\"disputedAmount\\\": {\\n      \\\"currency\\\": \\\"USD\\\",\\n      \\\"value\\\": 8500\\n   },\\n   \\\"type\\\": \\\"cancelled\\\",\\n   \\\"cancelledInfo\\\": {\\n      \\\"didAttemptToResolve\\\": true,\\n      \\\"didCardholderCancelBeforeShipment\\\": false,\\n      \\\"didCardholderReceiveGoods\\\": false,\\n      \\\"dateOfCancellation\\\": \\\"2025-06-28\\\",\\n      \\\"descriptionOfIssue\\\": \\\"Widget never arrived. Ordered on March 14. Waited for three weeks, contacted Widgets Inc who told me product was on the way, but gave me no shipment tracking number. It has been more than 3 months since I ordered my widget, and I want my money back. Including a copy of my email communication with Widgets Inc\\\",\\n      \\\"lastExpectedDate\\\": \\\"2025-04-29\\\",\\n      \\\"whoCancelled\\\": \\\"cardholder\\\",\\n      \\\"goodsOrServices\\\": \\\"goods\\\"\\n   },\\n   \\\"status\\\": \\\"draft\\\",\\n   \\\"arn\\\": \\\"798875902969802007772019\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>Adyen sends a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/dispute-webhooks\/latest\/post\/balancePlatform.dispute.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.dispute.created<\/a> webhook to your server for the dispute with a status of <span translate=\"no\"><strong>draft<\/strong><\/span>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Dispute webhook for a cancelled dispute'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"data\\\": {\\n    \\\"balancePlatform\\\": \\\"MyBalancePlatform\\\",\\n    \\\"id\\\": \\\"7GHL2L64T8OH8898\\\",\\n    \\\"description\\\": \\\"MyCompanyReference-123-545765-0789\\\",\\n    \\\"disputedAmount\\\": {\\n      \\\"currency\\\": \\\"USD\\\",\\n      \\\"value\\\": 8500\\n    },\\n    \\\"type\\\": \\\"cancelled\\\",\\n    \\\"transactionId\\\": \\\"UYHR22POX788923I8OP3UYH4N7851USD\\\",\\n    \\\"status\\\": \\\"draft\\\",\\n    \\\"arn\\\": \\\"798875902969802007772019\\\"\\n  },\\n  \\\"environment\\\": \\\"test\\\",\\n  \\\"type\\\": \\\"balancePlatform.dispute.created\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<h2>2. Upload attachments (optional)<\/h2>\n<p>We recommend that your cardholder upload supporting documentation, such as receipts, communication with a merchant, or any additional documents that would help the card scheme when they are reviewing the dispute.<\/p>\n<p>When you present the screen to cardholders to upload attachments, make sure they know which file types we support (JPEG, PDF, TIFF).<\/p>\n<ol>\n<li>\n<p>Base64-encode any attachments the cardholder provides for upload with their dispute.<\/p>\n<\/li>\n<li>\n<p>Make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes\/(disputeId)\/attachments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/disputes\/{disputeId}\/attachments<\/a> request, specifying the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes\/(disputeId)\/attachments#path-disputeId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">disputeId<\/a> as a path parameter and the following request parameters.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter name<\/th>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes\/(disputeId)\/attachments#request-attachmentType\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">attachmentType<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The type of information contained in the attachment.<br\/>Possible values:<ul><li markdown=\"1\"><span translate=\"no\"><strong>receipt<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>correspondence<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>other<\/strong><\/span><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes\/(disputeId)\/attachments#request-fileName\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">fileName<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The name of the attachment, including its filename extension. Minimum length: four characters, Maximum length: 17 characters, including the extension type.<br\/>Supported filename extensions:<ul><li markdown=\"1\"><span translate=\"no\"><strong>jpeg<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>pdf<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>tiff<\/strong><\/span><\/li><\/ul>Examples:<ul><li markdown=\"1\"><span translate=\"no\"><strong>airfare24_03.jpeg<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>hotel24_0315.jpeg<\/strong><\/span><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes\/(disputeId)\/attachments#request-content\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">content<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The content of the image. An attachment must be Base64-encoded data, with a maximum file size of 2 MB.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Upload an attachment as supporting information for a dispute'\" :id=\"'upload-cancelled-supporting-info-attachment-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/balanceplatform-api-test.adyen.com\\\/btl\\\/api\\\/v4\\\/disputes\\\/7GHL2L64T8OH8898\\\/attachments \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-H 'x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY' \\\\\\n-X POST \\\\\\n-d '{\\n      \\&quot;fileName\\&quot; : \\&quot;email-06-23.pdf\\&quot;,\\n      \\&quot;attachmentType\\&quot; : \\&quot;correspondence\\&quot;,\\n      \\&quot;content\\&quot;: \\&quot;PLETALi0xHjQMJcOkw7zDts...OfCjIgUTH+f\\\/ub0jyhPRX+Zuuutr==\\&quot;\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>In the response, note the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes\/(disputeId)\/attachments#responses-200-attachmentId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">attachmentId<\/a>. You need the ID if you want to later <a href=\"\/issuing\/raise-disputes\/attach-supporting-information#get-an-attachment\">get the attachment<\/a>, or <a href=\"\/issuing\/raise-disputes\/attach-supporting-information#delete-an-attachment\">delete the attachment<\/a>.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter name<\/th>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/post\/disputes\/(disputeId)\/attachments#responses-200-attachmentId\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">attachmentId<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The unique identifier of the attachment.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Response'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"attachmentId\\\": \\\"TXAT42225223223N5LNW5PC9S62DSH\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<h2>3. Review the dispute<\/h2>\n<p>You should allow your cardholder to review their dispute. This allows the cardholder time to make sure they have captured all information correctly. The cardholder can then confirm they want you to submit the dispute to the card scheme on their behalf, or decide to make edits to their dispute.<\/p>\n<ol>\n<li>\n<p>Make a <code>GET \/disputes\/{id}<\/code> request, specifying the dispute <code>id<\/code> as a request parameter.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Get a dispute by id'\" :id=\"'get-cancelled-dispute-by-id-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/balanceplatform-api-test.adyen.com\\\/btl\\\/api\\\/v4\\\/disputes\\\/7GHL2L64T8OH8898 \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-H 'x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY' \\\\\\n-X GET&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>Present the details of the dispute to your cardholder.<\/p>\n<\/li>\n<\/ol>\n<h2>4. Edit dispute details (optional)<\/h2>\n<p>If the cardholder wants to make any changes to the information they provided in their dispute, you can make a request to update the dispute.<\/p>\n<ol>\n<li>\n<p>To update information in your dispute, make a PATCH  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/patch\/disputes\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/disputes\/{id}<\/a> request, specifying the dispute  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/patch\/disputes\/(id)#path-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a> as a path parameter, and supplying updated information in the following request parameters:<\/p>\n<p>You do not have to provide the complete dispute object in your PATCH request.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo<\/code><\/td>\n<td style=\"text-align: left;\">object<\/td>\n<td style=\"text-align: left;\">The object containing additional information for raising a dispute of <code>type<\/code> <span translate=\"no\"><strong>cancelled<\/strong>.<\/span> Required for disputes of <code>type<\/code> <span translate=\"no\"><strong>cancelled<\/strong>.<\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.attemptedToReturn<\/code><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\">Indicates if the cardholder attempted to return the merchandise but was unable to.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>true<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>false<\/strong><\/span><\/li><\/ul><\/br>Required if the value of <code>didCardholderReturn<\/code> is <span translate=\"no\"><strong>false<\/strong><\/span>.<\/br><\/br>If the value of this parameter is <span translate=\"no\"><strong>true<\/strong><\/span>, provide information in <code>descriptionOfIssue<\/code> about how the cardholder attempted to return the goods, and what they did with the goods (for example, destroyed them).<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.certificationGuaranteedReservation<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The certification code for the guaranteed reservation.<\/br><\/br>Required if the value of <code>serviceType<\/code> is <span translate=\"no\"><strong>G<\/strong><\/span> (a guaranteed reservation).<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>GR<\/strong><\/span>: The cardholder properly cancelled the guaranteed reservation.<\/li><li markdown=\"1\"><span translate=\"no\"><strong>RC<\/strong><\/span>: The cardholder attempted to cancel within 24 hours of delivery of the reservation confirmation.<\/li><li markdown=\"1\"><span translate=\"no\"><strong>AR<\/strong><\/span>: The merchant billed a \"no-show transaction\" for more than one day's accommodation or rental.<\/li>&lt;\/ul<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.dateOfAttemptedReturn<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, when the cardholder attempted to return the goods they purchased.<\/br><\/br>Required when the value of <code>attemptedToReturn<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.dateOfCancellation<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, when the purchase was cancelled.<\/br><\/br>Required if the value of <code>certificationGuaranteedReservation<\/code> is <span translate=\"no\"><strong>GR<\/strong><\/span> or <span translate=\"no\"><strong>RC<\/strong><\/span>, or if the cardholder cancelled the purchase before shipment.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.dateOfReturn<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, that the cardholder shipped or handed back the merchandise.<\/br><\/br>Required if the value of <code>didCardholderReturn<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.dateOfService<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, that the service was scheduled to take place.<\/br><\/br>Required if the value of <code>serviceType<\/code> is <span translate=\"no\"><strong>O<\/strong><\/span> (other), or <span translate=\"no\"><strong>G<\/strong><\/span> (guaranteed reservation).<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.dateReturnReceived<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, that the merchant received the returned merchandise.<\/br><\/br>Required if the value of <code>didCardholderReturn<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.descriptionOfIssue<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">Your description of the issue for raising a dispute of <code>type<\/code> <span translate=\"no\"><strong>cancelled<\/strong><\/span>. Make sure the cardholder provides information that covers the following:<ul><li markdown=\"1\">A description of the goods or services purchased, and why they are cancelling the purchase.<\/li><li markdown=\"1\">If the goods or services were cancelled before shipment: A description of how the cardholder attempted to cancel the goods or services.<\/li><li markdown=\"1\">If the cardholder attempted to return the goods: A description of how the cardholder attempted to return the goods, and what they did with the goods (for example, destroyed them).<\/li><li markdown=\"1\">If the cardholder attempted to return the goods in a way other than through direct return shipment or face-to-face return at a merchant, how they attempted to return the goods.<\/li><\/ul><\/br><\/br>Maximum length: 2500 characters<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.didCardholderCancelBeforeShipment<\/code><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\">Indicates if the cardholder cancelled the purchase before the goods were shipped.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>true<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>false<\/strong><\/span><\/li><\/ul><\/br>If the value of this parameter is <span translate=\"no\"><strong>true<\/strong><\/span>, provide information in <code>descriptionOfIssue<\/code> about how the cardholder attempted to cancel the goods or services.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.didCardholderReceiveGoods<\/code><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\">Indicates if the cardholder received the merchandise.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>true<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>false<\/strong><\/span><\/li><\/ul><\/br>Required if the value of <code>goodsOrServices<\/code> is <span translate=\"no\"><strong>goods<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.didCardholderReturn<\/code><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\">Indicates if the cardholder returned the merchandise to the merchant.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>true<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>false<\/strong><\/span><\/li><\/ul><\/br>Required if the value of <code>didCardholderReceiveGoods<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.goodsOrServices<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The type of purchase being disputed.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>goods<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>services<\/strong><\/span><\/li><\/ul>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.lastExpectedDate<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, that the merchant promised delivery.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.merchantRefuseAdvise<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The reason the merchant gave for refusing the return.<\/br><\/br>Required if the value of <code>attemptedToReturn<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>MRRA<\/strong><\/span>: The merchant refused to provide return authorization.<\/li><li markdown=\"1\"><span translate=\"no\"><strong>MRRM<\/strong><\/span>: The merchant refused to accept returned merchandise.<\/li><li markdown=\"1\"><span translate=\"no\"><strong>MICNRM<\/strong><\/span>: The merchant informed cardholder not to return the merchandise.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.returnMethod<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The method used to return the merchandise. <\/br><\/br>Required if the value of <code>didCardholderReturn<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>FF<\/strong><\/span>: Face to face<\/li><li markdown=\"1\"><span translate=\"no\"><strong>FE<\/strong><\/span>: FedEx<\/li><li markdown=\"1\"><span translate=\"no\"><strong>D<\/strong><\/span>: DHL<\/li><li markdown=\"1\"><span translate=\"no\"><strong>U<\/strong><\/span>: UPS<\/li><li markdown=\"1\"><span translate=\"no\"><strong>P<\/strong><\/span>: Postal Service<\/li><li markdown=\"1\"><span translate=\"no\"><strong>O<\/strong><\/span>: Other<\/li><\/ul><\/br><\/br>If the value of this parameter is <span translate=\"no\"><strong>O<\/strong><\/span> (Other), or if the cardholder attempted a return but did not complete it, provide information in <code>descriptionOfIssue<\/code> about how the cardholder attempted to return the goods or services.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.serviceType<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The type of service purchased.<\/br><\/br>Required if the value of <code>goodsOrServices<\/code> is <span translate=\"no\"><strong>services<\/strong><\/span>.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>T<\/strong><\/span>: timeshare<\/li><li markdown=\"1\"><span translate=\"no\"><strong>G<\/strong><\/span>: guaranteed reservation (for example, a hotel or a car rental booking)<\/li><li markdown=\"1\"><span translate=\"no\"><strong>O<\/strong><\/span>: any other type of service.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.shippingTrackingNumber<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The tracking number for the shipment used to return the merchandise.<\/br><\/br>Maximum length: 50.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.timeshareDate<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The date, in <span translate=\"no\"><strong>YYYY-MM-DD<\/strong><\/span> format, associated with the timeshare purchase.<\/br><\/br>Required if the value of <code>serviceType<\/code> is <span translate=\"no\"><strong>T<\/strong><\/span> (timeshare).<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>cancelledInfo.whoCancelled<\/code><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The party that initiated the cancellation of the purchase.<\/br><\/br>Required if the value of <code>serviceType<\/code> is <span translate=\"no\"><strong>G<\/strong><\/span> (a guaranteed reservation), the cardholder did not receive the goods, or the cardholder cancelled before shipment.<\/br><\/br>Possible values: <ul><li markdown=\"1\"><span translate=\"no\"><strong>cardholder<\/strong><\/span><\/li><li markdown=\"1\"><span translate=\"no\"><strong>merchant<\/strong><\/span><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/patch\/disputes\/(id)#request-status\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">status<\/a><\/td>\n<td style=\"text-align: left;\">string<\/td>\n<td style=\"text-align: left;\">The status of the dispute. You can update the status of a raised dispute from <span translate=\"no\"><strong>draft<\/strong><\/span> to <span translate=\"no\"><strong>submitted<\/strong><\/span> or <span translate=\"no\"><strong>closed<\/strong><\/span>. Possible values: <span translate=\"no\"><strong>submitted<\/strong><\/span>, <span translate=\"no\"><strong>closed<\/strong><\/span>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<li>\n<p>Present the updated dispute details from the response to your cardholder.<\/p>\n<\/li>\n<\/ol>\n<h2>5. Submit the dispute<\/h2>\n<p>If your cardholder is satisfied with the information they provided for the dispute, they can confirm they want you to submit the dispute to the card scheme for review and a chargeback, if successful.<\/p>\n<p>When you submit a dispute to the card scheme, you can no longer update the dispute, upload or delete attachments, or close the dispute.<\/p>\n<ol>\n<li>\n<p>Make a PATCH  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/patch\/disputes\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/disputes\/{id}<\/a> request, specifying the dispute  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/patch\/disputes\/(id)#path-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a> as a path parameter, and include  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfers-api\/latest\/patch\/disputes\/(id)#request-status\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">status<\/a> with a value of <span translate=\"no\"><strong>submitted<\/strong><\/span> as a request parameter.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Submit a dispute'\" :id=\"'submit-cancelled-dispute-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/balanceplatform-api-test.adyen.com\\\/btl\\\/api\\\/v4\\\/disputes\\\/7GHL2L64T8OH8898 \\\\\\n-H 'x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X PATCH  \\\\\\n-d '{\\n       \\&quot;status\\&quot;: \\&quot;submitted\\&quot;\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>A successful response includes the dispute object, with an updated status of <span translate=\"no\"><strong>submitted<\/strong><\/span>. Adyen also sends your system a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/dispute-webhooks\/latest\/post\/balancePlatform.dispute.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.dispute.updated<\/a> webhook with the updated status.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Dispute webhook with a status of submitted'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"data\\\": {\\n    \\\"balancePlatform\\\": \\\"MyBalancePlatform\\\",\\n    \\\"id\\\": \\\"7GHL2L64T8OH8898\\\",\\n    \\\"description\\\": \\\"MyCompanyReference-123-545765-0789\\\",\\n    \\\"disputedAmount\\\": {\\n      \\\"currency\\\": \\\"USD\\\",\\n      \\\"value\\\": 8500\\n    },\\n    \\\"type\\\": \\\"cancelled\\\",\\n    \\\"transactionId\\\": \\\"UYHR22POX788923I8OP3UYH4N7851USD\\\",\\n    \\\"status\\\": \\\"submitted\\\",\\n    \\\"arn\\\": \\\"86749234782647283947122\\\"\\n  },\\n  \\\"environment\\\": \\\"test\\\",\\n  \\\"type\\\": \\\"balancePlatform.dispute.updated\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>Notify the cardholder that their dispute has been submitted.<\/p>\n<\/li>\n<\/ol>\n<h2>6. Process webhooks for status changes<\/h2>\n<ol>\n<li>\n<p>Process  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/dispute-webhooks\/latest\/post\/balancePlatform.dispute.updated\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.dispute.updated<\/a> webhooks, looking for changes in the status of your raised dispute.<\/p>\n<\/li>\n<li>\n<p>If the <code>status<\/code> of a dispute changes to <span translate=\"no\"><strong>chargeback<\/strong><\/span> or <span translate=\"no\"><strong>secondPresentment<\/strong><\/span>, inspect  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/transfer-webhooks\/latest\/post\/balancePlatform.transfer.created\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">balancePlatform.transfer.created<\/a> webhooks for the matching Acquirer Reference Number (arn), and reconcile balances for the cardholder's balance account.<\/p>\n<ul>\n<li><a href=\"\/issuing\/raise-disputes#lifecycle-of-a-raised-dispute\">Lifecycle of a raised dispute<\/a> describes in more detail how status changes for disputes are communicated to your system through Adyen webhooks, and how balance mutations are recorded in the Balance Platform Accounting Report.<\/li>\n<li><a href=\"\/issuing\/raise-disputes#associating-ids-throughout-the-dispute-lifecycle\">Associating IDs throughout the dispute lifecycle<\/a> describes the various IDs you should refer to when correlating original transactions, acquirer reference numbers, and dispute IDs to your raised disputes.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/issuing\/raise-disputes#lifecycle-of-a-raised-dispute\"\n                        target=\"_self\"\n                        >\n                    Lifecycle of a raised dispute\n                <\/a><\/li><li><a href=\"\/issuing\/raise-disputes#associating-ids-throughout-the-dispute-lifecycle\"\n                        target=\"_self\"\n                        >\n                    Associating IDs throughout the dispute lifecycle\n                <\/a><\/li><li><a href=\"\/issuing\/raise-disputes\/manage-disputes\"\n                        target=\"_self\"\n                        >\n                    Manage disputes\n                <\/a><\/li><li><a href=\"\/issuing\/raise-disputes\/attach-supporting-information\"\n                        target=\"_self\"\n                        >\n                    Upload and manage attachments\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/issuing\/raise-disputes\/cancelled","articleFields":{"description":"Learn how to raise disputes for purchased goods or services that have been cancelled by either the cardholder, or the merchant.","parameters":{"directoryPath":"\/issuing"},"feedback_component":true,"filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/issuing\/raise-disputes\/cancelled","title":"Raise a dispute for cancelled goods or services","content":"If your cardholder has a dispute based on cancelled goods or services, and they made efforts to contact the merchant responsible for providing those goods or services without resolution, they can ask you to raise a dispute on their behalf.\nBefore you raise a dispute on behalf of a cardholder, make sure the merchant has not already provided a refund for the disputed transaction.\nRequirements\nBefore you begin, take into account the requirements, limitations, and preparations described under Raise disputes.\n1. Raise a cancelled dispute\n\n\nFind the transaction ID for which you want to raise the dispute.\nYou can find a transaction ID in one of the following locations:\n\nwithin the Balance Platform Accounting Report\nfrom the Customer Area\nfrom  Transfer webhooks\n\n\n\nMake a POST  \/disputes request, specifying the following parameters:\n\n\n\nParameter\nType\nRequired\nDescription\n\n\n\n\n description\nstring\n\nYour reference for the dispute. The description appears in dispute webhooks for your information. Do not include any personally-identifiable information (PII) in this field. Maximum length: 50 characters.\n\n\n disputedAmount\nobject\n\nThe amount for which you dispute the transaction. The disputed amount cannot be greater than the transaction amount. If you do not provide an amount, the entire transaction amount will be disputed.\n\n\n disputedAmount.currency\nstring\n\nThe three-character ISO currency code. Required if the disputedAmount object is included with the dispute.\n\n\n disputedAmount.value\ninteger\n\nThe amount of the transaction, in minor units. Required if the disputedAmount object is included with the dispute.\n\n\ncancelledInfo\nobject\n\nThe object containing additional information for raising a dispute of type cancelled. Required for disputes of type cancelled.\n\n\ncancelledInfo.attemptedToReturn\nboolean\n\nIndicates if the cardholder attempted to return the merchandise but was unable to.Possible values: truefalseRequired if the value of didCardholderReturn is false.If the value of this parameter is true, provide information in descriptionOfIssue about how the cardholder attempted to return the goods, and what they did with the goods (for example, destroyed them).\n\n\ncancelledInfo.certificationGuaranteedReservation\nstring\n\nThe certification code for the guaranteed reservation.Required if the value of serviceType is G (a guaranteed reservation).Possible values: GR: The cardholder properly cancelled the guaranteed reservation.RC: The cardholder attempted to cancel within 24 hours of delivery of the reservation confirmation.AR: The merchant billed a \"no-show transaction\" for more than one day's accommodation or rental.&lt;\/ul\n\n\ncancelledInfo.dateOfAttemptedReturn\nstring\n\nThe date, in YYYY-MM-DD format, when the cardholder attempted to return the goods they purchased.Required when the value of attemptedToReturn is true.\n\n\ncancelledInfo.dateOfCancellation\nstring\n\nThe date, in YYYY-MM-DD format, when the purchase was cancelled.Required if the value of certificationGuaranteedReservation is GR or RC, or if the cardholder cancelled the purchase before shipment.\n\n\ncancelledInfo.dateOfReturn\nstring\n\nThe date, in YYYY-MM-DD format, that the cardholder shipped or handed back the merchandise.Required if the value of didCardholderReturn is true.\n\n\ncancelledInfo.dateOfService\nstring\n\nThe date, in YYYY-MM-DD format, that the service was scheduled to take place.Required if the value of serviceType is O (other), or G (guaranteed reservation).\n\n\ncancelledInfo.dateReturnReceived\nstring\n\nThe date, in YYYY-MM-DD format, that the merchant received the returned merchandise.Required if the value of didCardholderReturn is true.\n\n\ncancelledInfo.descriptionOfIssue\nstring\n\nYour description of the issue for raising a dispute of type cancelled. Make sure the cardholder provides information that covers the following:A description of the goods or services purchased, and why they are cancelling the purchase.If the goods or services were cancelled before shipment: A description of how the cardholder attempted to cancel the goods or services.If the cardholder attempted to return the goods: A description of how the cardholder attempted to return the goods, and what they did with the goods (for example, destroyed them).If the cardholder attempted to return the goods in a way other than through direct return shipment or face-to-face return at a merchant, how they attempted to return the goods.Maximum length: 2500 characters\n\n\ncancelledInfo.didCardholderCancelBeforeShipment\nboolean\n\nIndicates if the cardholder cancelled the purchase before the goods were shipped.Possible values: truefalseIf the value of this parameter is true, provide information in descriptionOfIssue about how the cardholder attempted to cancel the goods or services.\n\n\ncancelledInfo.didCardholderReceiveGoods\nboolean\n\nIndicates if the cardholder received the merchandise.Possible values: truefalseRequired if the value of goodsOrServices is goods.\n\n\ncancelledInfo.didCardholderReturn\nboolean\n\nIndicates if the cardholder returned the merchandise to the merchant.Possible values: truefalseRequired if the value of didCardholderReceiveGoods is true.\n\n\ncancelledInfo.goodsOrServices\nstring\n\nThe type of purchase being disputed.Possible values: goodsservices.\n\n\ncancelledInfo.lastExpectedDate\nstring\n\nThe date, in YYYY-MM-DD format, that the merchant promised delivery.\n\n\ncancelledInfo.merchantRefuseAdvise\nstring\n\nThe reason the merchant gave for refusing the return.Required if the value of attemptedToReturn is true.Possible values: MRRA: The merchant refused to provide return authorization.MRRM: The merchant refused to accept returned merchandise.MICNRM: The merchant informed cardholder not to return the merchandise.\n\n\ncancelledInfo.returnMethod\nstring\n\nThe method used to return the merchandise. Required if the value of didCardholderReturn is true.Possible values: FF: Face to faceFE: FedExD: DHLU: UPSP: Postal ServiceO: OtherIf the value of this parameter is O (Other), or if the cardholder attempted a return but did not complete it, provide information in descriptionOfIssue about how the cardholder attempted to return the goods or services.\n\n\ncancelledInfo.serviceType\nstring\n\nThe type of service purchased.Required if the value of goodsOrServices is services.Possible values: T: timeshareG: guaranteed reservation (for example, a hotel or a car rental booking)O: any other type of service.\n\n\ncancelledInfo.shippingTrackingNumber\nstring\n\nThe tracking number for the shipment used to return the merchandise.Maximum length: 50.\n\n\ncancelledInfo.timeshareDate\nstring\n\nThe date, in YYYY-MM-DD format, associated with the timeshare purchase.Required if the value of serviceType is T (timeshare)..\n\n\ncancelledInfo.whoCancelled\nstring\n\nThe party that initiated the cancellation of the purchase.Required if the value of serviceType is G (a guaranteed reservation), the cardholder did not receive the goods, or the cardholder cancelled before shipment.Possible values: cardholdermerchant\n\n\n transactionId\nstring\n\nThe unique reference of the transaction for which you are raising the dispute.\n\n\n type\nstring\n\nThe type of the dispute. When raising a dispute for cancelled goods or services, the value must be cancelled.\n\n\n\n\n\n\n\n\nMake a note of the dispute  id in the response. You need this ID to provide supporting information as an attachment, update the dispute, submit the dispute for cancelled goods or services, close the dispute, or follow the lifecycle of the dispute.\nThe response includes the following additional parameters:\n\n\n\nParameter\nType\nDescription\n\n\n\n\n arn\nstring\nThe unique Acquirer Reference Number (arn) generated by the card scheme for each capture. You can use the arn to trace the transaction through its lifecycle.\n\n\n id\nstring\nThe unique identifier of the raised dispute.\n\n\n status\nstring\nThe current status of the dispute. You can update a dispute to submitted or closed. Possible values: draft, submitted, closed, won, chargeback, secondPresentment.\n\n\n\n\n\n\nAdyen sends a  balancePlatform.dispute.created webhook to your server for the dispute with a status of draft.\n\n\n\n\n\n2. Upload attachments (optional)\nWe recommend that your cardholder upload supporting documentation, such as receipts, communication with a merchant, or any additional documents that would help the card scheme when they are reviewing the dispute.\nWhen you present the screen to cardholders to upload attachments, make sure they know which file types we support (JPEG, PDF, TIFF).\n\n\nBase64-encode any attachments the cardholder provides for upload with their dispute.\n\n\nMake a POST  \/disputes\/{disputeId}\/attachments request, specifying the  disputeId as a path parameter and the following request parameters.\n\n\n\nParameter name\nType\nRequired\nDescription\n\n\n\n\n attachmentType\nstring\n\nThe type of information contained in the attachment.Possible values:receiptcorrespondenceother\n\n\n fileName\nstring\n\nThe name of the attachment, including its filename extension. Minimum length: four characters, Maximum length: 17 characters, including the extension type.Supported filename extensions:jpegpdftiffExamples:airfare24_03.jpeghotel24_0315.jpeg\n\n\n content\nstring\n\nThe content of the image. An attachment must be Base64-encoded data, with a maximum file size of 2 MB.\n\n\n\n\n\n\n\n\nIn the response, note the  attachmentId. You need the ID if you want to later get the attachment, or delete the attachment.\n\n\n\nParameter name\nType\nDescription\n\n\n\n\n attachmentId\nstring\nThe unique identifier of the attachment.\n\n\n\n\n\n\n\n\n3. Review the dispute\nYou should allow your cardholder to review their dispute. This allows the cardholder time to make sure they have captured all information correctly. The cardholder can then confirm they want you to submit the dispute to the card scheme on their behalf, or decide to make edits to their dispute.\n\n\nMake a GET \/disputes\/{id} request, specifying the dispute id as a request parameter.\n\n\n\n\n\nPresent the details of the dispute to your cardholder.\n\n\n4. Edit dispute details (optional)\nIf the cardholder wants to make any changes to the information they provided in their dispute, you can make a request to update the dispute.\n\n\nTo update information in your dispute, make a PATCH  \/disputes\/{id} request, specifying the dispute  id as a path parameter, and supplying updated information in the following request parameters:\nYou do not have to provide the complete dispute object in your PATCH request.\n\n\n\nParameter\nType\nDescription\n\n\n\n\ncancelledInfo\nobject\nThe object containing additional information for raising a dispute of type cancelled. Required for disputes of type cancelled.\n\n\ncancelledInfo.attemptedToReturn\nboolean\nIndicates if the cardholder attempted to return the merchandise but was unable to.Possible values: truefalseRequired if the value of didCardholderReturn is false.If the value of this parameter is true, provide information in descriptionOfIssue about how the cardholder attempted to return the goods, and what they did with the goods (for example, destroyed them).\n\n\ncancelledInfo.certificationGuaranteedReservation\nstring\nThe certification code for the guaranteed reservation.Required if the value of serviceType is G (a guaranteed reservation).Possible values: GR: The cardholder properly cancelled the guaranteed reservation.RC: The cardholder attempted to cancel within 24 hours of delivery of the reservation confirmation.AR: The merchant billed a \"no-show transaction\" for more than one day's accommodation or rental.&lt;\/ul\n\n\ncancelledInfo.dateOfAttemptedReturn\nstring\nThe date, in YYYY-MM-DD format, when the cardholder attempted to return the goods they purchased.Required when the value of attemptedToReturn is true.\n\n\ncancelledInfo.dateOfCancellation\nstring\nThe date, in YYYY-MM-DD format, when the purchase was cancelled.Required if the value of certificationGuaranteedReservation is GR or RC, or if the cardholder cancelled the purchase before shipment.\n\n\ncancelledInfo.dateOfReturn\nstring\nThe date, in YYYY-MM-DD format, that the cardholder shipped or handed back the merchandise.Required if the value of didCardholderReturn is true.\n\n\ncancelledInfo.dateOfService\nstring\nThe date, in YYYY-MM-DD format, that the service was scheduled to take place.Required if the value of serviceType is O (other), or G (guaranteed reservation).\n\n\ncancelledInfo.dateReturnReceived\nstring\nThe date, in YYYY-MM-DD format, that the merchant received the returned merchandise.Required if the value of didCardholderReturn is true.\n\n\ncancelledInfo.descriptionOfIssue\nstring\nYour description of the issue for raising a dispute of type cancelled. Make sure the cardholder provides information that covers the following:A description of the goods or services purchased, and why they are cancelling the purchase.If the goods or services were cancelled before shipment: A description of how the cardholder attempted to cancel the goods or services.If the cardholder attempted to return the goods: A description of how the cardholder attempted to return the goods, and what they did with the goods (for example, destroyed them).If the cardholder attempted to return the goods in a way other than through direct return shipment or face-to-face return at a merchant, how they attempted to return the goods.Maximum length: 2500 characters\n\n\ncancelledInfo.didCardholderCancelBeforeShipment\nboolean\nIndicates if the cardholder cancelled the purchase before the goods were shipped.Possible values: truefalseIf the value of this parameter is true, provide information in descriptionOfIssue about how the cardholder attempted to cancel the goods or services.\n\n\ncancelledInfo.didCardholderReceiveGoods\nboolean\nIndicates if the cardholder received the merchandise.Possible values: truefalseRequired if the value of goodsOrServices is goods.\n\n\ncancelledInfo.didCardholderReturn\nboolean\nIndicates if the cardholder returned the merchandise to the merchant.Possible values: truefalseRequired if the value of didCardholderReceiveGoods is true.\n\n\ncancelledInfo.goodsOrServices\nstring\nThe type of purchase being disputed.Possible values: goodsservices.\n\n\ncancelledInfo.lastExpectedDate\nstring\nThe date, in YYYY-MM-DD format, that the merchant promised delivery.\n\n\ncancelledInfo.merchantRefuseAdvise\nstring\nThe reason the merchant gave for refusing the return.Required if the value of attemptedToReturn is true.Possible values: MRRA: The merchant refused to provide return authorization.MRRM: The merchant refused to accept returned merchandise.MICNRM: The merchant informed cardholder not to return the merchandise.\n\n\ncancelledInfo.returnMethod\nstring\nThe method used to return the merchandise. Required if the value of didCardholderReturn is true.Possible values: FF: Face to faceFE: FedExD: DHLU: UPSP: Postal ServiceO: OtherIf the value of this parameter is O (Other), or if the cardholder attempted a return but did not complete it, provide information in descriptionOfIssue about how the cardholder attempted to return the goods or services.\n\n\ncancelledInfo.serviceType\nstring\nThe type of service purchased.Required if the value of goodsOrServices is services.Possible values: T: timeshareG: guaranteed reservation (for example, a hotel or a car rental booking)O: any other type of service.\n\n\ncancelledInfo.shippingTrackingNumber\nstring\nThe tracking number for the shipment used to return the merchandise.Maximum length: 50.\n\n\ncancelledInfo.timeshareDate\nstring\nThe date, in YYYY-MM-DD format, associated with the timeshare purchase.Required if the value of serviceType is T (timeshare).\n\n\ncancelledInfo.whoCancelled\nstring\nThe party that initiated the cancellation of the purchase.Required if the value of serviceType is G (a guaranteed reservation), the cardholder did not receive the goods, or the cardholder cancelled before shipment.Possible values: cardholdermerchant\n\n\n status\nstring\nThe status of the dispute. You can update the status of a raised dispute from draft to submitted or closed. Possible values: submitted, closed.\n\n\n\n\n\nPresent the updated dispute details from the response to your cardholder.\n\n\n5. Submit the dispute\nIf your cardholder is satisfied with the information they provided for the dispute, they can confirm they want you to submit the dispute to the card scheme for review and a chargeback, if successful.\nWhen you submit a dispute to the card scheme, you can no longer update the dispute, upload or delete attachments, or close the dispute.\n\n\nMake a PATCH  \/disputes\/{id} request, specifying the dispute  id as a path parameter, and include  status with a value of submitted as a request parameter.\n\n\n\nA successful response includes the dispute object, with an updated status of submitted. Adyen also sends your system a  balancePlatform.dispute.updated webhook with the updated status.\n\n\n\n\n\nNotify the cardholder that their dispute has been submitted.\n\n\n6. Process webhooks for status changes\n\n\nProcess  balancePlatform.dispute.updated webhooks, looking for changes in the status of your raised dispute.\n\n\nIf the status of a dispute changes to chargeback or secondPresentment, inspect  balancePlatform.transfer.created webhooks for the matching Acquirer Reference Number (arn), and reconcile balances for the cardholder's balance account.\n\nLifecycle of a raised dispute describes in more detail how status changes for disputes are communicated to your system through Adyen webhooks, and how balance mutations are recorded in the Balance Platform Accounting Report.\nAssociating IDs throughout the dispute lifecycle describes the various IDs you should refer to when correlating original transactions, acquirer reference numbers, and dispute IDs to your raised disputes.\n\n\n\nSee also\n\n\n                    Lifecycle of a raised dispute\n                \n                    Associating IDs throughout the dispute lifecycle\n                \n                    Manage disputes\n                \n                    Upload and manage attachments\n                \n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Adyen Issuing","lvl2":"Raise disputes for transactions made with an Adyen-issued card","lvl3":"Raise a dispute for cancelled goods or services"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/issuing","lvl2":"https:\/\/docs.adyen.com\/issuing\/raise-disputes","lvl3":"\/issuing\/raise-disputes\/cancelled"},"levels":4,"category":"Issuing","category_color":"green","tags":["Raise","dispute","cancelled","goods","services"]}}
