---
title: "Copy of Dispute a chargeback"
method: PATCH
path: "/payments/{payment_id}/transactions/{transaction_id}/dispute"
---

# Copy of Dispute a chargeback

`PATCH /payments/{payment_id}/transactions/{transaction_id}/dispute`

## Path parameters

- `payment_id` string, required
- `transaction_id` string, required

## Request body

- object
  - `account_id` string, required — The unique identifier of the account (UUID, 36 chars).
  - `evidence` object[], required — The evidence files object
    - `file_name` string, required — The name of the documentation sent (MAX 255; MIN 3).
    - `content_type` 'application/pdf', required — The type of the documentation sent by the merchant
    - `content_category` 'CANCEL_POLICY' | 'CUSTOMER_INTERACTION' | 'OTHERS' | 'PAYMENT_DETAIL' | 'PROOF_OF_AUTHENTICITY' | 'PROOF_OF_DELIVERY' | 'PROOF_OF_SERVICE' | 'RECEIPT' | 'REFUND_POLICY' | 'SERVICE_AGREEMENT' | 'TERMS_AND_CONDITIONS', required — The category of the documentation sent by the merchant
    - `content` string, required — The content of the documentation sent by the merchant encoded in base64. Max size: 1MB.

## Response `200`

200

- object
  - `id` string
  - `account_id` string
  - `description` string
  - `country` string
  - `status` string
  - `sub_status` string
  - `merchant_order_id` string
  - `created_at` string
  - `updated_at` string
  - `amount` object
    - `captured` integer
    - `currency` string
    - `currency_conversion` unknown
    - `refunded` integer
    - `value` integer
  - `checkout` unknown
  - `payment_method` object
    - `vaulted_token` string
    - `type` string
    - `vault_on_success` boolean
    - `token` string
    - `parent_payment_method_type` unknown
    - `payment_method_detail` object
      - `card` object
        - `verify` boolean
        - `capture` boolean
        - `installments` integer
        - `installments_plan_id` unknown
        - `first_installment_deferral` integer
        - `installments_type` unknown
        - `installment_amount` unknown
        - `installments_total_amount` unknown
        - `soft_descriptor` string
        - `authorization_code` string
        - `retrieval_reference_number` string
        - `acquirer_reference_number` string
        - `voucher` unknown
        - `card_data` object
          - `holder_name` string
          - `iin` string
          - `lfd` string
          - `number_length` integer
          - `security_code_length` integer
          - `brand` string
          - `issuer_name` string
          - `issuer_code` unknown
          - `country_code` string
          - `category` string
          - `type` string
          - `fingerprint` string
          - `expiration_month` integer
          - `expiration_year` integer
        - `stored_credentials` object
          - `reason` unknown
          - `usage` unknown
          - `subscription_agreement_id` unknown
          - `network_transaction_id` unknown
  - `customer_payer` object
    - `id` string
    - `merchant_customer_id` string
    - `first_name` string
    - `last_name` string
    - `gender` string
    - `date_of_birth` string
    - `email` string
    - `nationality` string
    - `ip_address` string
    - `device_fingerprint` string
    - `device_fingerprints` object[]
      - `provider_id` string
      - `id` string
    - `browser_info` object
      - `user_agent` string
      - `accept_header` string
      - `accept_content` string
      - `accept_browser` string
      - `color_depth` string
      - `screen_height` string
      - `screen_width` string
      - `javascript_enabled` boolean
      - `java_enabled` boolean
      - `browser_time_difference` string
      - `language` string
      - `platform` unknown
    - `document` object
      - `document_type` string
      - `document_number` string
    - `phone` object
      - `number` string
      - `country_code` string
    - `billing_address` object
      - `address_line_1` string
      - `address_line_2` string
      - `country` string
      - `state` string
      - `city` string
      - `zip_code` string
      - `neighborhood` string
    - `shipping_address` object
      - `address_line_1` string
      - `address_line_2` string
      - `country` string
      - `state` string
      - `city` string
      - `zip_code` string
      - `neighborhood` string
    - `merchant_customer_created_at` string
    - `geolocation` object
      - `latitude` string
      - `longitude` string
  - `additional_data` object
    - `airline` object
      - `pnr` string
      - `legs` object[]
        - `order` unknown
        - `route_order` unknown
        - `passenger_id` unknown
        - `departure_airport` string
        - `departure_datetime` string
        - `departure_airport_timezone` string
        - `arrival_airport` string
        - `arrival_airport_timezone` string
        - `arrival_datetime` string
        - `carrier_code` string
        - `flight_number` string
        - `fare_basis_code` string
        - `fare_class_code` string
        - `base_fare` integer
        - `base_fare_currency` string
        - `stopover_code` string
        - `departure_airport_country` string
        - `departure_airport_city` string
        - `arrival_airport_country` string
        - `arrival_airport_city` string
        - `expedited_boarding` unknown
        - `extra_baggage` unknown
        - `purchased_meals` unknown
        - `selected_seat` unknown
      - `passengers` object[]
        - `id` unknown
        - `first_name` string
        - `last_name` string
        - `middle_name` string
        - `type` string
        - `date_of_birth` string
        - `nationality` string
        - `document` object
          - `document_type` string
          - `document_number` string
        - `country` string
        - `loyalty_number` string
        - `loyalty_tier` string
        - `email` string
        - `phone` object
          - `number` string
          - `country_code` string
        - `address` unknown
        - `evidence_document_source` unknown
      - `type` unknown
      - `ticket` object
        - `ticket_number` string
        - `passenger_id` unknown
        - `e_ticket` boolean
        - `restricted` boolean
        - `total_fare_amount` integer
        - `total_tax_amount` integer
        - `total_fee_amount` integer
        - `issue` object
          - `carrier_prefix_code` string
          - `travel_agent_code` string
          - `travel_agent_name` string
          - `date` string
          - `address` string
          - `city` string
          - `country` string
          - `zip_code` string
          - `booking_system_code` string
          - `booking_system_name` string
      - `tickets` object[]
        - `ticket_number` string
        - `passenger_id` unknown
        - `e_ticket` boolean
        - `restricted` boolean
        - `total_fare_amount` integer
        - `total_tax_amount` integer
        - `total_fee_amount` integer
        - `issue` object
          - `carrier_prefix_code` string
          - `travel_agent_code` string
          - `travel_agent_name` string
          - `date` string
          - `address` string
          - `city` string
          - `country` string
          - `zip_code` string
          - `booking_system_code` string
          - `booking_system_name` string
    - `transportations` unknown
    - `order` object
      - `fee_amount` integer
      - `shipping_amount` integer
      - `tip_amount` integer
      - `items` object[]
        - `id` string
        - `name` string
        - `quantity` integer
        - `unit_amount` integer
        - `category` string
        - `brand` string
        - `sku_code` string
        - `manufacture_part_number` string
      - `taxes` object[]
        - `type` string
        - `tax_base` integer
        - `value` integer
        - `percentage` integer
      - `shipping` object
        - `type` string
        - `description` string
        - `carrier` string
        - `deliver_at` string
        - `recipients` object[]
      - `account_funding` object
        - `sender` object
          - `national_entity` unknown
          - `first_name` string
          - `last_name` string
          - `legal_name` unknown
          - `email` unknown
          - `country` unknown
          - `date_of_birth` unknown
          - `document` unknown
          - `phone` unknown
          - `address` unknown
        - `beneficiary` object
          - `national_entity` unknown
          - `first_name` string
          - `last_name` string
          - `legal_name` unknown
          - `email` unknown
          - `country` string
          - `date_of_birth` string
          - `document` unknown
          - `phone` object
            - `number` string
            - `country_code` string
          - `address` object
            - `address_line_1` string
            - `address_line_2` string
            - `country` string
            - `city` string
            - `zip_code` string
            - `neighborhood` string
      - `tickets` object[]
        - `id` string
        - `name` string
        - `description` string
        - `type` string
        - `amount` object
          - `value` integer
          - `currency` string
        - `event` object
          - `id` string
          - `name` string
          - `description` string
          - `type` string
          - `date` string
          - `address` object
            - `address_line_1` string
            - `address_line_2` string
            - `city` string
            - `country` string
            - `state` string
            - `zip_code` string
            - `neighborhood` string
      - `fulfillment` unknown
      - `discounts` object[]
        - `id` string
        - `name` string
        - `unit_amount` integer
      - `sales_channel` string
    - `seller_details` object
      - `name` string
      - `website` string
      - `email` string
      - `address` object
        - `address_line_1` string
        - `address_line_2` string
        - `country` string
        - `state` string
        - `city` string
        - `zip_code` string
      - `reference` string
      - `country` string
      - `phone` object
        - `number` string
        - `country_code` string
      - `document` object
        - `document_type` string
        - `document_number` string
      - `industry` string
      - `merchant_category_code` string
  - `transactions` object
    - `id` string
    - `type` string
    - `status` string
    - `category` string
    - `amount` integer
    - `provider_id` string
    - `payment_method` object
      - `vaulted_token` string
      - `type` string
      - `vault_on_success` boolean
      - `token` string
      - `parent_payment_method_type` unknown
      - `detail` object
        - `card` object
          - `verify` boolean
          - `capture` boolean
          - `installments` integer
          - `installments_plan_id` unknown
          - `first_installment_deferral` integer
          - `installments_type` unknown
          - `installment_amount` unknown
          - `installments_total_amount` unknown
          - `soft_descriptor` string
          - `authorization_code` string
          - `retrieval_reference_number` string
          - `acquirer_reference_number` string
          - `voucher` unknown
          - `card_data` object
            - `holder_name` string
            - `iin` string
            - `lfd` string
            - `number_length` integer
            - `security_code_length` integer
            - `brand` string
            - `issuer_name` string
            - `issuer_code` unknown
            - `country_code` string
            - `category` string
            - `type` string
            - `fingerprint` string
            - `expiration_month` integer
            - `expiration_year` integer
          - `stored_credentials` object
            - `reason` unknown
            - `usage` unknown
            - `subscription_agreement_id` unknown
            - `network_transaction_id` unknown
    - `response_code` string
    - `response_message` string
    - `reason` string
    - `description` string
    - `merchant_reference` string
    - `provider_data` object
      - `id` string
      - `transaction_id` string
      - `account_id` string
      - `status` string
      - `sub_status` string
      - `status_detail` string
      - `response_message` unknown
      - `response_code` unknown
      - `raw_request` object — Obfuscated copy of the request Yuno sent to the provider. Only returned for allowlisted organizations.
      - `raw_response` unknown
      - `third_party_transaction_id` unknown
      - `third_party_account_id` unknown
      - `iso8583_response_code` unknown
      - `iso8583_response_message` unknown
      - `merchant_advice_code` unknown
      - `merchant_advice_code_message` unknown
      - `reason_code` unknown
      - `reason_description` unknown
    - `connection_data` object
      - `id` unknown
      - `name` unknown
    - `created_at` string
    - `updated_at` string
    - `merchant_advice_code` unknown
    - `merchant_advice_code_message` unknown
  - `transactions_history` unknown
  - `split_marketplace` object[]
  - `callback_url` string
  - `workflow` string
  - `metadata` object[]
    - `key` string
    - `value` string
  - `fraud_screening` unknown
  - `payment_link_id` string
  - `subscription_code` unknown
  - `routing_rules` object
    - `smart_routing` boolean
    - `monitors` boolean
    - `condition` object
      - `id` integer
      - `name` unknown
      - `description` unknown
  - `simplified_mode` boolean

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/versions/05b629819b49/schema)
