> ## 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.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Códigos de respuesta de contracargos

> Lista los códigos de respuesta de contracargos y su significado por categoría en las redes de tarjetas

Un código de motivo de contracargo es un código alfanumérico corto que asigna el banco emisor para explicar por qué un cliente disputó una transacción. Estos códigos ayudan a los comercios a entender el problema y a responder en consecuencia. Aunque los comercios pueden impugnar los contracargos presentando evidencia, el código de motivo puede cambiar si surge información nueva durante el proceso de disputa. Las principales redes de tarjetas, como Visa, Mastercard, American Express, Discover y Diners, tienen cada una su propio conjunto de códigos de motivo.

La siguiente tabla muestra los posibles códigos de motivo de cada contracargo que encontrarás en cada transacción. Podrás encontrar el `response_code` asociado en el webhook de cada [transacción](https://docs.y.uno/reference/payments/status-and-response-codes/transaction.md#chargebacks-specific-response_codes). Además, en cada transacción de contracargo encontrarás el código de motivo original de los esquemas de tarjetas en los datos de la respuesta.

| **Categoría** | **Response\_code** | **Descripción** |
| :- | :- | :- |
| Fraude | `EMV_LIABILITY_SHIFT_COUNTERFEIT` Fraude por falsificación con traspaso de responsabilidad EMV | El titular de la tarjeta afirma que no autorizó ni participó en una transacción que procesaste. |
| Fraude | `EMV_LIABILITY_SHIFT_NON_COUNTERFEIT_FRAUD` Fraude sin falsificación con traspaso de responsabilidad EMV | El titular de la tarjeta afirma que no autorizó ni participó en una transacción que procesaste. |
| Fraude | `CARD_PRESENT_FRAUD` Otro fraude: entorno con tarjeta presente | El titular de la tarjeta afirma que no autorizó ni participó en una transacción con ingreso manual de datos o desatendida realizada en un entorno con tarjeta presente. |
| Fraude | `NON_CARD_PRESENT_FRAUD` Otro fraude: entorno con tarjeta ausente | El titular de la tarjeta no autorizó ni participó en una transacción realizada en un entorno con tarjeta no presente, como internet, pedido por correo, pedido telefónico y otros. |
| Fraude | `SCHEME_MONITORING_PROGRAM` Otro fraude: programa de monitoreo del esquema | Programa de monitoreo de fraude del esquema |
| Autorización | `NO_AUTHORIZATION` Sin autorización | El comercio no obtuvo una autorización correcta y válida. |
| Autorización | `DECLINED_AUTHORIZATION` Autorización rechazada | La solicitud de autorización recibió una respuesta de rechazo y el comercio completó la transacción. |
| Errores de procesamiento | `LATE_PRESENTMENT` Presentación tardía | La transacción no se envió dentro del plazo requerido. |
| Errores de procesamiento | `INCORRECT_TRANSACTION_CODE` Código de transacción incorrecto | El titular de la tarjeta afirma que el monto convertido del cargo en una transacción internacional es incorrecto. |
| Errores de procesamiento | `INCORRECT_CURRENCY` Moneda incorrecta | El comercio cometió uno o más errores relacionados con la moneda de la transacción. |
| Errores de procesamiento | `INCORRECT_ACCOUNT_NUMBER` Número de cuenta incorrecto | El número de cuenta de la autorización no coincide con el número de cuenta usado en la transacción. |
| Errores de procesamiento | `INCORRECT_AMOUNT` Monto incorrecto | El titular de la tarjeta afirma que el monto que acordó pagar difiere del monto cobrado. |
| Errores de procesamiento | `DUPLICATE_PROCESSING` Procesamiento duplicado o pagado por otros medios | Una misma transacción se procesó dos o más veces. |
| Errores de procesamiento | `INVALID_DATA` Datos no válidos | La autorización se obtuvo con datos no válidos o incorrectos. |
| Disputas de clientes | `PRODUCT_OR_SERVICE_NOT_RECEIVED` Mercancía o servicios no recibidos | El titular de la tarjeta afirma que no recibió la mercancía o los servicios que pidió. |
| Disputas de clientes | `CANCELED_RECURRING_TRANSACTION` Transacción recurrente cancelada | Se procesó una transacción recurrente después de haber sido cancelada. |
| Disputas de clientes | `PRODUCT_OR_SERVICE_ISSUE` Mercancía o servicios distintos a lo descrito o defectuosos | El titular de la tarjeta afirma que los productos no eran como se describieron. |
| Disputas de clientes | `COUNTERFEIT_MERCHANDISE` Mercancía falsificada | Se identificó que la mercancía era falsificada. |
| Disputas de clientes | `MISREPRESENTATION` Declaración engañosa | El banco del titular de la tarjeta recibió un aviso del titular en el que afirma que los términos de venta fueron presentados de forma engañosa. |
| Disputas de clientes | `CREDIT_NOT_PROCESSED` Crédito no procesado | El banco del titular de la tarjeta recibió un aviso del titular en el que afirma que recibió una autorización, un crédito o un comprobante de transacción anulada que no se ha procesado. |
| Disputas de clientes | `PRODUCT_OR_SERVICE_CANCELED` Mercancía o servicios cancelados | El banco del titular de la tarjeta recibió un aviso del titular en el que indica que devolvió la mercancía o canceló los servicios, pero el crédito no aparece en su estado de cuenta. |
| Disputas de clientes | `ORIGINAL_TRANSACTION_NOT_ACCEPTED` Transacción de crédito original no aceptada | El crédito original no fue aceptado. |
| Disputas de clientes | `CASH_TRANSACTION_VALUE` No recepción del efectivo o del valor de la carga | El titular de la tarjeta no recibió el retiro de efectivo completo en un cajero automático. |
| Disputas de clientes | `CUSTOMER_AGREEMENT` Se requiere comprobante de la transacción o del acuerdo del cliente | El emisor solicita al comercio una copia del recibo firmado por el titular de la tarjeta o cualquier otra documentación que verifique el acuerdo del cliente con la compra. Normalmente sirve para verificar una transacción con tarjeta presente que el titular disputa o no reconoce. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.