Disputes and Chargebacks
Dispute lifecycle with network reason codes and outcomes, keyed to cardholder and program.
Data contract
8 fields| Field | Type | Sensitivity | Quality rule | Clear to | Purpose |
|---|---|---|---|---|---|
| id | bigint | - | unique, not null | Every persona with access | - |
| transaction_id | bigint | - | fk transactions, not null | Every persona with access | - |
| customer_id | int | - | fk customers, not null | Every persona with access | - |
| reason_code | text | - | not null | Every persona with access | - |
| status | text | - | in (open, won, lost, pending) | Every persona with access | - |
| amount | numeric | - | amount > 0 | Every persona with access | - |
| opened_ts | timestamptz | - | not null | Every persona with access | - |
| partner_scope | text | - | in (nova, general) | Every persona with access | - |
- id bigint
Rule: unique, not null
Clear to: every persona with access
- transaction_id bigint
Rule: fk transactions, not null
Clear to: every persona with access
- customer_id int
Rule: fk customers, not null
Clear to: every persona with access
- reason_code text
Rule: not null
Clear to: every persona with access
- status text
Rule: in (open, won, lost, pending)
Clear to: every persona with access
- amount numeric
Rule: amount > 0
Clear to: every persona with access
- opened_ts timestamptz
Rule: not null
Clear to: every persona with access
- partner_scope text
Rule: in (nova, general)
Clear to: every persona with access