The Disputes object
From the Disputes endpoint, you can retrieve a list of all disputes for a specified business.
| Field | Type | Description |
|---|---|---|
| id sortable, filterable | string | Identifier of the dispute |
| orderRef | string | Reference to the order associated with the dispute. |
| totalAmount | decimal | The total amount disputed by the cardholder. |
| currencyRef | Reference Types | Currency of the dispute. |
| status sortable, filterable | string | Current status of a dispute. |
| reason sortable, filterable | string | Current reason of a dispute. |
| dueDate sortable, filterable | string See Date | Date when the next action in the dispute resolution is due. |
| sourceModifiedDate sortable, filterable | string See Date | Date the dispute was recorded in the commerce platform. |
Disputes Status
evidenceRequired- The dispute has been open and needs an evidence submission.inquiryProcessing- Inquiry evidence has been submitted and the bank is processing the inquiry.processing- Dispute evidence has been submitted and the bank is processing the dispute.inquiryClosed- The inquiry is complete.chargeRefunded- The merchant refunded the inquiry amount.inquiryAccepted- The merchant has accepted the dispute as being valid.inquiryWon- The cardholder's bank reached a final decision in the merchant's favour.inquiryLost- The cardholder's bank reached a final decision in the buyer's favour.unknown- Railz is unable to identify the dispute status.other
Disputes Reason
bankNotProcessed- The customer's bank cannot process the charge.creditNotProcessed- The customer claims that the purchased product was returned or the transaction was otherwise cancelled, but the merchant has not yet provided a refund or credit.debitNotAuthorized- The customer's bank cannot proceed with the debit since it has not been authorized.duplicate- The customer claims they were charged multiple times for the same product or service.fraudulent- The cardholder claims that they didn't authorize the payment.general- The dispute is uncategorized, so the merchant should contact the customer for additional details to find out why the payment was disputed.incorrectAccountDetails- The customer account associated with the purchase is incorrect.insufficientFunds- The customer's bank account has insufficient funds.productNotReceived- The customer claims they did not receive the products or services purchased.productUnacceptable- The product or service was received but was defective, damaged, or not as described.subscriptionCanceled- The customer claims that the merchant continued to charge them after a subscription was cancelled.unrecognized- The customer doesn't recognize the payment appearing on their card statement.unknown- Railz is unable to identify the dispute reason.other