THthredd
Disputes

Initiates a dispute for a specific transaction by forwarding transaction details to PayTic. This endpoint is called from the Thredd Portal when a user selects "Initiate Dispute Flow" for a transaction.

Changed on

Authentication requirements:

  • User must have either ChargebackManager OR ChargebackClaims policy (at least one required)
  • Valid PMID claim must be present in the authentication token

Process flow:

  1. Validates transaction ID and user authorization
  2. Retrieves comprehensive transaction details from database
  3. Forwards transaction data to PayTic dispute management system
  4. Returns success/failure response to Thredd Portal
post/api/v1/disputes/transactions/{transactionId}/initiate

Request

  • Base URL
    https://cardsapi-uat-pub.globalprocessing.net
  • URL
    https://cardsapi-uat-pub.globalprocessing.net/api/v1/disputes/transactions/{transactionId}/initiate
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://uatists.globalprocessing.net/connect/token scopes: readWrite

Path parameters

transactionIdstring required

The transaction identifier from the URL path (required).

Request body

publicTokenstring required

Public token of the card associated with the disputed transaction. This field is required for PayTic to identify the cardholder.

disputeReasonstring nullable

Optional reason for initiating the dispute. Provides context for the dispute initiation.

notesstring nullable

Optional additional notes or comments about the dispute. Can be used to provide extra context for the dispute team.

transactionIdstring nullable

The transaction identifier (populated from route parameter, not request body). Internal use only - set by the controller.

Response

Success

successboolean

Indicates whether the dispute was successfully initiated with PayTic.

messagestring nullable

A message describing the result of the operation.

transactionIdstring nullable

The transaction identifier that was submitted for dispute.

processedAtstring date-time

The timestamp when the dispute initiation was processed.

disputeReferenceIdstring nullable

Optional dispute reference ID returned by PayTic. Used to track the dispute in PayTic's system.

Changes