Saltar al contenido principal
Este objeto representa el pago creado después de generar la sesión de checkout para un cliente. Para reembolsar un pago, consulta Reembolsar pagos y la API Reembolsar pago.
Metadatos y lógica de enrutamientoLas reglas de enrutamiento leen los metadatos del pago, combinados con los metadatos de su cliente. Para definir la lógica de enrutamiento, establece metadatos en el pago o en el cliente. Los metadatos establecidos solo en la sesión de checkout no llegan al enrutamiento del pago; en la sesión, solo determinan qué métodos de pago y cuotas lista la sesión.
string
El identificador único del cliente (MAX 64 ; MIN 36).Ejemplo: 8546df3a-b83e-4bb5-a4b3-57aa6385924f
string
El identificador único de la cuenta (MAX 64; MIN 36).Ejemplo: 9104911d-5df9-429e-8488-ad41abea1a4b
string
La descripción del pago (MAX 255; MIN 3).Ejemplo: Purchase on web
enum
País donde se debe procesar la transacción (MAX 2; MIN 2; ISO 3166-1 ).Valores posibles del enum: consulta la referencia de países.
enum
El estado de la transacción.Ejemplo: SUCCEEDED
enum
Es un complemento de la información del estado.Ejemplo: DECLINED
string
El identificador único de la orden del cliente (MAX 255; MIN 3).Ejemplo: 0000023
timestamp
La fecha y la hora en que se creó el pago.Ejemplo: 2022-05-09T20:46:54.786342Z
timestamp
La fecha y la hora de la última actualización del pago.Ejemplo: 2022-05-09T20:46:54.786342Z
string
opcionalLa clave de idempotencia enviada al crear el pago; está presente cuando el pago se creó con una clave de idempotencia.Ejemplo: fc0d89a1-8d18-4759-8d0a-ee1c6d0386e2
string
opcionalEl código de cuenta asociado al pago (identificador de la cuenta).Ejemplo: 26a6626c-d3ec-4caa-bf7c-a994b145dc00
opcionalEstá presente cuando el pago se creó mediante un enlace de pago; identifica el enlace de pago utilizado.Ejemplo: (cadena vacía cuando no proviene de un enlace de pago)
string | null
opcionalEstá presente cuando el pago está asociado a una suscripción; el identificador de la suscripción.Ejemplo: null
string
opcionalEl id del plan en el que estaba la suscripción cuando se creó este pago. Está presente solo en un pago creado con subscription.plan_id y en los pagos de renovación que Yuno genera para esa suscripción. Está ausente en cualquier otro pago. Consulta Crear una suscripción a partir de un plan.Ejemplo: 14898a9d-5a75-433d-ba17-f2ea5b33620c
string
opcionalCuándo se asignó el plan a la suscripción, en UTC (ISO 8601). Está presente solo en los pagos que incluyen plan_id.Ejemplo: 2026-09-24T22:53:42.814482Z
boolean
opcionalIndica si el pago se creó en modo simplificado (por ejemplo, en ciertos flujos como suscripción o reintento).Ejemplo: false
object
Especifica el objeto de monto del pago, con el valor y la moneda.
object
opcionalEl descuento total de la promoción de Yuno aplicada al pago: la suma de las líneas YUNO_PROMOTION de additional_data.order.discounts. Está ausente cuando no se aplicó ninguna promoción. El monto cobrado es amount.value menos este valor, y aparece en transactions.amount. Consulta Promociones.
object
Especifica el objeto de checkout. Este objeto no es obligatorio para los pagos back to back. Es obligatorio cuando WORKFLOW se define como CHECKOUT o no se envía. No es obligatorio para los pagos DIRECT.
array of objects
Especifica una lista de pares clave-valor personalizados asociados al pago (para referencias internas, segmentación o etiquetas de flujo de trabajo). Puedes agregar hasta 120 objetos de metadatos.
object
Especifica el objeto payment_method.
object
Especifica el objeto de cliente para los pagos.
object
La selección de envío asociada al pago. Está presente solo cuando el pago tiene una, por ejemplo, cuando el cliente elige una dirección de envío guardada y un método de entrega dentro de un widget de wallet (Fast Checkout shipping). La clave se omite cuando el pago no tiene selección de envío. Se devuelve en GET /payments/{id} y en los webhooks de pago. En POST /payments está presente solo en los flujos de one-time token donde el token ya incluye la selección; en Fast Checkout la selección llega después de la creación, mediante la notificación del proveedor.
object
Especifica el objeto additional_data. Este objeto no es obligatorio. Sin embargo, si envías esta información, la experiencia de pago de tu usuario mejorará.
object
Especifica los detalles de la transacción asociados a un pago. Retrieve Payment los devuelve como un arreglo, con una entrada por transacción.
array of objects
Arreglo de objetos de split marketplace
array of objects
La lista de las transacciones que forman parte de un pago, una entrada por intento, por lo que depende de cuántos proveedores probó la ruta de tu método de pago. Este arreglo es opcional: se completa solo cuando el pago se creó con response_additional_data.transactions_history: true; de lo contrario, se devuelve como un arreglo vacío []. Los eventos de contracargo siempre incluyen el historial completo.
enum
El flujo de trabajo del pago. Indica si la integración usará el SDK de Yuno o será una conexión directa (back to back) (la implementación con tarjeta solo está disponible para comercios con cumplimiento PCI).Valores posibles del enum:
  • SDK_CHECKOUT: Usa Yuno SDK.
  • DIRECT: Integración directa (back to back) con la información del proveedor para una experiencia de pago personalizada.
  • REDIRECT: Integración directa (back to back) con redirección al proveedor.
string
La URL a la que se redirige al cliente después del pago. Solo es obligatoria para las integraciones DIRECT que tienen una redirección (MAX 526; MIN 3).Ejemplo: https://www.company.com/customer_1231324
array of objects
Especifica una lista de pares clave-valor personalizados asociados al pago (para referencias internas, segmentación o etiquetas de flujo de trabajo). Puedes agregar hasta 120 objetos de metadata.
array of objects
Devuelve la información de las reglas de enrutamiento durante la creación del pago.
string
El identificador único de la suscripción asociada al pago (MAX 64 ; MIN 36).Ejemplo: 7304911d-5df9-429e-8488-ad41abea1a4c
struct
Devuelve los detalles de la suscripción asociada al pago.
array of objects
Proporciona información sobre los análisis de fraude utilizados para el pago.