Get dispute
GET https://{domainname}/v1/{merchantId}/disputes/{disputeId}
Disputes
The Dispute REST Service allows you to retrieve and manage disputes that have been created on a payment. Dispute requests will only be handled after you have submitted the dispute, which should only be done after you have uploaded all the evidence.
Request
This REST service retrieves the status and additional information of a single dispute. No payload is required in the request.
Request example
SDK: Node.js
Default scenario
This scenario you will probably use the most
-
const sdkResponse = await client.v1.disputes.get("merchantId", "disputeId"); // sdkResponse has the following properties: // - status: the HTTP status code // - body: the response body // - isSuccess: true if the call was successful, // or false if the Worldline Global Collect platform returned an error response
Responses
Please find below an overview of the possible responses.
Response 200 - OKDisputeResponse
The dispute was successfully retrieved. The response contains the standard dispute object.
|
Properties
|
|||
| Property | Type | Required | Details |
|---|---|---|---|
| object | no | read close | |
|
close
DescriptionA list containing all dispute-related information that is generated upon dispute creation.
|
|||
|
close
DescriptionObject containing amount and ISO currency code attributes
|
|||
|
close
DescriptionAmount in cents and always having 2 decimals
|
|||
|
close
DescriptionThree-letter ISO currency code representing the currency for the amount
|
|||
|
close
DescriptionThe name of the person on your side who can be contacted regarding this dispute.
|
|||
|
close
DescriptionObject containing various details related to this dispute’s creation.
|
|||
|
close
DescriptionThe date and time of creation of this dispute, in yyyyMMddHHmmss format.
|
|||
|
close
DescriptionThe originator of this dispute, which is either Worldline or you as our client.
|
|||
|
close
DescriptionThe user account name of the dispute creator.
|
|||
|
close
DescriptionThe email address of the contact person.
|
|||
|
close
DescriptionAn array containing all files related to this dispute.
|
|||
|
close
DescriptionThe name of the file.
|
|||
|
close
DescriptionThe size of the file in bytes.
|
|||
|
close
DescriptionThe type of the file.
|
|||
|
close
DescriptionThe numeric identifier of the file.
|
|||
|
close
DescriptionA collection of reference information related to this dispute.
|
|||
|
close
DescriptionThe merchant’s order ID of the transaction to which this dispute is linked.
|
|||
|
close
DescriptionYour (unique) reference for the transaction that you can use to reconcile our report files.
|
|||
|
close
DescriptionPayment Reference generated by WebCollect.
|
|||
|
close
DescriptionThe numerical identifier of the Service Provider (Acquirer).
|
|||
|
close
DescriptionThe Service Provider’s reference.
|
|||
|
close
DescriptionThe email address to which the reply message will be sent.
|
|||
|
close
DescriptionThe message sent from you to Worldline.
|
|||
|
close
DescriptionThe return message sent from the GlobalCollect platform to you.
|
|||
| id | string | no | read close |
|
close
DescriptionThe numeric identifier of the file.
|
|||
| paymentId | string | no | read close |
|
close
DescriptionThe ID of the payment that is being disputed.
|
|||
| status | string | no | read close |
|
close
DescriptionThe status of the dispute in alphabetical format, e.g. CREATED, DRAFT, etc.
|
|||
| object | no | read close | |
|
close
DescriptionThis object has the numeric representation of the current payment status, timestamp of last status change and performable action on the current payment resource.
In case of failed payments and negative scenarios, detailed error information is listed.
|
|||
|
close
DescriptionFlag indicating if the payment can be cancelled
|
|||
|
close
DescriptionHighlevel status of the payment, payout or refund with the following possible values:
Please see Statuses for a full overview of possible values. |
|||
|
close
DescriptionNumeric status code of the legacy API. It is returned to ease the migration from the legacy APIs to Worldline Connect. You should not write new business logic based on this property as it will be deprecated in a future version of the API. The value can also be found in the GlobalCollect Payment Console, in the Ogone BackOffice and in report files.
|
|||
|
close
DescriptionDate and time of payment
Format: YYYYMMDDHH24MISS |
|||
| Property | Type | Required | Details |
Response example
SDK: Node.js
Default scenario
This scenario you will probably use the most
-
{ "id" : "162", "paymentId" : "000000852800000014110000100001", "disputeOutput" : { "amountOfMoney" : { "amount" : 1000, "currencyCode" : "EUR" }, "contactPerson" : "Wile Coyote", "creationDetails" : { "disputeCreationDate" : "20180731033126" }, "emailAddress" : "wile.e.coyote@acmelabs.com", "files" : [ ], "replyTo" : "wile.e.coyote@acmelabs.com", "requestMessage" : "Testing Create Dispute" }, "status" : "DRAFT", "statusOutput" : { "isCancellable" : false, "statusCode" : 500, "statusCodeChangeDateTime" : "20180731033126" } }
Response 400 - Bad requestErrorResponse
|
Properties
|
|||
| Property | Type | Required | Details |
|---|---|---|---|
| errorId | string | yes | read close |
|
close
DescriptionUnique reference, for debugging purposes, of this error response
|
|||
| array of object | yes | read close | |
|
close
DescriptionList of one or more errors
|
|||
|
close
DescriptionCategory the error belongs to. The category should give an indication of the type of error you are dealing with.
Possible values:
|
|||
|
close
DescriptionError code
|
|||
|
close
DescriptionHTTP status code for this error that can be used to determine the type of error
|
|||
|
close
DescriptionID of the error. This is a short human-readable message that briefly describes the error.
|
|||
|
close
DescriptionHuman-readable error message that is not meant to be relayed to customer as it might tip off people who are trying to commit fraud
|
|||
|
close
DescriptionReturned only if the error relates to a value that was missing or incorrect.
Contains a location path to the value as a JSonata query. Some common examples:
|
|||
|
close
DescriptionID of the request that can be used for debugging purposes
|
|||
| Property | Type | Required | Details |
Response example
SDK: Node.js
Default scenario
This scenario you will probably use the most
-
{ "errorId" : "5bfecf8a206d6409782db2674936376e", "errors" : [ { "code" : "10025", "message" : "Invalid disputeId in url", "httpStatusCode" : 400 } ] }