Chargeback and refund models
These models handle transaction disputes, chargebacks, and refund processing in Chargeworx.ChargebackDetail
Tracks chargeback disputes initiated by cardholders or issuing banks.Key properties
| Property | Type | Description |
|---|---|---|
| Id | Guid | Unique chargeback identifier |
| TransactionId | Guid | Associated transaction reference |
| ReasonCode | String | Chargeback reason code |
| Amount | Decimal | Disputed amount |
| Status | String | Chargeback status |
| ReceivedDate | DateTime | Date chargeback was received |
| DueDate | DateTime | Response due date |
| ResolutionDate | DateTime? | Date chargeback was resolved |
Relationships
- Belongs to a Transaction
Chargeback lifecycle
- Received - Chargeback notification received from processor
- Under review - Merchant reviewing dispute
- Responded - Evidence submitted to processor
- Won/Lost - Final resolution
- Closed - Case closed
PurchaseRefund
Represents merchant-initiated refunds for transactions.Key properties
| Property | Type | Description |
|---|---|---|
| Id | Guid | Unique refund identifier |
| TransactionId | Guid | Original transaction reference |
| Amount | Decimal | Refund amount |
| Reason | String | Refund reason |
| Status | String | Refund status |
| RequestedDate | DateTime | Date refund was requested |
| ProcessedDate | DateTime? | Date refund was processed |
| RefundType | String | Full or partial refund |
Relationships
- Belongs to a Transaction
Refund types
- Full refund - Complete transaction reversal
- Partial refund - Partial amount returned to customer
Refund lifecycle
- Requested - Refund initiated by merchant
- Pending - Submitted to payment processor
- Approved - Processor approved refund
- Completed - Funds returned to customer
- Failed - Refund processing failed
Usage patterns
Processing refunds
Refunds can be initiated through the admin UI or API. Partial refunds allow merchants to return a portion of the transaction amount.Managing chargebacks
Chargebacks require merchant response within the due date. Evidence and documentation can be attached to dispute cases.Reporting
Both chargebacks and refunds impact merchant account health and are tracked for reporting and analytics purposes.Best practices
- Process refunds promptly to avoid chargebacks
- Maintain detailed transaction records for chargeback defense
- Monitor chargeback ratios to maintain processor compliance
- Document refund reasons for business intelligence