Sign in

v1

latestSwagger 2.02026-08-0419357210.1 KB
Disputes

Create Dispute

Submits a dispute for one or more transactions. Accepts transaction details, customer info, the selected parent dispute reason, and questionnaire answers using question_uuid/answer pairs from GetQuestionnaire. Returns a DisputeSummary including the dispute_uuid, short ID, resolution deadline, and any initial actions (e.g. issue provisional credit, replace card). The dispute_uuid in the response is required to attach supporting files via UploadFile.

post/v1/disputes

Request body

orgUuidstring
reason'DISPUTE_REASON_UNKNOWN' | 'DISPUTE_REASON_UNAUTH' | 'DISPUTE_REASON_MERCHANT_ISSUE' | 'DISPUTE_REASON_ATM_ISSUE' | 'DISPUTE_REASON_ACH_ISSUE' | 'DISPUTE_REASON_TRANSFER_ISSUE' | 'DISPUTE_REASON_ATM_ISSUE_CASH_NOT_DISPENSED' | 'DISPUTE_REASON_MERCHANT_ISSUE_GOODS_OR_SERVICES_NOT_RECEIVED' | 'DISPUTE_REASON_MERCHANT_ISSUE_GOODS_OR_SERVICES_NOT_AS_DESCRIBED' | 'DISPUTE_REASON_MERCHANT_ISSUE_RETURNED' | 'DISPUTE_REASON_MERCHANT_ISSUE_CANCELED_SUBSCRIPTION' | 'DISPUTE_REASON_MERCHANT_ISSUE_REFUND_NOT_RECEIVED' | 'DISPUTE_REASON_MERCHANT_ISSUE_CHARGED_INCORRECT_AMOUNT' | 'DISPUTE_REASON_MERCHANT_ISSUE_PAID_BY_OTHER_MEANS' | 'DISPUTE_REASON_TRANSFER_ISSUE_NOT_RECEIVED' | 'DISPUTE_REASON_TRANSFER_ISSUE_INCORRECT_RECIPIENT' | 'DISPUTE_REASON_TRANSFER_ISSUE_INCORRECT_AMOUNT' | 'DISPUTE_REASON_TRANSFER_ISSUE_DUPLICATE_CHARGE' | 'DISPUTE_REASON_ATM_ISSUE_PARTIAL_CASH' | 'DISPUTE_REASON_MERCHANT_ISSUE_DUPLICATE_CHARGE' | 'DISPUTE_REASON_ATM_ISSUE_CASH_NOT_DEPOSITED' | 'DISPUTE_REASON_TRANSFER_ISSUE_FAILED_CANCELLATION'
  • DISPUTE_REASON_MERCHANT_ISSUE: Provisional/parent merchant reason returned by GetDisputeReasons. The specific sub-reason (MERCHANT_ISSUE_*) is resolved server-side from the questionnaire answers at Create time.
  • DISPUTE_REASON_ATM_ISSUE: Provisional/parent ATM reason returned by GetDisputeReasons. The specific sub-reason (ATM_ISSUE_*) is resolved server-side from the questionnaire answers at Create time.
  • DISPUTE_REASON_TRANSFER_ISSUE: Provisional/parent transfer reason returned by GetDisputeReasons. The specific sub-reason (TRANSFER_ISSUE_*) is resolved server-side from the questionnaire answers at Create time.

Response

A successful response.