---
title: "Upsert Dispute Evidence"
method: PUT
path: "/v1/payments/{payment_number}/dispute_evidence"
tags: ["Payments"]
---

# Upsert Dispute Evidence

`PUT /v1/payments/{payment_number}/dispute_evidence`

Create or update dispute evidence for a payment.

## Path parameters

- `payment_number` string, required

## Request body

- DisputeEvidenceUpsert
  - `purchase_used` boolean — Whether the purchased goods were consumed.
  - `used_at` integer — Unix timestamp when the purchased goods were consumed.
  - `usage_id` string — Partner-side identifier of the event where the goods were consumed, e.g. a match, session or quest id. Stored as given and passed through to the dispute evidence package.
  - `comment` string — Free-form note for support.
  - `player_attributes` DisputeEvidencePlayerUpdate
    - `registered_at` integer — Unix timestamp when the player registered in the game. May predate the platform account, so it differs from the user's created_at.
    - `first_login_ip` string — IP address of the player's first login in the game, as reported by the game.
    - `is_verified` boolean — Whether the player's account is verified on the game side. Unrelated to the company account verification in onboarding.

## Response `200`

Successful Response

- DisputeEvidenceRead
  - `id` string, required — The ID of the dispute evidence record.
  - `payment_number` string, required — The payment number the evidence belongs to.
  - `purchase_used` boolean — Whether the purchased goods were consumed.
  - `used_at` integer — Unix timestamp when the purchased goods were consumed.
  - `usage_id` string — Partner-side identifier of the event where the goods were consumed, e.g. a match, session or quest id.
  - `file_ids` string[] — IDs of the uploaded evidence files.
  - `comment` string — Free-form note for support.
  - `modified_at` integer — Unix timestamp when the evidence was last modified.
  - `player_attributes` DisputeEvidencePlayerRead, required
    - `registered_at` integer — Unix timestamp when the player registered in the game.
    - `last_active_at` integer — Unix timestamp of the player's last activity on the platform.
    - `first_login_ip` string — IP address of the player's first login in the game.
    - `is_verified` boolean — Whether the player's account is verified on the game side.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aghanim/aghanim-server-to-server-api/revisions/8662e77bc1e2/schema)