Saltar al contenido principal
PATCH
Copia de Disputar un contracargo
Este endpoint te permite agregar evidencia adicional a una disputa existente después de haberla enviado. Usa este endpoint cuando necesites aportar documentación complementaria para respaldar tu caso de disputa. El pago ya debe tener una transacción de tipo CHARGEBACK en estado CREATED o ADDITIONAL_INFORMATION_REQUIRED. De lo contrario, la API responde 400 INVALID_TRANSACTION. El cuerpo de la solicitud contiene solo el arreglo evidence.
Importante
  • Estado del contracargo: actualizar la evidencia no cambia el estado del contracargo. El estado del contracargo permanece igual, sin importar si se agrega evidencia adicional.
  • Soporte del proveedor: no todos los proveedores de pago admiten actualizar las disputas después de haberlas enviado. Si un proveedor no admite actualizaciones, el endpoint devolverá un error controlado con un código de error en UPPER_SNAKE_CASE (por ejemplo, UPDATE_NOT_SUPPORTED), y el estado del contracargo permanecerá igual.
  • Manejo de errores: si recibes un error 404 que indica que el proveedor no admite el flujo de actualización, el estado del contracargo permanecerá igual, y recibirás una respuesta de error controlado con un código y un mensaje de error descriptivos.
Requisitos de la evidenciaLos archivos cargados deben cumplir los siguientes criterios:Formato: el archivo debe estar en formato PDF, codificado en base64.
Tamaño: el archivo no debe pesar más de 1 MB.
Idioma: la disputa debe estar redactada en inglés o en el idioma local del país.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido
X-Idempotency-Key
string
header
predeterminado:<Your X-Idempotency-Key>
requerido

Encabezados

X-Idempotency-Key
string
requerido

Identificador único que se usa en los encabezados HTTP para garantizar que una solicitud se procese una sola vez, aunque se reintente por problemas de red o timeouts.

Ejemplo:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

Parámetros de ruta

payment_id
string
requerido

El identificador único del pago (UUID, 36 caracteres).

transaction_id
string
requerido

El identificador único de la transacción (UUID, 36 caracteres).

Cuerpo

application/json
evidence
object[]
requerido

El objeto de archivos de evidencia

Respuesta

200 - application/json

200

id
string
Ejemplo:

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

account_id
string
Ejemplo:

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

description
string
Ejemplo:

"Test Purchase"

country
string
Ejemplo:

"AR"

status
string
Ejemplo:

"IN_DISPUTE"

sub_status
string
Ejemplo:

"PENDING_REVIEW"

merchant_order_id
string
Ejemplo:

"65742358"

created_at
string
Ejemplo:

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

updated_at
string
Ejemplo:

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

amount
object
discount_amount
object

El descuento total de la promoción de Yuno aplicada al pago: la suma de las líneas YUNO_PROMOTION de additional_data.order.discounts. No aparece cuando no se aplicó ninguna promoción. El monto cobrado es amount.value menos este valor, y está en transactions.amount. Consulta Promociones.

checkout
any
payment_method
object
customer_payer
object
additional_data
object
transactions
object
transactions_history
any
split_marketplace
object[]
callback_url
string
Ejemplo:

"https://example.com/callback"

workflow
string
Ejemplo:

"DIRECT"

metadata
object[]
fraud_screening
any
Ejemplo:

""

subscription_code
any
routing_rules
object
simplified_mode
boolean
predeterminado:true
Ejemplo:

false