You can submit an evidence file for a dispute through this method. You can only submit evidence for disputes that have a
result = gateway.dispute.add_file_evidence( "a_dispute_id", document.id, # see the example below for more details )
If the evidence is successfully added to the dispute, the result will be successful and will include the evidence object. Otherwise, check for validation errors.
if result.success? # evidence file added successfully result.evidence else p result.errors end
If the dispute can't be found, it will raise a
The category of this piece of evidence.
The unique identifier for a
DocumentUpload object. The document must have a
If a dispute requires compelling evidence, use the following category codes to indicate what type of evidence you’re submitting. Depending on the dispute reason code, additional validations may apply.
||Evidence of spending across multiple payment types for the same merchandise.|
||Evidence of merchant website or app access.|
||Evidence of a profile setup or app access.|
||Evidence the transaction was completed by an authorized signer that the cardholder knows.|
||Proof of delivery to the cardholder's company address.|
||Proof of delivery to the address on the AVS match.|
||Proof that the customer is in possession of and/or using the merchandise.|
||A signed delivery form, or a copy of the cardholder's ID as proof that the goods were picked up at your business location.|
||A signed order form for a mail or phone transaction.|
||Evidence the ticket was received or scanned at gate, or evidence of other transactions related to the original (e.g. frequent flyer miles).|
When responding to disputes with compelling evidence, specify the appropriate category for all evidence.
result = gateway.dispute.add_file_evidence( "a_dispute_id", category: "MERCHANT_WEBSITE_OR_APP_ACCESS", document_id: document.id, )
document_result = gateway.document_upload.create( kind: Braintree::DocumentUpload::Kind::EvidenceDocument, file: File.new("local_file.pdf", "r"), ) if document_result.success? result = gateway.dispute.add_file_evidence( "a_dispute_id", document_result.document_upload.id, ) end