TAtabby
Disputes

Challenge disputes

Changed on

Challenge disputes (request Tabby support to take a look at the case). Only 20 disputes can be challenged within a single request. Only disputes with status 'new' might be challenged.

post/api/v1/disputes/challenge

Request

  • Base URL
    https://api.tabby.ai
  • URL
    https://api.tabby.ai/api/v1/disputes/challenge
  • Auth
    HTTP bearer

Request body

dispute_idstring required

ID of the dispute

descriptionstring required

Comment for Tabby support.

reason'merchant_reason_other' | 'merchant_reason_order_on_its_way' | 'merchant_reason_order_has_been_already_delivered' | 'merchant_reason_order_amount_should_be_different' | 'merchant_reason_problem_with_delivery' required

Reason for requesting dispute challenge:

  • merchant_reason_other - there were other problems with the order that required further clarification;
  • merchant_reason_order_on_its_way - the order has been confirmed and is in the process of being delivered;
  • merchant_reason_order_has_been_already_delivered - the order has already been delivered and is complete;
  • merchant_reason_order_amount_should_be_different - there was a problem with the amount of the order and it needed to be changed;
  • merchant_reason_problem_with_delivery - there was a problem with the order during delivery that needed to be adjusted and resolved.
amountstring

If the dispute challenged with reason merchant_reason_order_amount_should_be_different - a new disputed amount is required.

attachment_idsstring[]

Attachment ID that will be attached. ID can be received via upload attachment endpoint.

Example request

{
  "dispute_id": "uuid",
  "description": "Comment for Tabby support",
  "reason": "merchant_reason_other",
  "amount": "100",
  "attachment_ids": [
    "attachment id, uuid format"
  ]
}

Response

Success. Disputes were challenged.

Example response

{
  "disputes": [
    {
      "id": "dispute id, uuid format",
      "attachments": [
        "attachment_1"
      ],
      "payment_id": "payment id, uuid format",
      "amount": "100.00",
      "currency": "AED",
      "created_at": "2018-10-17",
      "expired_at": "2018-10-17",
      "status": "new",
      "reason": "unreceived_refund",
      "items": [
        {
          "reference_id": "payment id",
          "title": "Order item title",
          "unit_price": "100.00"
        }
      ],
      "order_number": "#1234",
      "comment": "additional comments"
    }
  ]
}

Changes

  • cff62a2a6ee9Revision changes
    • breaking

      the response's body type changed from string to object for status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      removed the KWD enum value from the // response property for the response status