Skip to main content
POST
/
payments
/
{payment_id}
/
transactions
/
{transaction_id}
/
dispute
Dispute a chargeback
curl --request POST \
  --url https://api-sandbox.y.uno/v1/payments/{payment_id}/transactions/{transaction_id}/dispute \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency-Key: <api-key>' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "account_id": "<Your Yuno account_id>",
  "evidence": [
    {
      "content_type": "application/pdf",
      "file_name": "Receipt_AA001",
      "content_category": "RECEIPT",
      "content": "0MTGCjMgMCBvYmoKPDwgL0ZpbHRlcJVBERi0xLjMKJcTl8uXrp/Og ..."
    }
  ]
}
'
{
  "id": "b001d824-3f3f-48fc-98ef-a3114b918c1e",
  "account_id": "210a524f-7ad3-437a-be7e-9e99bdf4d742",
  "description": "Test Purchase",
  "country": "AR",
  "status": "IN_DISPUTE",
  "sub_status": "PENDING_REVIEW",
  "merchant_order_id": "65742358",
  "created_at": "2025-11-26T20:34:08.330622Z",
  "updated_at": "2025-11-26T20:34:12.580560Z",
  "amount": {
    "captured": 0,
    "currency": "ARS",
    "currency_conversion": null,
    "refunded": 0,
    "value": 2000
  },
  "checkout": null,
  "payment_method": {
    "vaulted_token": "",
    "type": "CARD",
    "vault_on_success": false,
    "token": "",
    "parent_payment_method_type": null,
    "payment_method_detail": {
      "card": {
        "verify": false,
        "capture": false,
        "installments": 1,
        "installments_plan_id": null,
        "first_installment_deferral": 0,
        "installments_type": null,
        "installment_amount": null,
        "installments_total_amount": null,
        "soft_descriptor": "",
        "authorization_code": "393119",
        "retrieval_reference_number": "",
        "voucher": null,
        "card_data": {
          "holder_name": "John Diaz",
          "iin": "45130761",
          "lfd": "5348",
          "number_length": 16,
          "security_code_length": 3,
          "brand": "VISA",
          "issuer_name": "BANCOLOMBIA",
          "issuer_code": null,
          "country_code": "CO",
          "category": "CLASSIC",
          "type": "CREDIT",
          "fingerprint": "2213e58a-33d7-4bdc-8cbe-4785f683c410",
          "expiration_month": 6,
          "expiration_year": 26
        },
        "stored_credentials": {
          "reason": null,
          "usage": null,
          "subscription_agreement_id": null,
          "network_transaction_id": null
        }
      }
    }
  },
  "customer_payer": {
    "id": "1b9ef2f7-b69e-4dd0-b0a1-3605dfc2ad2f",
    "merchant_customer_id": "6a1b6e7e0e104f28929015fd6182e9f9",
    "first_name": "Margarita",
    "last_name": "Parra",
    "gender": "NB",
    "date_of_birth": "1952-02-27",
    "email": "qpacheco@example.com",
    "nationality": "AR",
    "ip_address": "205.52.88.44",
    "device_fingerprint": "90ede54c-d2d4-4e2e-8189-6b81091231b0",
    "device_fingerprints": [
      {
        "provider_id": "DEFAULT",
        "id": "90ede54c-d2d4-4e2e-8189-6b81091231b0"
      },
      {
        "provider_id": "CLEAR_SALE",
        "id": "c1c4907c-3339-4217-a4bd-1e9be74b3819"
      },
      {
        "provider_id": "CYBERSOURCE",
        "id": "d5c56387-4d06-479b-b55b-eab81e5211bc"
      },
      {
        "provider_id": "OPENPAY",
        "id": "89451345904503181146447710703990"
      },
      {
        "provider_id": "MERCADO_PAGO",
        "id": "armor.cofxzlvhsrpuslf5ychwxvszwaicsanbuub2on7rfuzmyfijppqm8vcziky3h3emxkz3b2aopl04ublu0jufbtwk8sm232fin19btcnd3q1jdpku6cp9ybn8exc2vcuoalosq51bpfefzhsqx4tuythte5jaruh4keo2fcm9r9wwy96s8djk0e5nmsi8z6pfi7e94tsoe7h09s227umko9kyf4p0xanqn"
      }
    ],
    "browser_info": {
      "user_agent": "Chrome",
      "accept_header": "true",
      "accept_content": "true",
      "accept_browser": "true",
      "color_depth": "red",
      "screen_height": "500",
      "screen_width": "100",
      "javascript_enabled": true,
      "java_enabled": true,
      "browser_time_difference": "-3:00",
      "language": "es",
      "platform": null
    },
    "document": {
      "document_type": "DNI",
      "document_number": "82183204"
    },
    "phone": {
      "number": "91112345678",
      "country_code": "54"
    },
    "billing_address": {
      "address_line_1": "Avenida Putumayo 1780",
      "address_line_2": "Diagonal 181G 6572",
      "country": "AR",
      "state": "Álava",
      "city": "Suárez",
      "zip_code": "25207",
      "neighborhood": "Barrio Núñez"
    },
    "shipping_address": {
      "address_line_1": "Diagonal 61 2487",
      "address_line_2": "Av. carrera 54 7627",
      "country": "AR",
      "state": "Guipúzcoa",
      "city": "San Benito",
      "zip_code": "31718",
      "neighborhood": "Villa La Esperanza"
    },
    "merchant_customer_created_at": "2025-11-26T20:34:06.941Z",
    "geolocation": {
      "latitude": "80.00",
      "longitude": "103.00"
    }
  },
  "additional_data": {
    "airline": {
      "pnr": "ABC123",
      "legs": [
        {
          "order": null,
          "route_order": null,
          "passenger_id": null,
          "departure_airport": "JFK",
          "departure_datetime": "2024-07-03T05:00:00",
          "departure_airport_timezone": "GMT-05",
          "arrival_airport": "LAX",
          "arrival_airport_timezone": "+00:00",
          "arrival_datetime": "2030-07-03T22:59:00",
          "carrier_code": "AA",
          "flight_number": "123",
          "fare_basis_code": "Y",
          "fare_class_code": "S",
          "base_fare": 1800,
          "base_fare_currency": "USD",
          "stopover_code": "O",
          "departure_airport_country": "NL",
          "departure_airport_city": "Amsterdam",
          "arrival_airport_country": "AR",
          "arrival_airport_city": "Buenos aires",
          "expedited_boarding": null,
          "extra_baggage": null,
          "purchased_meals": null,
          "selected_seat": null
        }
      ],
      "passengers": [
        {
          "id": null,
          "first_name": "Antonio",
          "last_name": "Vargas",
          "middle_name": "Piedad",
          "type": "A",
          "date_of_birth": "1999-12-17",
          "nationality": "US",
          "document": {
            "document_type": "DNI",
            "document_number": "82183204"
          },
          "country": "CO",
          "loyalty_number": "79250001",
          "loyalty_tier": "DIAMOND",
          "email": "anaarias@example.com",
          "phone": {
            "number": "91112345678",
            "country_code": "54"
          },
          "address": null,
          "evidence_document_source": null
        },
        {
          "id": null,
          "first_name": "Álvaro",
          "last_name": "Bravo",
          "middle_name": "Edwin",
          "type": "C",
          "date_of_birth": "1973-07-25",
          "nationality": "CO",
          "document": {
            "document_type": "DNI",
            "document_number": "82183204"
          },
          "country": "CO",
          "loyalty_number": "79250002",
          "loyalty_tier": "SILVER",
          "email": "leidysanchez@example.com",
          "phone": {
            "number": "91112345678",
            "country_code": "54"
          },
          "address": null,
          "evidence_document_source": null
        }
      ],
      "type": null,
      "ticket": {
        "ticket_number": "BRB0001",
        "passenger_id": null,
        "e_ticket": true,
        "restricted": false,
        "total_fare_amount": 2000,
        "total_tax_amount": 180,
        "total_fee_amount": 20,
        "issue": {
          "carrier_prefix_code": "AA",
          "travel_agent_code": "A12345",
          "travel_agent_name": "TRAVEL AGENCY",
          "date": "2023-10-31",
          "address": "123 Main St",
          "city": "New York",
          "country": "US",
          "zip_code": "10001",
          "booking_system_code": "1G",
          "booking_system_name": "Galileo"
        }
      },
      "tickets": [
        {
          "ticket_number": "BRB0001",
          "passenger_id": null,
          "e_ticket": true,
          "restricted": false,
          "total_fare_amount": 2000,
          "total_tax_amount": 180,
          "total_fee_amount": 20,
          "issue": {
            "carrier_prefix_code": "AA",
            "travel_agent_code": "A12345",
            "travel_agent_name": "TRAVEL AGENCY",
            "date": "2023-10-31",
            "address": "123 Main St",
            "city": "New York",
            "country": "US",
            "zip_code": "10001",
            "booking_system_code": "1G",
            "booking_system_name": "Galileo"
          }
        }
      ]
    },
    "transportations": null,
    "order": {
      "fee_amount": 1,
      "shipping_amount": 3,
      "tip_amount": 2,
      "items": [
        {
          "id": "97029",
          "name": "SKIRT",
          "quantity": 3,
          "unit_amount": 2000,
          "category": "OTHERS",
          "brand": "Barrera Group",
          "sku_code": "SC-01905",
          "manufacture_part_number": "MPN-70919"
        },
        {
          "id": "61906",
          "name": "SKIRT",
          "quantity": 1,
          "unit_amount": 2000,
          "category": "OTHERS",
          "brand": "Suárez-Castellanos",
          "sku_code": "SC-14444",
          "manufacture_part_number": "MPN-43825"
        }
      ],
      "taxes": [
        {
          "type": "VAT",
          "tax_base": 100,
          "value": 10,
          "percentage": 10
        }
      ],
      "shipping": {
        "type": "ELECTRONIC",
        "description": "q4O6W8x8ONwpbgHjlxlz",
        "carrier": "AR_OCA",
        "deliver_at": "2025-11-26T20:34:07.500866Z",
        "recipients": []
      },
      "account_funding": {
        "sender": {
          "national_entity": null,
          "first_name": "Reinaldo",
          "last_name": "Rojas",
          "legal_name": null,
          "email": null,
          "country": null,
          "date_of_birth": null,
          "document": null,
          "phone": null,
          "address": null
        },
        "beneficiary": {
          "national_entity": null,
          "first_name": "Leidy",
          "last_name": "González",
          "legal_name": null,
          "email": null,
          "country": "AR",
          "date_of_birth": "1983-12-07",
          "document": null,
          "phone": {
            "number": "91112345678",
            "country_code": "54"
          },
          "address": {
            "address_line_1": "Calle 4ª 3050",
            "address_line_2": "Carrera 98 6425",
            "country": "AR",
            "city": "",
            "zip_code": "",
            "neighborhood": "Barrio Colegiales"
          }
        }
      },
      "tickets": [
        {
          "id": "57bfc6e7-c270-4fcc-a578-a76e6eaa4576",
          "name": "Ticket vitae",
          "description": "Description 4I%n",
          "type": "VIRTUAL",
          "amount": {
            "value": 2000,
            "currency": "ARS"
          },
          "event": {
            "id": "3e9d0621-e8ca-4415-9025-95d568cac569",
            "name": "Event doloremque",
            "description": "Description ipsam",
            "type": "CIRCUS",
            "date": "2025-11-26",
            "address": {
              "address_line_1": "Diagonal 33 2395",
              "address_line_2": "Cl. 112E 6497",
              "city": "Paz de Ariporo",
              "country": "AR",
              "state": "Lleida",
              "zip_code": "18124",
              "neighborhood": "Conjunto Los Laureles"
            }
          }
        },
        {
          "id": "f842ae67-2f7d-4415-9d9e-9a51d2712c13",
          "name": "Ticket aspernatur",
          "description": "Description jS3*",
          "type": "VIRTUAL",
          "amount": {
            "value": 2000,
            "currency": "ARS"
          },
          "event": {
            "id": "af726450-abf5-49d1-b43a-9e65f88d606e",
            "name": "Event officia",
            "description": "Description quo",
            "type": "CIRCUS",
            "date": "2025-11-26",
            "address": {
              "address_line_1": "Tr. 194B 459",
              "address_line_2": "Cl. 102L Sur 2950",
              "city": "Moniquirá",
              "country": "AR",
              "state": "Segovia",
              "zip_code": "31278",
              "neighborhood": "Barrio Los Olivos"
            }
          }
        },
        {
          "id": "51100a8e-04ec-45c1-8fea-2fa70a7966d3",
          "name": "Ticket hic",
          "description": "Description mR;2",
          "type": "PHYSICAL",
          "amount": {
            "value": 2000,
            "currency": "ARS"
          },
          "event": {
            "id": "2164fb39-7be3-46aa-adc9-310eb33b4f05",
            "name": "Event hic",
            "description": "Description beatae",
            "type": "SPORTS",
            "date": "2025-11-26",
            "address": {
              "address_line_1": "Av. Pérez 8882",
              "address_line_2": "Carrera 23 5900",
              "city": "Vijes",
              "country": "AR",
              "state": "Zamora",
              "zip_code": "24300",
              "neighborhood": "Barrio El Paraíso"
            }
          }
        },
        {
          "id": "6f465375-0ded-4ac7-848c-39450bff069d",
          "name": "Ticket totam",
          "description": "Description t0}E",
          "type": "VIRTUAL",
          "amount": {
            "value": 2000,
            "currency": "ARS"
          },
          "event": {
            "id": "e564bf42-0385-4ad8-a38a-eb481a434cbf",
            "name": "Event neque",
            "description": "Description facilis",
            "type": "OTHERS",
            "date": "2025-11-26",
            "address": {
              "address_line_1": "Avenida carrera 153 3115",
              "address_line_2": "Cr. 121G Bis 4048",
              "city": "La Ceja",
              "country": "AR",
              "state": "Castellón",
              "zip_code": "39464",
              "neighborhood": "Conjunto Belgrano"
            }
          }
        },
        {
          "id": "b40b5fb7-3a1b-4315-bf01-4ba9b7ef99aa",
          "name": "Ticket esse",
          "description": "Description wI2;",
          "type": "VIRTUAL",
          "amount": {
            "value": 2000,
            "currency": "ARS"
          },
          "event": {
            "id": "a4f1f47f-8853-4ac2-b574-6b05d4a611fd",
            "name": "Event eos",
            "description": "Description natus",
            "type": "CINEMA",
            "date": "2025-11-26",
            "address": {
              "address_line_1": "Cr. 6E Bis 3665",
              "address_line_2": "Carrera 9 Este 1918",
              "city": "Teorama",
              "country": "AR",
              "state": "Madrid",
              "zip_code": "32993",
              "neighborhood": "Villa Las Flores"
            }
          }
        }
      ],
      "fulfillment": null,
      "discounts": [
        {
          "id": "10FF",
          "name": "10% Discount",
          "unit_amount": 10
        }
      ],
      "sales_channel": "marketplace"
    },
    "seller_details": {
      "name": "Mendoza-Cerón",
      "website": "http://navarro.info/category/postsregister.html",
      "email": "iospina@example.net",
      "address": {
        "address_line_1": "Av. calle 5ª 3906",
        "address_line_2": "Dg. 8ª 8965",
        "country": "AR",
        "state": "ARGENTINA",
        "city": "Curití",
        "zip_code": "15484"
      },
      "reference": "39245884",
      "country": "AR",
      "phone": {
        "number": "6844503463",
        "country_code": "23"
      },
      "document": {
        "document_type": "DNI",
        "document_number": "82183204"
      },
      "industry": "ELECTRONICS",
      "merchant_category_code": "6628"
    }
  },
  "transactions": {
    "id": "4a963490-70c2-4669-975a-a6901b4b5abf",
    "type": "CHARGEBACK",
    "status": "CREATED",
    "category": "CARD",
    "amount": 2000,
    "provider_id": "BAMBOO",
    "payment_method": {
      "vaulted_token": "",
      "type": "CARD",
      "vault_on_success": false,
      "token": "",
      "parent_payment_method_type": null,
      "detail": {
        "card": {
          "verify": false,
          "capture": false,
          "installments": 1,
          "installments_plan_id": null,
          "first_installment_deferral": 0,
          "installments_type": null,
          "installment_amount": null,
          "installments_total_amount": null,
          "soft_descriptor": "",
          "authorization_code": "393119",
          "retrieval_reference_number": "",
          "voucher": null,
          "card_data": {
            "holder_name": "Pepito Perez",
            "iin": "45130761",
            "lfd": "5348",
            "number_length": 16,
            "security_code_length": 3,
            "brand": "VISA",
            "issuer_name": "BANCOLOMBIA",
            "issuer_code": null,
            "country_code": "CO",
            "category": "CLASSIC",
            "type": "CREDIT",
            "fingerprint": "2213e58a-33d7-4bdc-8cbe-4785f683c410",
            "expiration_month": 6,
            "expiration_year": 26
          },
          "stored_credentials": {
            "reason": null,
            "usage": null,
            "subscription_agreement_id": null,
            "network_transaction_id": null
          }
        }
      }
    },
    "response_code": "SUCCEEDED",
    "response_message": "CHARGEBACK_CREATED",
    "reason": "REQUESTED_BY_CUSTOMER",
    "description": "webhook transaction",
    "merchant_reference": "Reference-ac04c8a6-78c7-4588-b915-5498455369ef",
    "provider_data": {
      "id": "BAMBOO",
      "transaction_id": "121030201030210312",
      "account_id": "",
      "status": "APPROVED",
      "sub_status": "",
      "status_detail": "",
      "response_message": null,
      "response_code": null,
      "raw_response": null,
      "third_party_transaction_id": null,
      "third_party_account_id": null,
      "iso8583_response_code": null,
      "iso8583_response_message": null,
      "merchant_advice_code": null,
      "merchant_advice_code_message": null,
      "reason_code": null,
      "reason_description": null
    },
    "connection_data": {
      "id": null,
      "name": null
    },
    "created_at": "2025-11-26T20:34:12.529203Z",
    "updated_at": "2025-11-26T20:34:12.559289Z",
    "merchant_advice_code": null,
    "merchant_advice_code_message": null
  },
  "transactions_history": null,
  "split_marketplace": [],
  "callback_url": "https://ibarra.info/tags/apphome.jsp",
  "workflow": "DIRECT",
  "metadata": [
    {
      "key": "explicabo",
      "value": "nihil"
    },
    {
      "key": "quas",
      "value": "veritatis"
    },
    {
      "key": "numquam",
      "value": "placeat"
    },
    {
      "key": "eos",
      "value": "quo"
    },
    {
      "key": "corrupti",
      "value": "eveniet"
    },
    {
      "key": "occaecati",
      "value": "consectetur"
    }
  ],
  "fraud_screening": null,
  "payment_link_id": "",
  "subscription_code": null,
  "routing_rules": {
    "smart_routing": false,
    "monitors": false,
    "condition": {
      "id": 64972,
      "name": null,
      "description": null
    }
  },
  "simplified_mode": false
}

