COMING SOON

Search Disputes

A dispute is logged when a Customer reports issues with one or more transactions, such as an incorrect amount or an unauthorized charge. You can search the transaction disputes logged for an issued card based on filters such as the dispute case number and creation date. If no filters are provided, all disputes for the issued card will be returned.

To search transaction disputes, you will need:

ID of the integrated Financial Account linked to the issued card

Endpoint

GET /v1/integrated-cards/{financialAccountId}/disputes

Authorization Header

Authorization: Bearer <access_token>

Path Parameters

financialAccountId REQUIRED

string (UUID)

ID of the integrated Financial Account linked to the issued card.

Query Parameters

disputeCasenumber

string

Unique case number assigned to the dispute. Use this filter to search for a specific dispute.

createdAtFrom

string (date), required format: yyyy-MM-dd

Date the dispute was created in the RocketKOR system. This filter will return disputes created on or after this date.

Note The date is interpreted using the specified timeZone. UTC format is used if timeZone is not provided.

createdAtTo

string (date), required format: yyyy-MM-dd

Date the dispute was created in the RocketKOR system. This filter will return disputes created on or before this date.

Note The date is interpreted using the specified timeZone. UTC format is used if timeZone is not provided.

timeZone

string (timeZone), default: UTC

Time zone for the createdAtFrom and createdAtTo filters. The following values are supported:

Z, UTC or GMT UTC
IANA Time Zone Database region ID (example: the value for America/New_York is -04)

Request Body

None

Returns

Returns an array of Dispute Detail objects.

SAMPLE RESPONSE

				
					[
  {
    "disputeType": "UNAUTHORIZED",
    "disputeDescription": "Transaction not made by the cardholder",
    "disputedTransactions": [
      {
        "transactionId": "af3c4bf0-fb83-46ac-b4de-d164db5e49a0",
        "disputeAmount": "560.50",
        "disputeReason": "UN_AUTH_ONLINE_PURCHASE"
      }
    ],
    "financialAccountId": "7d08a89d-2ac5-4ed3-a6ca-ad7c974c994e",
    "disputeCaseNumber": "665423",
    "disputeStatus": "LOGGED",
    "logDateTime": "2023-02-13T01:18:02.049Z"
  },
  {...},
  {...}
]