Saltar al contenido principal
POST
Disputar un contracargo
Esta solicitud permite a los clientes enviar la documentación de la disputa para la gestión de contracargos, de modo que Yuno reenvíe estos documentos a los emisores correspondientes para su procesamiento. El endpoint responde 201 con una estructura de respuesta de pago estándar que contiene la información actualizada del pago, incluido el estado del contracargo y de la 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.
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 superar 1 MB.
Idioma: la disputa debe estar redactada en inglés o en el idioma local del país.
Ten en cuenta que esta solicitud requiere un X-Idempotency-Key. Consulta la página Authentication para obtener más información.

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

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
account_id
string
requerido

El identificador único de la cuenta (UUID, 36 caracteres).

evidence
object[]
requerido

El objeto de archivos de evidencia

Respuesta

201 - application/json

Evidencia enviada

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