v2026-11
10 de noviembre de 2026 Payments- Aprobaciones parciales en pagos con tarjeta
Crear pago acepta un nuevo campo opcionalpayment_method.detail.card.partial_approval(valor predeterminadofalse) en compras y autorizaciones con tarjeta; se ignora en verify. Contrue, el pago puede aprobarse por menos deamount.value. Un nuevoamount.authorizeden el objeto de pago, las respuestas de las operaciones y los webhooks de pago devuelve el monto que aprobó el proveedor, neto de cualquier promoción de Yuno y aumentado por las autorizaciones incrementales aprobadas; después de una aprobación parcial, el pago conserva el estado de una aprobación completa, por lo que está aprobado parcialmente cuandoamount.authorizedes menor queamount.valuemenosdiscount_amount(cuando no hay promoción, menor queamount.value). Para un pago aprobado parcialmente, una captura sinamountcapturaamount.authorized, una captura por encima de ese monto se rechaza con400 INVALID_PARAMETERSy los reembolsos se limitan a él. Los pagos enviados sin el campo, o procesados por un proveedor que no admite aprobaciones parciales, se comportan exactamente como antes. Ver también: El objeto de pago, Crear un pago, Capturar autorización
- Número de teléfono del pagador enmascarado para algunos proveedores y países
Donde el enmascaramiento está habilitado para un proveedor y país (debido a normas locales de protección de datos),customer_payer.phone.numberen la respuesta del pago puede devolverse enmascarado, y muestra solo los últimos cuatro dígitos (por ejemplo,*****3456). En el resto de los casos, el número completo se devuelve como antes. Un valor enmascarado no es un número de teléfono válido: no lo envíes de nuevo en solicitudes posteriores (reembolsos, cancelaciones o nuevos pagos). Ver también: El objeto de pago, Consultar pago por ID
v2026-10
19 de octubre de 2026 Payments-
Condiciones de moneda en el enrutamiento con NOT_EQUAL, ONE_OF y NOT_ONE_OF
Las condiciones de enrutamiento aceptanCURRENCYconEQUAL,NOT_EQUAL,ONE_OFoNOT_ONE_OFy las monedas envalues(ISO 4217 en mayúsculas, sin el campocurrency), de modo que un enrutamiento puede coincidir con “la moneda no es USD” o “la moneda es EUR o GBP” a través de la API. Retrieve a Routing y List Routings devuelvenNOT_EQUAL,ONE_OFyNOT_ONE_OFtal como se enviaron;CURRENCYconEQUALse devuelve como la condiciónAMOUNTsolo de moneda. Las condiciones de moneda creadas en el Dashboard sin un monto ahora pueden actualizarse a través de la API. Ver también: Condiciones de enrutamiento -
Grupos de Merchant Advice Code devueltos como
DECLINE_GROUPen la API de enrutamiento
Update a Routing y Create a Routing aceptan una salidaDECLINE_GROUPque hace referencia a un grupo de Merchant Advice Code, el formato que guarda el Dashboard y que devuelve Retrieve a Routing, de modo que un ciclo de obtener y actualizar de esos enrutamientos ya no falla con400 INVALID_ROUTE_CONFIGURATION. El estado se conserva tal como se envió, yDECLINE_GROUPyMAC_CODE_GROUPcoinciden con los rechazos de forma distinta.retry: trueen una entrada de este tipo se acepta solo cuando el enrutamiento almacenado ya reintenta ese grupo. Ver también: Forma del recurso de enrutamiento -
Nonce del proveedor en pagos directos con billetera
POST /v1/paymentsacepta un nuevo campo opcionalpayment_method.detail.wallet.provider_payment_tokenen el flujo de trabajoDIRECT: un nonce de un solo uso del SDK de cliente del proveedor, como un nonce de Braintree PayPal. Yuno lo reenvía a la conexión del proveedor y no lo almacena. Combinado convault_on_success, el pago devuelve unvaulted_token, y las respuestas de creación y de Retrieve Payment devuelven el ID almacenado en la bóveda del proveedor enpayment_method.payment_method_detail.wallet.provider_token(también en Retrieve Payment Method comoprovider.token).wallet.provider_tokense devuelve para los pagosPAYPAL_BRAINTREEcuando Braintree guardó la cuenta en su bóveda, y se omite en caso contrario. El campo se rechaza con400 INVALID_REQUESTen otros flujos de trabajo, cuando está en blanco o cuando se combina con otro token de billetera o de método de pago. Las solicitudes sin este campo se comportan exactamente igual que antes. Ver también: PayPal y Venmo, Crear un pago -
Grupos de resultado, reintento y pasos de acción en la API de enrutamiento
Las salidas de enrutamiento aceptanMAC_CODE_GROUPySUCCEEDED_GROUPjunto conDECLINE_GROUP, hacen referencia a los grupos de la cuenta mediantegroup_idy llevanretrypara intentar una vez más con el mismo proveedor antes del respaldo. Los pasos aceptanactionCAPTURE(conaction_delay) yHOLD_FOR_REVIEWdespués de una salidaAPPROVEDoSUCCEEDED_GROUP, junto conCANCEL. Dos endpoints de solo lectura,GET /v1/routing/decline-groupsyGET /v1/routing/succeeded-groups, listan los grupos de una cuenta. Retrieve a Routing devuelveretry,group_id,group_name,actionyaction_delay, de modo que un ciclo de obtener y actualizar conserva el enrutamiento tal como está configurado en el Dashboard. Ver también: Forma del recurso de enrutamiento, Listar grupos de rechazo, Listar grupos de éxito -
Pasos de fraude, 3DS y enrutamiento inteligente en la API de enrutamiento
Ahora un paso de proveedor informa suprovider_type; los pasos de fraude llevan su configuración (fraud: reglas, listas de bloqueo, listas de permitidos, listas de revisión, preset,report_only) y el resultadoPENDING, en el que pueden ramificarse los pasos de fraude, 3DS y autenticación;REVERTes una acción final después de una verificación de fraude posterior al pago; y un paso de enrutamiento inteligente (provider_id: "SMART_ROUTING"consmart_routing) puede crearse, actualizarse y leerse en los enrutamientos de tarjeta. Junto con las entradas anteriores, un enrutamiento creado en el Dashboard puede leerse y volver a escribirse a través de la API sin pérdidas. Ver también: Forma del recurso de enrutamiento -
Network token y exenciones 3DS por paso de enrutamiento
Los pasos de proveedor de un enrutamiento aceptannetwork_token_onen los proveedores de pago de un enrutamientoCARDythree_d_secure_exemptionsen los proveedores 3DS, los ajustes por paso que el Dashboard ya almacena. Retrieve a Routing los devuelve junto con los campos de solo lecturatimeoutynetwork_token_enablede cada paso de proveedor. Al actualizar, un paso enviado sin uno de estos campos conserva el valor almacenado;network_token_on: falseythree_d_secure_exemptions: []lo borran. Ver también: Forma del recurso de enrutamiento, Exenciones de SCA -
Horarios, límites de volumen, campos adicionales y condiciones solo de moneda en el enrutamiento
Las condiciones de enrutamiento admitenTIME_PERIOD(rango de fechas con recurrencia, días de la semana y una ventana horaria),VOLUME_PAYMENTS_LIMIT(cantidad de pagos o límite de volumen por día, mes o trimestre, conlimit_byypayments_count) yADDITIONAL_FIELD(campos de cliente, dirección, orden, aerolínea y tarjeta porkey). Una condiciónAMOUNTconcurrencyy una listavaluesvacía coincide con cualquier monto en esa moneda. Los campos de horario y límite se devuelven al obtener el enrutamiento y se conservan al actualizar. Ver también: Condiciones de enrutamiento -
ID de recomendación en las transacciones reportadas
POST /v1/reporting/transactionsacepta un nuevo campo opcionalrecommendation_iden cada evento: el valor devuelto porPOST /v1/routing/recommendationspara ese pago, como un UUID v4 en minúsculas. Yuno lo almacena para atribuir el resultado reportado a esa recomendación; no se valida contra las recomendaciones existentes. Los eventos sin este campo se comportan exactamente igual que antes; cualquier otro valor se rechaza por evento conINVALID_EVENTy el mensaje “The field ‘recommendation_id’ must be a UUID.” Ver también: Reportar transacciones fuera de Yuno
v2026-09
14 de septiembre de 2026 Payments-
Iniciación CIT/MIT en las transacciones reportadas
POST /v1/reporting/transactionsacepta un nuevo campo opcionalinitiationen cada evento:CIT(iniciada por el titular de la tarjeta) oMIT(iniciada por el comercio). Yuno lo guarda en el pago reportado y lo usa para construir estadísticas por nivel de iniciación. Los eventos sin este campo se comportan exactamente igual que antes; cualquier otro valor se rechaza por evento conINVALID_EVENTy el mensaje “The field ‘initiation’ must be CIT or MIT.” Ver también: Reportar transacciones fuera de Yuno -
Recomendaciones de enrutamiento por nivel de iniciación
AhoraPOST /v1/routing/recommendationsclasifica a los candidatos en el segmento de la misma iniciación cuandopayment.initiationcoincide con el historial reportado: en cada nivel prueba primero el historial específico de la iniciación y, si no, recurre al nivel completo, de modo que una solicitud sinpayment.initiationdevuelve la misma clasificación que antes. Ver también: Obtener una recomendación de enrutamiento
v2026-08
31 de agosto de 2026 Seguridad-
Modo solo criptograma para la API de criptograma de Network Token
Hay un nuevo campo opcionalinclude_network_token(valor predeterminadotrue) disponible enPOST /v1/network-tokens/cryptograms. Confalse, la respuesta omitenetwork_token.number(DPAN) ynetwork_token.token_datay conserva los metadatos que no equivalen a un PAN, de modo que los comercios sin certificación PCI pueden realizar pagos con network token combinando el criptograma con el PCI Proxy, que resuelve el DPAN en el momento del reenvío. Ver también: Generar un criptograma de network token -
Error explícito para organizaciones sin PCI que solicitan el network token
EnPOST /v1/network-tokens/cryptograms, una organización sin certificación PCI que solicita el network token completo (include_network_tokenentrueu omitido) ahora recibe403 NETWORK_TOKEN_RETURN_NOT_ALLOWEDcon una guía para usar el modo solo criptograma, en lugar del genéricoPCI_MERCHANT_REQUIRED. Ver también: Generar un criptograma de network token
-
BIN de tarjeta en las transacciones reportadas
POST /v1/reporting/transactionsacepta un nuevo campo opcionalpayment_method_details.card.binen los eventosCARD: el BIN de la tarjeta, de exactamente 6 u 8 dígitos. Yuno lo guarda en el pago reportado y lo usa para construir estadísticas por BIN. Los eventos sin este campo se comportan exactamente igual que antes; un valor que no tenga 6 u 8 dígitos se rechaza por evento conINVALID_EVENT. Ver también: Reportar transacciones fuera de Yuno -
Recomendaciones de enrutamiento por BIN
AhoraPOST /v1/routing/recommendationsclasifica a los candidatos en el segmento del BIN cuandopayment.payment_method.details.card.bincoincide con el historial reportado (primero el BIN de 8 dígitos y luego el de 6) y, si no, recurre a los segmentos de país y método de pago, de modo que un BIN sin historial devuelve la misma clasificación que antes. Ver también: Obtener una recomendación de enrutamiento
v2026-07
11 de julio de 2026 Seguridad- PCI Proxy
Ahora puedes enviar datos de tarjetas almacenadas a cualquier API de terceros a través del entorno PCI DSS Nivel 1 de Yuno, mediante el nuevo endpoint/v1/pci-proxy/forward, sin incorporar tus sistemas al alcance de PCI. Ver también: Resumen de PCI Proxy
v2025-06
30 de junio de 2025- Nombre y apellido opcionales para los clientes
Los camposfirst_nameylast_nameahora son opcionales al crear un cliente mediante la API. Si un proveedor de pagos los requiere, el formulario del SDK se los pedirá al usuario. Si no usas el SDK de Yuno, asegúrate de enviar estos campos al crear el pago cuando el proveedor los requiera. Ver también: Referencia de Crear un cliente
- Compatibilidad con exenciones de SCA en 3DS
Hay un nuevo campo opcionalstrong_customer_authentication_exemptionsdisponible enpayment_method.detail.card.three_d_secure. Además, Yuno propaga las recomendaciones de exención de tu proveedor de fraude a lo largo de toda la ruta de pago hasta el gateway 3DS, y el tipo de exención aparece en la respuesta del pago, en la API GET y en los webhooks. Ver también: Guía de exenciones de SCA
-
Campo de tipo de viaje de aerolínea
Se agregó un nuevo campo enumtypedentro deadditional_data.airlinepara especificar el tipo de viaje:ONE_WAY,ROUNDTRIPoMULTIPLE_DESTINATIONS. No se requieren cambios en la integración si no usas datos de aerolínea. Ver también: Referencia de Crear un pago -
Campos de orden de tramos de aerolínea
Se agregaron dos nuevos campos enteros,orderyroute_order, dentro deadditional_data.airline.legspara describir el orden de los tramos dentro de una ruta y entre rutas, respectivamente. No se requieren cambios en la integración si no usas datos de tramos de aerolínea. Ver también: Referencia de Crear un pago -
Estructura de datos de transporte
Hay un nuevo arreglotransportationsde objetos disponible dentro deadditional_datapara reservas de viaje que no son de aerolínea, como autobús, tren, barco, tranvía y automóvil. Cada entrada admite los subobjetos legs, passengers y tickets con detalles de salida y llegada. Ver también: Referencia de Crear un pago
v2025-05
31 de mayo de 2025 Seguridad- Inscripción de network tokens para tarjetas guardadas en la bóveda
Cuando la funcionalidad de network tokens está habilitada, Yuno ahora genera network tokens para todas las tarjetas inscritas y almacenadas en la bóveda. Las tarjetas de un solo uso quedan excluidas. Esto se alinea con los estándares de tokenización de red de Visa y Mastercard y mejora la seguridad y la confiabilidad de los pagos recurrentes. Ver también: Guía de network tokens
- Control de la fecha de facturación de la suscripción
Hay una nueva estructurabilling_datedisponible al crear una suscripción, que te permite definir el momento de la facturación comoPREPAID,POSTDATEo unDAYespecífico del mes. Este campo es mutuamente excluyente con el objetofrequency. Ver también: Guía de suscripciones
- Campo de fecha de vencimiento del método de pago
Ahora se devuelve un nuevo campo de marca de tiempoexpirates_atdentro depayment_method_detail.walletpara los métodos de pago asíncronos que lo admiten. La disponibilidad depende de la compatibilidad del proveedor. Ver también: Referencia de Crear un pago
expirates_at en la respuesta de wallet
expirates_at en la respuesta de wallet
- Geolocalización del cliente en los pagos
Ahora hay un nuevo objetogeolocationcon los camposlatitudeylongitudedisponible dentro decustomer_payeral crear un pago. Ver también: Referencia de Crear un pago
geolocation en customer_payer
geolocation en customer_payer
- Cancelar pagos APM en estado PENDING
Ahora puedes cancelar mediante el endpoint de cancelación un pagoPENDINGcreado con un método de pago alternativo (APM). Antes esto estaba restringido solo a las transacciones con tarjeta. La disponibilidad de la funcionalidad depende de la compatibilidad del proveedor. Ver también: Referencia de Cancelar un pago
- Compatibilidad con URL de webhook para suscripciones
Ahora puedes definir unwebhook_urlen la sección Developers del Dashboard para recibir los eventos del ciclo de vida de las suscripciones. Los distintos tipos de evento producen payloads de webhook distintos. Ver también: Documentación de webhooks
v2025-04
30 de abril de 2025 Seguridad- Servicio de setup de 3DS eliminado
Ya no se requiere la llamada separada al servicio de setup para la implementación directa de 3DS. La recopilación de datos y el setup ahora se manejan automáticamente dentro de la creación del pago, lo que simplifica el flujo de integración. Ver también: Guía de 3D Secure
- Campos extendidos de tramos de aerolínea
Se agregaron nuevos campos dentro deadditional_data.airline.legs:arrival_airport_country,arrival_airport_city,departure_airport_countryydeparture_airport_city. Además, ahora hay unbooking_system_codey unbooking_system_namedisponibles dentro deairline.tickets[].issue. No se requieren cambios en la integración si no usas datos de aerolínea. Ver también: Referencia de Crear un pago
Tramos de aerolínea con nuevos campos
Tramos de aerolínea con nuevos campos
v2025-03
31 de marzo de 2025 Payments- Arreglo de descuentos en los datos de la orden
Hay un nuevo arreglodiscountsde objetos disponible dentro deadditional_data.order. Cada descuento admite los camposid,nameyunit_amount. Ver también: Guía de detalles del monto del pago
discounts en additional_data.order
discounts en additional_data.order
- Indicador de monitores en las reglas de enrutamiento
Se agregó un nuevo campo booleanomonitorsdentro del objetorouting_rulesen la respuesta del pago, que indica si una transacción se procesó mediante la función Monitors. No se requieren cambios en la integración. Ver también: Referencia del objeto de pago
monitors en la respuesta de routing_rules
monitors en la respuesta de routing_rules
- Información del cliente en solicitudes de reembolso
Las solicitudes de reembolso ahora aceptan un nuevo objetocustomer_payer, que te permite enviar datos adicionales del cliente (por ejemplo,document) a los proveedores que los requieren. Ver también: Referencia de reembolso de pago
customer_payer en la solicitud de reembolso
customer_payer en la solicitud de reembolso
v2025-02
28 de febrero de 2025 Webhooks-
Autenticación OAuth2 para webhooks
Los webhooks ahora admiten autenticación OAuth2. Configuraauthentication_url,client_secret_key,client_idygrant_typeen la sección Developers/Webhooks del dashboard para que Yuno pueda obtener tokens y entregar los webhooks de forma segura. Ver también: Guía de configuración de webhooks -
URL dedicada para webhooks de contracargos
Ahora puedes configurar una URL de webhook dedicada específicamente para los eventos de contracargo. Antes, los contracargos se enviaban junto con el trigger Purchase. Actualiza la configuración de tus webhooks en el dashboard para usar la nueva URL dedicada de contracargos. Ver también: Guía de configuración de webhooks
v2025-01
31 de enero de 2025 Payments- Datos de boletos en las órdenes de pago
Un nuevo arreglo de objetosticketsestá disponible dentro deadditional_data.order, con campos comoid,name,description,type,amounty un objeto anidadoeventcon los detalles de la dirección. Ver también: Referencia de la API de pagos
tickets en additional_data.order
tickets en additional_data.order
- Validación del pago inicial de la suscripción
Un nuevo campo booleanoinitial_payment_validationestá disponible al crear una suscripción. Configúralo entruepara continuar la suscripción solo después de un primer pago exitoso, o enfalsepara continuar sin importar el resultado del primer pago. Ver también: Referencia de creación de suscripción
initial_payment_validation en la suscripción
initial_payment_validation en la suscripción
v2024-12
31 de diciembre de 2024 Payments- Selección del tipo de tarjeta para tokens de la bóveda
Al usar un token almacenado en la bóveda para un pago, ahora puedes especificarcard_data.typecomoCREDIToDEBITdentro depayment_method.detail.card. Es útil en mercados como Brasil, donde la misma tarjeta puede usarse para ambos tipos de transacción. Ver también: Referencia de la API de pagos
Especificar DEBIT o CREDIT para un token de la bóveda
Especificar DEBIT o CREDIT para un token de la bóveda
- Detalles de la transacción de fondeo de cuenta
Un nuevo objetoaccount_fundingestá disponible dentro deadditional_data, con los subobjetossenderybeneficiaryque incluyen los campos de nombre, correo electrónico y documento requeridos para las transacciones de fondeo de cuenta (AFT). Ver también: Guía de AFT
account_funding en additional_data
account_funding en additional_data
- ID de transacción de red para credenciales almacenadas
Un nuevo camponetwork_transaction_idestá disponible dentro depayment_method.detail.card.stored_credentials. Se recomienda para pagos de suscripciones con tarjetas inscritas, para garantizar la trazabilidad durante todo el ciclo de vida del pago. Ver también: Guía de credenciales almacenadas
network_transaction_id en stored_credentials
network_transaction_id en stored_credentials
- Indicador de enrutamiento inteligente en la respuesta del pago
Se agregó un nuevo campo booleanosmart_routingdentro del objetorouting_rulesen la respuesta del pago, que indica si la transacción se procesó mediante la función de enrutamiento inteligente. No se requieren cambios en la integración. Ver también: Referencia de la API de pagos
smart_routing en la respuesta de routing_rules
smart_routing en la respuesta de routing_rules
- Periodo de prueba para suscripciones
Un nuevo objetotrial_periodestá disponible al crear una suscripción. Definebilling_cyclesy unamountreducido para ofrecer periodos de prueba parciales o totales (gratuitos) antes de que comience la facturación completa. Ver también: Referencia de creación de suscripción
trial_period en la solicitud de suscripción
trial_period en la solicitud de suscripción
v2024-11
30 de noviembre de 2024 Payments- Campos de vencimiento de la tarjeta en la respuesta de la transacción
Ahora se devuelven dos campos nuevos,expiration_monthyexpiration_year, dentro detransactions.card_dataen la respuesta del pago. No se requieren cambios en la integración. Ver también: Referencia del objeto de pago
expiration_month y expiration_year en card_data
expiration_month y expiration_year en card_data
- Destinatarios para pagos divididos en marketplace
Una nueva API de destinatarios (Recipients) te permite registrar destinatarios con varias asignaciones de proveedores antes de enviar pagos divididos. Usarecipient_iden el arreglosplit_marketplaceen lugar de los IDs específicos de cada proveedor cuando intervienen varios proveedores. Ver también: Guía de pagos divididos en marketplace
Usar recipient_id en split_marketplace
Usar recipient_id en split_marketplace
- Compatibilidad con comprobantes en transacciones de reembolso
Las solicitudes de reembolso ahora aceptan un booleanoresponse_additional_data.receipty un campo opcionalreceipt_language. Cuando se configuran, se devuelve una URL del comprobante enpayment.transaction.receipt_urldespués de procesar el reembolso. Ver también: Referencia de reembolso de pago
Solicitar un comprobante en un reembolso
Solicitar un comprobante en un reembolso
- Datos de artículos para suscripciones
Ahora hay un nuevo arregloadditional_data.order.itemsdisponible al crear una suscripción, que te permite enviar a los proveedores detalles a nivel de artículo (category, id, name, quantity, unit_amount). Ver también: Referencia de creación de suscripción
items en additional_data de la suscripción
items en additional_data de la suscripción
- Payouts a tokens almacenados en la bóveda
La API de Payouts ahora permite enviar payouts directamente a tarjetas de crédito o débito inscritas, mediante unvaulted_tokendentro dewithdrawal_method. Requiere compatibilidad del proveedor. Ver también: Referencia de creación de payout
Payout a una tarjeta inscrita
Payout a una tarjeta inscrita
v2024-10
31 de octubre de 2024 Suscripciones- Esquema de reintentos inteligentes para suscripciones
Las transacciones rechazadas de suscripciones ahora admiten reintentos inteligentes (Smart Retries), que usan aprendizaje automático para determinar el momento óptimo de cada reintento. El calendario de reintentos consta de siete intentos en 96 horas. Se configura desde el dashboard de Suscripciones. Ver también: Guía de reintentos de transacciones
- Campo del tipo de método de pago principal
Se devuelve un nuevo campoparent_payment_method_typedentro detransactions.payment_method, que indica el proveedor de billetera (APPLE_PAY,GOOGLE_PAYoCLICK_TO_PAY) usado en una integración directa de billetera. No se requieren cambios en la integración. Ver también: Referencia del objeto de pago
parent_payment_method_type en la transacción
parent_payment_method_type en la transacción
- ID de conexión en los datos de la transacción
Se devuelve un nuevo campoconnection_data.iddentro de cada objeto de transacción, con el identificador único de la conexión de pago usada para procesar la transacción. No se requieren cambios en la integración. Ver también: Referencia del objeto de pago
connection_data.id en la transacción
connection_data.id en la transacción
- Compatibilidad con comprobantes en transacciones de cancelación
Las solicitudes de cancelación ahora aceptan un booleanoresponse_additional_data.receipt. Cuando se configura, se devuelve una URL del comprobante enpayment.transaction.receipt_urldespués de procesar la cancelación. Ver también: Referencia de Cancelar un pago
Solicitar un comprobante en una cancelación
Solicitar un comprobante en una cancelación
- Objeto de envío en la solicitud de pago
Un nuevo objetoshippingestá disponible al crear un pago, con los campostype,description,carrierydeliver_atpara especificar los detalles del envío. Ver también: Referencia del objeto de pago
shipping en la solicitud de pago
shipping en la solicitud de pago
v2024-09
30 de septiembre de 2024 Payments-
Flujo de inscripción con enlaces de pago
Los enlaces de pago ahora admiten la inscripción de tarjetas tras un pago exitoso. Configuraone_time_use=trueyvault_on_success=trueal crear un enlace de pago para generar un nuevovaulted_tokenpara el cliente cuando el pago sea exitoso. Ver también: Guía para inscribir tarjetas con enlaces de pago -
Pagos divididos en marketplace
Un nuevo arreglosplit_marketplaceestá disponible en la solicitud de pago, que permite a los comercios dividir un pago entre varios destinatarios con montos, tipos (PURCHASE,COMMISSION) y configuraciones de responsabilidad personalizables. Requiere compatibilidad del proveedor. Ver también: Guía de split marketplace
split_marketplace en la solicitud de pago
split_marketplace en la solicitud de pago
v2024-08
31 de agosto de 2024 Suscripciones- Campo de ID del acuerdo de suscripción
Un nuevo camposubscription_agreement_idestá disponible dentro depayment_method.detail.card.stored_credentials. Algunos mercados y procesadores (por ejemplo, México) lo requieren para incluir el ID del acuerdo con el cliente en los pagos relacionados con suscripciones. Ver también: Guía de credenciales almacenadas
subscription_agreement_id en stored_credentials
subscription_agreement_id en stored_credentials
- Payouts referenciados a partir de transacciones
Los payouts a métodos de pago con tarjeta ahora admiten un campooriginal_transaction_iddentro dewithdrawal_method, que permite a los comercios iniciar un payout con los datos de tarjeta de una transacción anterior sin necesidad de cumplir con PCI. Ver también: Guía de Payouts
Payout que referencia una transacción original
Payout que referencia una transacción original
- Conversión de moneda en los pagos
Un nuevo objetocurrency_conversionestá disponible dentro de la estructuraamount, que te permite enviarprovider_currency_conversion_id,cardholder_currencyycardholder_amountpara la liquidación en dos monedas. Contacta a tu gerente técnico de cuenta para habilitarlo. Ver también: Guía de conversión de moneda
currency_conversion en amount
currency_conversion en amount
- Código y mensaje de respuesta ISO 8583
Ahora se devuelven dos campos nuevos,iso8583_response_codeyiso8583_response_message, dentro detransactions.provider_data, con la respuesta ISO 8583 directa del proveedor. Los códigos ABECS también se incluyen en estos campos para los proveedores de Brasil. Ver también: Referencia del objeto de pago
Campos iso8583 en provider_data
Campos iso8583 en provider_data
-
Cancelar o reembolsar un pago por ID de pago
Un nuevo endpoint te permite cancelar o reembolsar un pago enviando solo elpayment_id, sin necesidad deltransaction_id. El endpoint existente a nivel de transacción sigue disponible. Ver también: Referencia de cancelación o reembolso de pago -
El historial de transacciones pasa a ser opcional
El arreglotransactions_historydel objeto de pago ahora se completa solo cuando el pago se crea conresponse_additional_data.transactions_history: true. Cuando no se envía el indicador, los webhooks y las respuestas de pago entregantransactions_historycomo un arreglo vacío[]para mantener pequeño el tamaño de los payloads. Los eventos de contracargo siguen incluyendo automáticamente el historial completo. Ver también: Referencia del objeto de pago · Objeto webhook y ejemplos
v2024-07
31 de julio de 2024 Payments-
Criptograma de billetera para pagos nativos
Un nuevo campocryptogramestá disponible dentro depayment_method.detail.walletal crear un pago, lo que habilita integraciones directas con las API de Apple Pay y Google Pay sin usar el Yuno SDK. Ver también: Guía de integración directa de Apple Pay -
Arreglo de impuestos en los datos de la orden
Un nuevo arreglo de objetostaxesestá disponible dentro deadditional_data.order, que admite varias líneas de impuestos por pago. El objetotaxanterior de nivel superior sigue siendo compatible, pero se recomienda el nuevo arreglo para una mejor gestión de impuestos. Ver también: Guía de detalles del monto del pago
- Modo simplificado para reintentos de reembolso
El indicadorsimplified_mode: trueahora es compatible en las solicitudes de reembolso. Yuno devolverá el estadoDECLINEDy reintentará el reembolso automáticamente hasta cinco veces en 24 horas, manteniendo el pago en estadoPENDING/RETRY_IN_PROCESS. Ver también: Guía de reintentos de transacciones
simplified_mode en la solicitud de reembolso
simplified_mode en la solicitud de reembolso
v2024-06
30 de junio de 2024 Payouts- Lanzamiento del producto Payouts
Yuno Payouts ya está disponible como un nuevo producto de API para enviar fondos a beneficiarios (usuarios, comercios, proveedores, clientes) a través de bancos, tarjetas y billeteras, mediante varios proveedores. Consulta la documentación de Payouts para comenzar. Ver también: Guía de Payouts
- Campo fingerprint del método de pago
Se devuelve un nuevo campofingerprinten el objeto del método de pago y en la respuesta del pago para transacciones con tarjeta. Identifica de forma única una tarjeta entre variosvaulted_tokensdentro de tu organización. Ver también: Guía para inscribir métodos de pago
v2024-05
31 de mayo de 2024 Payments- Modo simplificado para reintentos de captura
Un nuevo booleanosimplified_modeestá disponible en las solicitudes de captura. Cuando se configura entrue, Yuno devuelve de inmediato el estadoSUCCEEDEDy reintenta automáticamente las transacciones fallidas hasta cinco veces en un periodo de 24 horas. Ver también: Guía de reintentos de transacciones
simplified_mode en la solicitud de captura
simplified_mode en la solicitud de captura
- Campo de tipo de beneficio para pagos con Pluxee
Se agregó un nuevo campobenefity_typeal objeto de pago para el método de pago Pluxee en Chile. Es obligatorio al usar el flujoDIRECT. Ver también: Referencia del objeto de pago
v2024-04
30 de abril de 2024- Reglas de enrutamiento en la respuesta del pago
Ahora se devuelve un nuevo objetorouting_rulesen la respuesta del pago, con un subobjetoconditionque contiene elid, elnamey ladescriptionde la regla de enrutamiento aplicada durante la creación del pago. No se requieren cambios en la integración. Ver también: Referencia del objeto de pago
routing_rules en la respuesta del pago
routing_rules en la respuesta del pago
v2024-03
31 de marzo de 2024 Payments-
Campo de fecha de creación del cliente en el comercio
Un nuevo campomerchant_customer_created_at(formato ISO 8601) está disponible en los objetos Customer ycustomer_payer, y representa la fecha en que el cliente se registró en la plataforma del comercio. Ver también: Referencia del objeto de cliente -
Plan de cuotas en la sesión de checkout
Un nuevo arregloinstallments.plany un nuevo campoinstallments.plan_idestán disponibles en el objeto de sesión de checkout, que te permiten especificar un plan de cuotas personalizado por sesión. Si se omiten, se usa el plan a nivel de cuenta. Ver también: Referencia de creación de sesión de checkout -
URL de callback para enlaces de pago
Un nuevo campocallback_urlestá disponible al crear un enlace de pago, y especifica la URL a la que se redirige al cliente después de completar el pago. Ver también: Referencia del objeto de enlace de pago
v2024-02
29 de febrero de 2024- Campo de barrio en los objetos de dirección
Se agregó un nuevo camponeighborhood(de 3 a 255 caracteres) ashipping_addressybilling_addressen el objeto Customer. Ver también: Referencia del objeto de cliente
-
Arreglo del historial de transacciones
Ahora se devuelve un nuevo arreglotransactions_historyen el objeto de pago, que enumera todas las transacciones asociadas con un pago, incluidas las de varias rutas de proveedores. Ver también: Referencia del objeto de pago -
Campo de propina en los datos de la orden
Un nuevo campotip_amountestá disponible dentro deadditional_data.order. Es solo informativo: la propina ya está incluida en el valor total de la transacción y no se suma por separado. Ver también: Guía de detalles del monto del pago
tip_amount en additional_data.order
tip_amount en additional_data.order
- Mensaje de error de captura en curso
Ahora la API devuelve una respuesta de error específica cuando se intenta una captura mientras otra captura ya está en curso:INVALID_STATUScon el mensaje “Invalid transaction status. Transaction already in progress”. No se requieren cambios en la integración. Ver también: Referencia del objeto de pago
Respuesta de error INVALID_STATUS
Respuesta de error INVALID_STATUS
v2024-01
31 de enero de 2024- Campos de datos del proveedor en la transacción
Ahora se devuelven tres campos nuevos dentro detransactions.provider_data:response_code(código de resultado del proveedor),third_party_account_id(ID de cuenta del procesador) ythird_party_transaction_id(ID de transacción del procesador). No se requieren cambios en la integración. Ver también: Referencia del objeto de pago
- Compatibilidad con credenciales almacenadas
Yuno ahora admite las reglas de credenciales almacenadas de Visa y Mastercard, lo que permite a los comercios marcar los pagos como transacciones iniciadas por el cliente (CIT) o transacciones iniciadas por el comercio (MIT) mediante la estructurastored_credentialsdentro depayment_method.detail.card. Ver también: Guía de credenciales almacenadas