Submit Evidence

Submits evidence to contest a dispute. Evidence is grouped into categories (customer information, cancellation policy, refund policy, shipping, etc.). You can call this endpoint multiple times before the dispute deadline to add or update evidence; submitting an empty value clears that field.

POST /disputes/evidence

File-typed fields (receipt, customer_signature, service_documentation, etc.) take a file id that you obtain by uploading the file separately first. Plain text fields take the value directly.

Body Parameters

Parameter	Type	Required	Description
`dispute_id`	string	Yes	The ID of the dispute to attach evidence to.

Customer information

Parameter	Type	Description
`customer_name`	string	Customer's name on the order.
`customer_email_address`	string	Customer's email address.
`customer_purchase_ip`	string	IP address used by the customer when the purchase was made.
`customer_signature`	string	File id of the customer's signature, if collected.
`customer_communication`	string	File id of any communication with the customer related to the disputed transaction.
`billing_address`	string	Customer's billing address at the time of purchase.
`access_activity_log`	string	Logs that show the customer used the service (login history, session ids).

Product details

Parameter	Type	Description
`product_description`	string	Plain-text description of the product or service the customer was charged for.
`service_date`	string	Date the service was rendered.
`service_documentation`	string	File id of any document proving the service was delivered.
`receipt`	string	File id of the receipt issued to the customer.

Cancellation and refund policies

Parameter	Type	Description
`cancellation_policy`	string	File id of the cancellation policy you display to customers.
`cancellation_policy_disclosure`	string	Plain-text description of when and where the cancellation policy was shown to the customer.
`cancellation_rebuttal`	string	Explanation of why the customer's cancellation request was not honoured.
`refund_policy`	string	File id of the refund policy you display to customers.
`refund_policy_disclosure`	string	Plain-text description of when and where the refund policy was shown.
`refund_refusal_explanation`	string	Explanation of why the customer is not entitled to a refund.

Shipping (physical goods)

Parameter	Type	Description
`shipping_address`	string	Shipping address used for the order.
`shipping_carrier`	string	Name of the shipping carrier (e.g. UPS, FedEx).
`shipping_date`	string	Date the order was shipped.
`shipping_tracking_number`	string	Tracking number from the shipping carrier.
`shipping_documentation`	string	File id of the shipping label, packing slip, or proof of delivery.

Disputes specific to recurring or duplicate charges

Parameter	Type	Description
`invoice_showing_distinct_transactions`	string	File id of an invoice that shows the disputed transaction is distinct from another charge the customer claims is a duplicate.
`recurring_transaction_agreement`	string	File id of the agreement the customer signed authorising recurring charges.

Catch-all

Parameter	Type	Description
`uncategorized_file`	string	File id of any other supporting document.
`uncategorized_text`	string	Free-text statement adding context not covered by the other fields.

Request Example

curl -X POST 'https://api.v2.paychtec.com/disputes/evidence' \
  -H "Content-Type: application/json" \
  -H "api-key: snd_YOUR_API_KEY" \
  -d '{
  "dispute_id": "dp_1234567890abcdef",
  "customer_name": "John Doe",
  "customer_email_address": "john@example.com",
  "customer_purchase_ip": "203.0.113.42",
  "product_description": "Annual SaaS subscription",
  "service_date": "2024-01-15",
  "receipt": "file_abc123",
  "shipping_carrier": "UPS",
  "shipping_date": "2024-01-16",
  "shipping_tracking_number": "1Z999AA10123456784"
}'

curl -X POST 'https://api.v2.paychtec.com/disputes/evidence' \  -H "Content-Type: application/json" \  -H "api-key: snd_YOUR_API_KEY" \  -d '{  "dispute_id": "dp_1234567890abcdef",  "customer_name": "John Doe",  "customer_email_address": "john@example.com",  "customer_purchase_ip": "203.0.113.42",  "product_description": "Annual SaaS subscription",  "service_date": "2024-01-15",  "receipt": "file_abc123",  "shipping_carrier": "UPS",  "shipping_date": "2024-01-16",  "shipping_tracking_number": "1Z999AA10123456784"}'

Response

{
  "dispute_id": "dp_1234567890abcdef",
  "status": "submitted",
  "evidence_submitted_at": "2024-01-22T14:00:00Z"
}

Errors

Status	When
`400`	Dispute is past its evidence submission deadline, or a referenced file id does not exist.
`404`	Dispute id does not exist.

On this page