POST
/
v2.01
/
{ClientId}
/
disputes
/
{DisputeId}
/
documents
{
    "Type": "DELIVERY_PROOF",
    "Tag": "Custom meta"
}  

{
    "DisputeId": "159102965",
    "Type": "DELIVERY_PROOF",
    "Id": "159188418",
    "Tag": null,
    "CreationDate": 1672655973,
    "ProcessedDate": null,
    "Status": "CREATED",
    "RefusedReasonType": null,
    "RefusedReasonMessage": null
}

​
Path parameters

​
DisputeId
string
required
The unique identifier of the dispute.

​
Body parameters

​
Type
string
required
Allowed values: DELIVERY_PROOF, INVOICE, REFUND_PROOF, USER_CORRESPONDANCE, USER_ACCEPTANCE_PROOF, PRODUCT_REPLACEMENT_PROOF, OTHERThe type of the dispute document.
​
Tag
string
Max. length: 255 charactersCustom data that you can add to this object.

​
Responses

​
DisputeId
string
The unique identifier of the dispute.
​
Type
string
Returned values: DELIVERY_PROOF, INVOICE, REFUND_PROOF, USER_CORRESPONDANCE, USER_ACCEPTANCE_PROOF, PRODUCT_REPLACEMENT_PROOF, OTHERThe type of the dispute document.
​
Id
string
Max length: 128 characters (see data formats for details)The unique identifier of the object.
​
Tag
string
Max. length: 255 charactersCustom data that you can add to this object.
​
CreationDate
Unix timestamp
The date and time at which the object was created.
​
ProcessedDate
Unix timestamp
The date and time at which the document was processed by Mangopay’s team.
​
Status
string
Returned values: CREATED, VALIDATION_ASKED, VALIDATED, REFUSED, OUT_OF_DATEThe status of the dispute document.
​
RefusedReasonType
string
Returned values: DOCUMENT_DO_NOT_MATCH_USER_DATA, DOCUMENT_FALSIFIED, DOCUMENT_HAS_EXPIRED, DOCUMENT_INCOMPLETE, DOCUMENT_MISSING, DOCUMENT_NOT_ACCEPTED, DOCUMENT_UNREADABLE, SPECIFIC_CASE, UNDERAGE_PERSONThe reason for the dispute document refusal. See the RefusedReasonMessage for more information.
​
RefusedReasonMessage
string
Max. length: 255 charactersDefault value: nullAdditional information about why the dispute document was refused, provided by Mangopay’s team.
{
    "DisputeId": "159102965",
    "Type": "DELIVERY_PROOF",
    "Id": "159188418",
    "Tag": null,
    "CreationDate": 1672655973,
    "ProcessedDate": null,
    "Status": "CREATED",
    "RefusedReasonType": null,
    "RefusedReasonMessage": null
}  

{
    "Type": "DELIVERY_PROOF",
    "Tag": "Custom meta"
}