Crear pago
Crea un pago con Yuno. Admite distintos métodos de pago, el guardado de tarjetas en vault y configuraciones de 3DS.
SDK_CHECKOUT (el predeterminado), así que créala primero. No se necesita para los workflows DIRECT o REDIRECT.
amount original y una línea de descuento en additional_data.order.discounts con type: YUNO_PROMOTION y el quote_id de una cotización de promoción. Yuno cobra el precio con descuento, mantiene el amount tal como lo enviaste y devuelve discount_amount. Consulta Promociones. El ejemplo de cotización de promoción necesita que Promotions esté habilitado para tu organización: hasta que Yuno lo habilite, Create Promotion Quote responde 204 y no existe ningún quote_id.capture: false dentro del detalle del método de pago, en el objeto que corresponde al tipo de método de pago: payment_method.detail.card.capture para tarjetas y payment_method.detail.wallet.capture para billeteras que admiten autorización (por ejemplo, PayPal con un billing agreement guardado en vault). Yuno solo lee el indicador en el objeto que corresponde al tipo de método de pago, así que capture: false dentro de card se ignora en un pago con billetera y el pago se captura de inmediato.
Si quieres procesar pagos en un solo paso (autorización y captura al mismo tiempo), envía capture como true en ese mismo objeto.
Para probar en Sandbox todos los resultados posibles de una transacción en Yuno, consulta la documentación de datos de prueba.
Para pagos en dos pasos (autorización y luego captura), envía capture como false como se describe arriba, y luego usa el endpoint Capture Authorization.
Esta solicitud requiere un X-Idempotency-Key. Consulta Autenticación para más detalles.Autorizaciones
Encabezados
Cuerpo
El identificador único de la cuenta. Encuentras este dato en el dashboard de Yuno (UUID, 36 caracteres).
País donde se debe procesar la transacción (MAX 2; MIN 2; ISO 3166-1).
AR, BO, BR, CL, CO, CR, EC, SV, GT, HN, MX, NI, PA, PY, PE, US, UY El workflow del pago. Indica si la integración usa el SDK de Yuno o es una conexión directa. Guías
SDK_CHECKOUT: [Recomendado] Usa el SDK de Yuno.DIRECT: integración directa con la información del proveedor, para una experiencia de pago personalizada.REDIRECT: integración directa con redirección al proveedor.
SDK_CHECKOUT, CHECKOUT, REDIRECT, DIRECT, SDK_SEAMLESS Vincula este pago a una suscripción gestionada en una plataforma de facturación externa. Si está presente en un pago aprobado con una tarjeta guardada en vault, Yuno se hace cargo de los cobros recurrentes de la suscripción. No se puede enviar junto con el objeto subscription (devuelve INVALID_REQUEST). El objeto se devuelve en la respuesta del pago, en Retrieve Payment y en los webhooks del pago.
Vincula este pago a una factura de una plataforma de facturación externa, para que un pago que cobras con Yuno pague esa factura (por ejemplo, una recarga de saldo). Yuno revisa la factura antes de cobrar. Cuando el pago se aprueba, Yuno lo informa en la factura; cuando se rechaza, Yuno registra un intento fallido y la factura sigue abierta. En las facturas puntuales se acepta un monto menor que el saldo pendiente; las facturas de suscripciones que Stripe cobra automáticamente necesitan el monto exacto. No se puede enviar junto con external_subscription ni subscription (devuelve INVALID_REQUEST). El objeto se devuelve en la respuesta del pago, en Retrieve Payment y en los webhooks del pago. Consulta Pay a Stripe invoice (top-ups) para ver las reglas de montos y los códigos de error.
Indica el objeto subscription. Envía exactamente una de tres formas: condiciones en línea (frequency, availability y amount) para crear una suscripción, plan_id para crearla a partir de un plan, o id para cobrar una suscripción existente. Consulta Start a subscription with the first payment.
Respuesta
201
- Pago
- Tarjeta: con datos de la tarjeta
- Tarjeta: con datos de aerolínea
- Tarjeta: con datos del cliente, de facturación y de envío
- Tarjeta: con datos del cliente, de facturación, de envío y artículos del pedido
- Tarjeta: con cuotas
- Tarjeta: con autorización
- Tarjeta: con Merchant Advice Code (MAC)
- Tarjeta: con device fingerprint
- Tarjeta: con vault on success
- Tarjeta: con vaulted token
- Método de pago alternativo
- Tarjeta: con montos de envío, cargos y propina
- Tarjeta: con network token
- Billetera: directa
- Split Marketplace
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.
La factura de una plataforma de facturación externa que paga este pago (una recarga), tal como se envió al crear el pago. La clave aparece en la respuesta solo cuando el pago incluyó external_invoice. Consulta Pay a Stripe invoice (top-ups).