> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Dispute object

### Description

Mangopay relies on the Dispute object to manage chargeback requests from a User. This object is automatically created when the user’s bank orders the reversal of a pay-in.

As a consequence, Mangopay withdraws the required funds from the platform’s Repudiation Wallet. This is called a repudiation and results in the repudiation wallet having a negative balance that the platform will need to settle.

### Attributes

<ParamField body="InitialTransactionId" type="string">
  The unique identifier of the initial pay-in being disputed.
</ParamField>

<ParamField body="InitialTransactionType" type="string">
  **Returned values:** `PAYIN`

  The type of the initial transaction being disputed.
</ParamField>

<ParamField body="InitialTransactionNature" type="string">
  The nature of the initial transaction being disputed.
</ParamField>

<ParamField body="DisputeType" type="string">
  **Returned values:** `CONTESTABLE`, `NOT_CONTESTABLE`, `RETRIEVAL`

  The type of dispute:

  * `CONTESTABLE` – Dispute for which the chargeback can be contested by providing proof (i.e., Dispute Documents) justifying the original transaction.
  * `NOT_CONTESTABLE` – Dispute that is automatically closed after its creation, without any action possible for the platform.
  * `RETRIEVAL` – Dispute that is actually a chargeback warning issued by the bank. The platform is required to provide documents, but no funds will be taken from the Repudiation Wallet.
</ParamField>

<ParamField body="ContestDeadlineDate" type="Unix timestamp">
  The date and time until which the platform can contest the dispute (i.e., the `Status` is set to `SUBMITTED`). This date is defined by the issuing bank of the initial transaction and may usually vary between 7 to 18 days. Once the deadline passes, the dispute `Status` is automatically set to `CLOSED`.
</ParamField>

<ParamField body="DisputedFunds" type="string">
  Information about the disputed funds.\
  Note: This amount can be lower than the initial transaction amount.

  <Expandable title="properties">
    <ParamField body="Currency" type="string">
      **Returned values:** The three-letter <a href="/api-reference/overview/data-formats" target="_blank">ISO 4217 code</a> (EUR, GBP, etc.) of a <a href="/guides/currencies" target="_blank">supported currency</a> (depends on feature, contract, and activation settings).

      The currency of the funds.
    </ParamField>

    <ParamField body="Amount" type="integer">
      An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as `1260` whereas JPY 12 would be represented as just `12`).
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="ContestedFunds" type="object">
  Information about the contested funds, in other words, the amount that you wish to contest.\
  Note: This amount can be lower than the disputed funds amount.

  <Expandable title="properties">
    <ParamField body="Currency" type="string">
      **Returned values:** The three-letter <a href="/api-reference/overview/data-formats" target="_blank">ISO 4217 code</a> (EUR, GBP, etc.) of a <a href="/guides/currencies" target="_blank">supported currency</a> (depends on feature, contract, and activation settings).

      The currency of the funds.
    </ParamField>

    <ParamField body="Amount" type="integer">
      An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as `1260` whereas JPY 12 would be represented as just `12`).
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="Status" type="string">
  **Returned values:** `CREATED`, `PENDING_CLIENT_ACTION`, `SUBMITTED`, `PENDING_BANK_ACTION`, `REOPENED_PENDING_CLIENT_ACTION`, `CLOSED`

  The status of the dispute:

  * `CREATED` – The dispute is created.
  * `PENDING_CLIENT_ACTION` – The dispute was not closed automatically upon its creation, it now requires some actions from the platform (either submission after providing the relevant proofs or closing).
  * `SUBMITTED` – The dispute is submitted by the platform for the Mangopay team to review the documents.
  * `PENDING_BANK_ACTION` – Mangopay accepted the documents and passed them on to the bank for them to review the dispute contestation. They will either reject or accept the contestation, or require further documents.
  * `REOPENED_PENDING_CLIENT_ACTION` – Mangopay didn’t accept the documents and requires more information or documents before sending the documents to the bank.
  * `CLOSED` – The dispute is closed.
</ParamField>

<ParamField body="StatusMessage" type="string">
  Additional information about the dispute `Status` communicated by Mangopay teams.
</ParamField>

<ParamField body="DisputeReason" type="object">
  Information about the reasons for the dispute.

  <Expandable title="properties" defaultOpen>
    <ParamField body="DisputeReasonType" type="string">
      The reason for the dispute.
    </ParamField>

    <ParamField body="DisputeReasonMessage" type="string">
      Max. length: 255 characters

      Additional information about the reason for the dispute sent by Mangopay teams.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="ResultCode" type="string">
  **Returned values:** `LOST`, `WON`, `VOID`

  The result of the dispute for the platform, which can be:

  * `LOST` – The platform lost the dispute and must settle its debt to Mangopay with a Settlement Transfer.
  * `WON` – The platform won the dispute, the disputed funds will be credited back to the Repudiation Wallet.
  * `VOID` – The dispute has been canceled.
</ParamField>

<ParamField body="ResultMessage" type="string">
  The explanation of the result code.
</ParamField>

<ParamField body="Id" type="string">
  The unique identifier of the object.
</ParamField>

<ParamField body="Tag" type="string">
  Max. length: 255 characters

  Custom data that you can add to this object.
</ParamField>

<ParamField body="CreationDate" type="Unix timestamp">
  The date and time at which the object was created.
</ParamField>

<ParamField body="ClosedDate" type="Unix timestamp">
  The date and time the dispute was closed (i.e., its `Status` is set to `CLOSED`).\
  Note: This value will be `null` for any Dispute closed before February 16th, 2023.
</ParamField>

<ParamField body="RepudiationId" type="string">
  The unique identifier of the repudiation.
</ParamField>

### Related resources

<Card title="Guide" href="/guides/disputes">Learn more about disputes</Card>