v1

latestSwagger 2.02026-08-0419357210.1 KB
Disputes

Eligibility Check

Mandatory gate between the transaction selection screen and the dispute reasons screen. Validates two things: each selected transaction is individually eligible for self-service dispute submission, and all selected transactions share the same payment rail — ACH and Debit cannot be mixed in a single dispute. On failure, returns one structured error per failed rule, each with a machine-readable code and a human-readable message, that Lumin surfaces inline on the transaction selection screen; the member stays in the flow and can adjust their selection. Transaction-scoped codes (RAIL_MISMATCH, TRANSACTION_NOT_FOUND, TRANSACTION_NOT_SETTLED, TRANSACTION_ALREADY_DISPUTED, TRANSACTION_OUTSIDE_ELIGIBILITY_WINDOW) mean there is no disputable transaction behind one or more selected ids for that specific reason; MEMBER_INELIGIBLE means the member is not allowed to dispute at all right now, independent of the selection.

get/v1/disputes/eligibility

Query parameters

customerUuidstring
accountUuidstring
transactionIdsstring[]
transactionDatesstring[]

transaction_dates gives a +/-1-day search-window hint for locating each transaction in the core quickly, in the same order as transaction_ids (transaction_dates[i] hints transaction_ids[i]). Only the date portion is used; any time-of-day component is ignored. It is NOT trusted as authoritative: the server still resolves the real transaction and uses its own timestamp for the max-age eligibility rule, so a missing or wrong hint only costs a slower lookup, never a bypassed rule. May be omitted or shorter than transaction_ids; missing entries fall back to an unscoped lookup.

Response

A successful response.

eligibleboolean