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
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
Submit a Dispute
This call is used both for the initial submission of the dispute and any resubmission made afterwards (in case more documents are required for instance).
Path parameters
The unique identifier of the dispute.
Body parameters
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.
Allowed values: The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings).
The currency of the funds.
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
).
Responses
The unique identifier of the initial pay-in being disputed.
Returned values: PAYIN
The type of the initial transaction being disputed.
Returned values: REGULAR
The nature of the initial transaction being disputed.
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.
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
.
Information about the disputed funds.
Note: This amount can be lower than the initial transaction amount.
Returned values: The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings).
The currency of the funds.
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
).
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.
Returned values: The three-letter ISO 4217 code (EUR, GBP, etc.) of a supported currency (depends on feature, contract, and activation settings).
The currency of the funds.
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
).
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.
Additional information about the dispute Status
communicated by Mangopay teams.
Information about the reasons for the dispute.
The reason for the dispute.
Max. length: 255 characters
Additional information about the reason for the dispute sent by Mangopay teams.
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.
The explanation of the result code.
The unique identifier of the object.
Max. length: 255 characters
Custom data that you can add to this object.
The date and time at which the object was created.
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.
The unique identifier of the repudiation.
{
"Message":"One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
"Type":"param_error",
"Id":"994a6ed2-bca5-4673-a37f-16c01e9ad065#1673365608",
"Date":1673365609,
"errors":{
"ContestedFunds":"This field is required"
}
}
{
"Message": "One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
"Type": "param_error",
"Id": "d37b150a-6238-4298-9da4-2540e6d46bd5#1672669956",
"Date": 1672669957.0,
"errors": {
"ContestedFunds": "The ContestedFunds amount must be less than or equal to the DisputedFunds amount"
}
}
{
"Message": "The ContestDeadlineDate has now passed and this Dispute is no longer contestable",
"Type": "dispute_contest_deadline_passed",
"Id": "9544eb52-8ae4-41ac-99e0-1215f17e3859#1673434106",
"Date": 1673434107.0,
"errors": null
}
Was this page helpful?