Documentation Index

Fetch the complete documentation index at: https://docs.y.uno/llms.txt

Use this file to discover all available pages before exploring further.

This request enables clients to submit dispute documentation for chargeback management, allowing Yuno to forward these documents to the appropriate issuers for processing. The endpoint returns a standard payment response structure containing the updated payment information, including the chargeback/dispute status.
Evidence requirementsThe uploaded files must meet the following criteria:Format: File must be in PDF format, encoded as base64.
Size: File must be no larger than 1 MB in size.
Language: Dispute should be written in English or the country’s local language.
Note that this request requires an X-Idempotency-Key. Check the Authentication page for more information.

Authorizations

​
public-api-key
string
header
default:<Your public-api-key>
required
​
private-secret-key
string
header
default:<Your private-secret-key>
required
​
X-Idempotency-Key
string
header
default:<Your X-Idempotency-Key>
required

Path Parameters

​
payment_id
string
required

The unique identifier of the payment (UUID, 36 chars).

​
transaction_id
string
required

The unique identifier of the transaction (UUID, 36 chars).

Body

application/json
​
account_id
string
required

The unique identifier of the account (UUID, 36 chars).

​
evidence
object[]
required

The evidence files object

Response

200 - application/json

200

​
id
string
Example:

"b001d824-3f3f-48fc-98ef-a3114b918c1e"

​
account_id
string
Example:

"210a524f-7ad3-437a-be7e-9e99bdf4d742"

​
description
string
Example:

"Test Purchase"

​
country
string
Example:

"AR"

​
status
string
Example:

"IN_DISPUTE"

​
sub_status
string
Example:

"PENDING_REVIEW"

​
merchant_order_id
string
Example:

"65742358"

​
created_at
string
Example:

"2025-11-26T20:34:08.330622Z"

​
updated_at
string
Example:

"2025-11-26T20:34:12.580560Z"

​
amount
object
​
checkout
any
​
payment_method
object
​
customer_payer
object
​
additional_data
object
​
transactions
object
​
transactions_history
any
​
split_marketplace
object[]
​
callback_url
string
Example:

"https://ibarra.info/tags/apphome.jsp"

​
workflow
string
Example:

"DIRECT"

​
metadata
object[]
​
fraud_screening
any
​
payment_link_id
string
Example:

""

​
subscription_code
any
​
routing_rules
object
​
simplified_mode
boolean
default:true
Example:

false