You are viewing the docs for an old API version (v2) → View v2.01

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

Id
string

string:

Maximum length is 255 characters

The item's ID

CreationDate
timestamp

timestamp

When the item was created

Tag
string

string:

Maximum length is 255 characters

Custom data that you can add to this item

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

{
"Id": "8494514",
"CreationDate": 12926321,
"Tag": "custom meta",
"DisputeId": "12327031",
"Status": "CREATED",
"Type": "DELIVERY_PROOF",
"RefusedReasonMessage": "The document was not readable :-(",
"RefusedReasonType": "DOCUMENT_UNREADABLE",
"ProcessedDate": 1501675794
}

Create a Dispute Document

POST .../v2/ClientId

The ID of your client account

/disputes/DisputeId

The Id of a Dispute

/documents/

Parameters

Tag
string

string:

Maximum length is 255 characters
optional

Custom data that you can add to this item

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
    Code samples are only available for the latest API version
  • Run
  • View
  • Code
    Code samples are only available for the latest API version
  • Run
POST .../disputes/:DisputeId/documents/ HTTP/1.1
Body Parameters :
{
"Tag": "custom meta",
"Type": "DELIVERY_PROOF"
}
POST .../disputes//documents/ HTTP/1.1
Body Parameters :
{
"Tag": "",
"Type": ""
}

Create a Dispute Document Page

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

POST .../v2/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
    Code samples are only available for the latest API version
  • Run
  • View
  • Code
    Code samples are only available for the latest API version
  • 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/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
    Code samples are only available for the latest API version
  • Run
  • View
  • Code
    Code samples are only available for the latest API version
  • 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/ClientId

The ID of your client account

/dispute-documents/DisputeDocumentId

The ID of a dispute document

/
  • View
  • Code
    Code samples are only available for the latest API version
  • Run
  • View
  • Code
    Code samples are only available for the latest API version
  • 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/ClientId

The ID of your client account

/dispute-documents/

Get parameters

Page
int

int
optional

The page number of results you wish to return

Per_Page
int

int
optional

The number of results to return per page

Sort
ColumnAndDirection

ColumnAndDirection:

CreationDate:ASC / CreationDate:DESC
optional

The column to sort against and direction - only CreationDate (or Date for the events) is available and ASC or DESC for the direction

BeforeDate
timestamp

timestamp
optional

To return only resources that have CreationDate BEFORE this date

AfterDate
timestamp

timestamp
optional

To return only resources that have CreationDate AFTER this date

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
    Code samples are only available for the latest API version
  • Run
  • View
  • Code
    Code samples are only available for the latest API version
  • Run
GET .../dispute-documents/ HTTP/1.1
Get Parameters :
{
"Page": 1,
"Per_Page": 25,
"Sort": "CreationDate:DESC",
"BeforeDate": 1463440221,
"AfterDate": 1431817821,
"Status": "CREATED, SUCCEEDED",
"Type": "DELIVERY_PROOF"
}
GET .../dispute-documents/ HTTP/1.1
Get Parameters :
{
"Page": ,
"Per_Page": ,
"Sort": "",
"BeforeDate": ,
"AfterDate": ,
"Status": "",
"Type": ""
}

List a Dispute's Documents

GET .../v2/ClientId

The ID of your client account

/dispute/DisputeId

The Id of a Dispute

/documents/

Get parameters

Page
int

int
optional

The page number of results you wish to return

Per_Page
int

int
optional

The number of results to return per page

Sort
ColumnAndDirection

ColumnAndDirection:

CreationDate:ASC / CreationDate:DESC
optional

The column to sort against and direction - only CreationDate (or Date for the events) is available and ASC or DESC for the direction

BeforeDate
timestamp

timestamp
optional

To return only resources that have CreationDate BEFORE this date

AfterDate
timestamp

timestamp
optional

To return only resources that have CreationDate AFTER this date

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
    Code samples are only available for the latest API version
  • Run
  • View
  • Code
    Code samples are only available for the latest API version
  • Run
GET .../dispute/:DisputeId/documents/ HTTP/1.1
Get Parameters :
{
"Page": 1,
"Per_Page": 25,
"Sort": "CreationDate:DESC",
"BeforeDate": 1463440221,
"AfterDate": 1431817821,
"Status": "CREATED, SUCCEEDED",
"Type": "DELIVERY_PROOF"
}
GET .../dispute//documents/ HTTP/1.1
Get Parameters :
{
"Page": ,
"Per_Page": ,
"Sort": "",
"BeforeDate": ,
"AfterDate": ,
"Status": "",
"Type": ""
}

Consult a dispute document's pages

POST .../v2/ClientId

The ID of your client account

/disputes-documents/DisputeDocumentId

The ID of a dispute document

/consult/
  • View
  • Code
    Code samples are only available for the latest API version
  • Run
  • View
  • Code
    Code samples are only available for the latest API version
  • Run
POST .../disputes-documents/:DisputeDocumentId/consult/ HTTP/1.1
POST .../disputes-documents//consult/ HTTP/1.1
Share feedback