The Dispute Document object

You need to create document in order to upload pages on this document. Note that dispute documents function in just the same way KYC documents.

Parameters

DisputeId
string

string:

Maximum length is 255 characters

The Id of a Dispute

Status
DocumentStatus

DocumentStatus:

CREATED, VALIDATION_ASKED, VALIDATED, REFUSED, OUT_OF_DATE

The Status of the Document

The status of this KYC/Dispute document

Type
DisputeDocumentType

DisputeDocumentType:

DELIVERY_PROOF, INVOICE, REFUND_PROOF, USER_CORRESPONDANCE, USER_ACCEPTANCE_PROOF, PRODUCT_REPLACEMENT_PROOF, OTHER

The type of dispute document

Gives the type of the dispute document

RefusedReasonMessage
string

string:

Maximum length is 255 characters

The message accompanying a refusal

RefusedReasonType
DisputeDocRefusedReasonType

DisputeDocRefusedReasonType:

DOCUMENT_UNREADABLE, DOCUMENT_NOT_ACCEPTED, DOCUMENT_HAS_EXPIRED, DOCUMENT_INCOMPLETE, DOCUMENT_MISSING, SPECIFIC_CASE, DOCUMENT_FALSIFIED, OTHER

The type of refusal reason

The type of reason for refusal

ProcessedDate
timestamp

timestamp

The date when the document was processed by MANGOPAY

{
"DisputeId": "12327031",
"Status": "CREATED",
"Type": "DELIVERY_PROOF",
"RefusedReasonMessage": "The document was not readable :-(",
"RefusedReasonType": "DOCUMENT_UNREADABLE",
"ProcessedDate": 1501675794
}

Create a Dispute Document

POST .../v2.01/ClientId

The ID of your client account

/disputes/DisputeId

The Id of a Dispute

/documents/

Parameters

Type
DisputeDocumentType

DisputeDocumentType:

DELIVERY_PROOF, INVOICE, REFUND_PROOF, USER_CORRESPONDANCE, USER_ACCEPTANCE_PROOF, PRODUCT_REPLACEMENT_PROOF, OTHER

The type of dispute document
required

Gives the type of the dispute document

  • View
  • Code
  • Run
  • View
  • Code
  • Run
POST .../disputes/:DisputeId/documents/ HTTP/1.1
Body Parameters :
{
"Type": "DELIVERY_PROOF"
}
POST .../disputes//documents/ HTTP/1.1
Body Parameters :
{
"Type": ""
}

Create a Dispute Document Page

The maximum size per page is about 7MB (or 10MB when base64encoded

POST .../v2.01/ClientId

The ID of your client account

/disputes/DisputeId

The Id of a Dispute

/documents/DisputeDocumentId

The ID of a dispute document

/pages/

Parameters

File
string

string:

Maximum length is 255 characters
required

The base64 encoded file which needs to be uploaded

  • View
  • Code
  • Run
  • View
  • Code
  • Run
POST .../disputes/:DisputeId/documents/:DisputeDocumentId/pages/ HTTP/1.1
Body Parameters :
{
"File": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAYAAABccqhmAADCwUlEQVR4nOy9d5hlV3Xm/Tvx5lQ5dKjOUR3U3co5ISRhG4FJ9hhsbPhsTJDBHnvGY489Y5MEtgFr7AFmDLbHYEACkbHAyrlbnUNVdVd3V75VdXM6+ftjn3u6OqolJEG77/s81aHq1r3n7LP32muv9a53SZ7nebTQQgsXJeSf9QW00EILPzu0DEALLVzEaBmAFlq4iNEyAC20cBG"
}
POST .../disputes//documents//pages/ HTTP/1.1
Body Parameters :
{
"File": ""
}

Submit a Dispute Document

PUT .../v2.01/ClientId

The ID of your client account

/disputes/DisputeId

The Id of a Dispute

/documents/DisputeDocumentId

The ID of a dispute document

/

Parameters

Status
DocumentStatus

DocumentStatus:

CREATED, VALIDATION_ASKED, VALIDATED, REFUSED, OUT_OF_DATE

The Status of the Document
required

The status of this KYC/Dispute document

  • View
  • Code
  • Run
  • View
  • Code
  • Run
PUT .../disputes/:DisputeId/documents/:DisputeDocumentId/ HTTP/1.1
Body Parameters :
{
"Status": "CREATED"
}
PUT .../disputes//documents// HTTP/1.1
Body Parameters :
{
"Status": ""
}

View a Dispute Document

GET .../v2.01/ClientId

The ID of your client account

/dispute-documents/DisputeDocumentId

The ID of a dispute document

/
  • View
  • Code
  • Run
  • View
  • Code
  • Run
GET .../dispute-documents/:DisputeDocumentId/ HTTP/1.1
GET .../dispute-documents// HTTP/1.1

List all Dispute Documents

You can paginate these HTTP GET requests and also add filters such as BeforeDate, AfterDate, Type (e.g. REFUND_PROOF) and Status (e.g. VALIDATED).

GET .../v2.01/ClientId

The ID of your client account

/dispute-documents/

Get parameters

Status
DocumentStatus

DocumentStatus:

CREATED, VALIDATION_ASKED, VALIDATED, REFUSED, OUT_OF_DATE

The Status of the Document
optional

The status of this KYC/Dispute document

Type
DisputeDocumentType

DisputeDocumentType:

DELIVERY_PROOF, INVOICE, REFUND_PROOF, USER_CORRESPONDANCE, USER_ACCEPTANCE_PROOF, PRODUCT_REPLACEMENT_PROOF, OTHER

The type of dispute document
optional

The type of the dispute document

  • View
  • Code
    A code sample is not available
  • Run
  • View
  • Code
    A code sample is not available
  • Run
GET .../dispute-documents/ HTTP/1.1
Get Parameters :
{
"Status": "CREATED, SUCCEEDED",
"Type": "DELIVERY_PROOF"
}
GET .../dispute-documents/ HTTP/1.1
Get Parameters :
{
"Status": "",
"Type": ""
}

List a Dispute's Documents

GET .../v2.01/ClientId

The ID of your client account

/dispute/DisputeId

The Id of a Dispute

/documents/

Get parameters

Status
DocumentStatus

DocumentStatus:

CREATED, VALIDATION_ASKED, VALIDATED, REFUSED, OUT_OF_DATE

The Status of the Document
optional

The status of this KYC/Dispute document

Type
DisputeDocumentType

DisputeDocumentType:

DELIVERY_PROOF, INVOICE, REFUND_PROOF, USER_CORRESPONDANCE, USER_ACCEPTANCE_PROOF, PRODUCT_REPLACEMENT_PROOF, OTHER

The type of dispute document
optional

The type of the dispute document

  • View
  • Code
    A code sample is not available
  • Run
  • View
  • Code
    A code sample is not available
  • Run
GET .../dispute/:DisputeId/documents/ HTTP/1.1
Get Parameters :
{
"Status": "CREATED, SUCCEEDED",
"Type": "DELIVERY_PROOF"
}
GET .../dispute//documents/ HTTP/1.1
Get Parameters :
{
"Status": "",
"Type": ""
}

Consult a dispute document's pages

POST .../v2.01/ClientId

The ID of your client account

/dispute-documents/DisputeDocumentId

The ID of a dispute document

/consult/
  • View
  • Code
    A code sample is not available
  • Run
  • View
  • Code
    A code sample is not available
  • Run
POST .../dispute-documents/:DisputeDocumentId/consult/ HTTP/1.1
POST .../dispute-documents//consult/ HTTP/1.1
Share feedback