Skip to main content
Las promociones se habilitan por organizaciónHasta que Yuno habilite las promociones para tu organización, los endpoints de promociones responden 404 PROMOTION_NOT_FOUND, y un pago que lleva un código se rechaza con 422 PROMOTION_NOT_APPLICABLE y el motivo PROMOTIONS_NOT_ENABLED. Consulta Promociones.
Todos los errores tienen el cuerpo estándar: un code y messages[]. Solo un 422 PROMOTION_NOT_APPLICABLE agrega un reason. Ramifica según code y reason: messages[] es texto informativo, por lo que nunca lo analices.
Para conocer la semántica general de los estados HTTP, consulta Códigos de respuesta HTTP.

Los endpoints de promociones

Estas respuestas pertenecen a Crear promoción, Obtener promoción, Listar promociones y Deshabilitar promoción.

Los mensajes path: RULE

Cada mensaje nombra un campo y la regla que incumplió, por ejemplo limits.total: RANGE. Un elemento de una lista lleva su índice, por ejemplo discount.amounts[0].currency: UNKNOWN_CURRENCY. Cada ruta tiene un mensaje: su primer fallo.

Códigos de lote

Estas respuestas provienen de Crear códigos de promoción. Un lote que no se puede crear responde 422 PROMOTION_NOT_APPLICABLE con uno de estos motivos, y Yuno no almacena nada.

Un pago que lleva un código

Estas respuestas pertenecen a Crear pago. En todas, no se crea ningún pago. Ninguna respuesta repite tu código. ENGINE_UNAVAILABLE abarca dos causas, y la respuesta no dice cuál es. Ambas llegan con el mismo reason y el mismo mensaje.
  • Transitoria: reintenta más tarde. El servicio de promociones no respondió a tiempo, respondió con un error, o Yuno deshabilitó temporalmente las promociones. Reintenta el mismo pago más tarde.
  • No transitoria: un reintento obtiene la misma respuesta. Una promoción automática gana la selección para este pago y dejaría un cobro de cero. Envía el pago sin el código. Un pago sin código se cobra completo, y la verificación de promociones no lo rechaza.
El mensaje dice Try again. en ambos casos, por lo que no indica cuál reintentar. Si el mismo pago sigue recibiendo ENGINE_UNAVAILABLE después de reintentar más tarde, envíalo sin el código. El cliente entonces paga el precio completo y pierde el descuento de ese código para ese pago. El texto de cada reason: El mensaje de PROMOTION_SUBSCRIPTION_UNSUPPORTED es YUNO_PROMOTION discount lines are not supported on subscriptions. para un pago que lleva un subscription, y Subscription payments cannot carry a promotion quote. para un external_subscription o un external_invoice. El mensaje de PROMOTION_CONTEXT_MISMATCH es The payment context does not match the promotion quote. Esos dos cuerpos no tienen reason. Cuando el código se convierte en una cotización, el pago continúa como un pago con cotización, y se le aplican los rechazos de El cliente paga el precio cotizado, o se rechaza el pago.

Una solicitud de cotización que lleva un código

Create Promotion Quote responde a una solicitud con un code de estas formas. El reason y el mensaje de cada una son los de las tablas anteriores. Una solicitud de cotización no envía clave de idempotencia, por lo que nunca responde IDEMPOTENCY_KEY_REUSED. Responde ZERO_CHARGE para un código que deja un cobro de cero, igual que un pago. Una solicitud de cotización para un código que se aplica recibe una vista previa 200, sin quote_id ni expires_at. Una promoción automática que dejaría un cobro de cero recibe 204.