List Disputes pending settlement

Overview

User management

Users
User regulatory status
User e-money

User verification

User data format
KYC documents
UBO declarations

Wallets

User wallets
Client wallets

Cards

Card registrations
Cards
Metadata
Card validations

Card pay-ins

Direct card pay-ins
Recurring card pay-ins
Preauthorizations
Deposit preauthorizations
Web card pay-ins

Banking pay-ins

Bank wires
Virtual IBAN
Direct debits
Web direct debits

APM pay-ins

Apple Pay
Bancontact
BLIK
Giropay
Google Pay
iDEAL
Klarna
MB WAY
Multibanco
Payconiq
PayPal
Satispay
Swish
TWINT

Transfers

Transfers

Refunds

Refunds

Disputes

Payouts

Bank accounts
Payouts

FX conversions

Conversion rates
Quotes
Conversions

Transactions

Transactions

Helpers

API responses
Country authorizations
Webhooks
Events
Reports

Platform account

Client
Dashboard permissions

GET

v2.01

{ClientId}

disputes

pendingsettlement

const mangopayInstance = require('mangopay2-nodejs-sdk')
const mangopay = new mangopayInstance({
    clientId: 'your-client-id',
    clientApiKey: 'your-api-key',
})

const listDisputesPendingSettlement = async () => {
  return await mangopay.Disputes.getPendingSettlement()
    .then((response) => {
      console.info(response)
      return response
    })
    .catch((err) => {
      console.log(err)
      return false
    })
}

listDisputesPendingSettlement()  

[
    {
        "InitialTransactionId": "158596153",
        "InitialTransactionType": "PAYIN",
        "InitialTransactionNature": "REGULAR",
        "DisputeType": "CONTESTABLE",
        "ContestDeadlineDate": 1673049599,
        "DisputedFunds": {
            "Currency": "EUR",
            "Amount": 1200
        },
        "ContestedFunds": {
            "Currency": "EUR",
            "Amount": 1200
        },
        "Status": "CLOSED",
        "StatusMessage": null,
        "DisputeReason": {
            "DisputeReasonMessage": "This is a test dispute",
            "DisputeReasonType": "UNKNOWN"
        },
        "ResultCode": "LOST",
        "ResultMessage": null,
        "Id": "159102965",
        "Tag": null,
        "CreationDate": 1672411848,
        "ClosedDate": null,
        "RepudiationId": "159102966"
    }
]  

This call lists all the disputes for which you need to make a settlement transfer.

Responses

Array (Disputes)

array

The list of disputes automatically created by Mangopay.

Object (Dispute)

object

The dispute automatically created by Mangopay.

InitialTransactionId

string

The unique identifier of the initial pay-in being disputed.

InitialTransactionType

string

Returned values: PAYIN

The type of the initial transaction being disputed.

InitialTransactionNature

string

Returned values: REGULAR, REPUDIATION, REFUND, SETTLEMENT

The nature of the initial transaction being refunded, providing more information about the context in which the transaction occurred:

REGULAR – Relative to most of the transactions (pay-ins, payouts, and transfers) in a usual workflow.
REPUDIATION – Automatic withdrawal of funds from the platform’s repudiation wallet as part of the dispute process (when the user requested a chargeback).
REFUND – Reimbursement of a transaction to the user (pay-in refund), to a wallet (transfer refund), or of a payout (payout refund, only initiated by Mangopay).
SETTLEMENT – Transfer made to the repudiation wallet by the platform to settle the credit from a repudiation following a lost dispute.

DisputeType

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.

ContestDeadlineDate

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.

DisputedFunds

string

Information about the disputed funds.
Note: This amount can be lower than the initial transaction amount.

ContestedFunds

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.

Status

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.

StatusMessage

string

Additional information about the dispute Status communicated by Mangopay teams.

DisputeReason

object

Information about the reasons for the dispute.

DisputeReasonType

string

The reason for the dispute.

DisputeReasonMessage

string

Max. length: 255 characters

Additional information about the reason for the dispute sent by Mangopay teams.

ResultCode

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.

ResultMessage

string

The explanation of the result code.

string

The unique identifier of the object.

Tag

string

Max. length: 255 characters

Custom data that you can add to this object.

CreationDate

timestamp

The date and time at which the object was created.

ClosedDate

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.

RepudiationId

string

The unique identifier of the repudiation.

[
    {
        "InitialTransactionId": "158596153",
        "InitialTransactionType": "PAYIN",
        "InitialTransactionNature": "REGULAR",
        "DisputeType": "CONTESTABLE",
        "ContestDeadlineDate": 1673049599,
        "DisputedFunds": {
            "Currency": "EUR",
            "Amount": 1200
        },
        "ContestedFunds": {
            "Currency": "EUR",
            "Amount": 1200
        },
        "Status": "CLOSED",
        "StatusMessage": null,
        "DisputeReason": {
            "DisputeReasonMessage": "This is a test dispute",
            "DisputeReasonType": "UNKNOWN"
        },
        "ResultCode": "LOST",
        "ResultMessage": null,
        "Id": "159102965",
        "Tag": null,
        "CreationDate": 1672411848,
        "ClosedDate": null,
        "RepudiationId": "159102966"
    }
]  

const mangopayInstance = require('mangopay2-nodejs-sdk')
const mangopay = new mangopayInstance({
    clientId: 'your-client-id',
    clientApiKey: 'your-api-key',
})

const listDisputesPendingSettlement = async () => {
  return await mangopay.Disputes.getPendingSettlement()
    .then((response) => {
      console.info(response)
      return response
    })
    .catch((err) => {
      console.log(err)
      return false
    })
}

listDisputesPendingSettlement()  

Was this page helpful?

List all Disputes List Disputes for a PayIn

const mangopayInstance = require('mangopay2-nodejs-sdk')
const mangopay = new mangopayInstance({
    clientId: 'your-client-id',
    clientApiKey: 'your-api-key',
})

const listDisputesPendingSettlement = async () => {
  return await mangopay.Disputes.getPendingSettlement()
    .then((response) => {
      console.info(response)
      return response
    })
    .catch((err) => {
      console.log(err)
      return false
    })
}

listDisputesPendingSettlement()  

[
    {
        "InitialTransactionId": "158596153",
        "InitialTransactionType": "PAYIN",
        "InitialTransactionNature": "REGULAR",
        "DisputeType": "CONTESTABLE",
        "ContestDeadlineDate": 1673049599,
        "DisputedFunds": {
            "Currency": "EUR",
            "Amount": 1200
        },
        "ContestedFunds": {
            "Currency": "EUR",
            "Amount": 1200
        },
        "Status": "CLOSED",
        "StatusMessage": null,
        "DisputeReason": {
            "DisputeReasonMessage": "This is a test dispute",
            "DisputeReasonType": "UNKNOWN"
        },
        "ResultCode": "LOST",
        "ResultMessage": null,
        "Id": "159102965",
        "Tag": null,
        "CreationDate": 1672411848,
        "ClosedDate": null,
        "RepudiationId": "159102966"
    }
]  

Overview

User management

User verification

Wallets

Cards

Card pay-ins

Banking pay-ins

APM pay-ins

Transfers

Refunds

Disputes

Payouts

FX conversions

Transactions

Helpers

Platform account

​Responses

Responses