affirm · Schema

Affirm Dispute

Represents a payment dispute filed by a customer against an Affirm transaction. Disputes are managed via the Affirm Disputes API V3, which supports listing disputes, submitting merchant evidence, and closing disputes. Merchants can contest disputes by uploading supporting documentation via the Files API.

Properties

Name	Type	Description
id	string	Unique identifier for this dispute, assigned by Affirm.
transaction_id	string	The identifier of the Affirm transaction being disputed.
charge_id	string	The identifier of the charge associated with this dispute.
status	string	Current lifecycle status of the dispute.
reason_code	string	Standardized reason code categorizing the nature of the customer's dispute claim.
amount	integer	The disputed amount in the smallest currency unit (e.g., cents for USD).
currency	string	The ISO 4217 currency code for the disputed amount.
created	string	Timestamp when this dispute was opened, in RFC 3339 format.
evidence_due_by	string	Deadline by which the merchant must submit evidence to contest this dispute, in RFC 3339 format.
closed_at	stringnull	Timestamp when this dispute was closed, if applicable. Null if still open.
outcome	stringnull	Final resolution outcome after dispute review. Only set when status is won or lost.
evidence	array	List of evidence items submitted by the merchant in response to this dispute.

View JSON Schema on GitHub