Medio de pago.
Patrón canónico de medio de pago para cis-admin, cis-infra, cis-inbox, usaia y servicios internos.
Verlo por niveles
Primero el componente, después la variación de marca y finalmente su uso dentro de una página.
Ver y copiar el código de este render
<fieldset class="ui-sample ui-form" data-payment-method="true"><legend>Medio de pago</legend><label><input type="radio" name="payment-0" checked=""> Transferencia bancaria</label><label><input type="radio" name="payment-0"> Tarjeta terminada en 1842</label><small>No se realizará el cobro hasta confirmar.</small></fieldset>Variaciones por marca y sitio
Cada cambio visible declara su autoridad; lo que permanece canónico no se vuelve a inventar en el producto.
Compañía de Innovación de Santiago
Autoridad: CONSTITUTION.md + LOGOS-CANONICOS.mdCambia en esta marca
- Navegación y contenido propios del servicio
- Acento reservado para acciones y datos
Permanece canónico
- Mark CIS y namebrand de tres líneas
- IBM Plex Sans, foco, espaciado y anatomía
COCHID
Autoridad: core-style/DECISIONES.md M15 y LOGOS-CANONICOS.mdCambia en esta marca
- Cuadrado azul y namebrand de tres líneas
- Azul COCHID en selección, capas y series
Permanece canónico
- Estructura y semántica comunes
- Fuentes, unidades y alternativa tabular
Comparación histórica recuperable
Compara la propuesta con cortes reales del repositorio. La ausencia de una muestra se declara y nunca se reconstruye de memoria.
- Estado actual
- Medio de pago no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
- Cambio propuesto
- Publicar en r19 el contrato de Medio de pago para Patrón canónico de medio de pago para cis-admin, cis-infra, cis-inbox, usaia y servicios internos.
- Qué ocurre si respondes No
- Medio de pago queda fuera de r19 y sus ejemplos siguen sólo como evidencia pendiente de reformulación.
Preparando comparación histórica…
Antes / r19
La comparación convierte una regla abstracta en una diferencia visible y verificable.
- Conecta estado, timestamp y fuente al servicio real.
- Explica impacto, recuperación y recibo cuando hay una falla.
- No muestres CONFIRMADO o EN LÍNEA sin señal verificable.
- No expongas secretos, tokens ni trazas con datos personales.
Responsive
La misma anatomía debe conservar lectura, foco y acciones sin cortar contenido ni crear scroll horizontal en la página.
Cobertura
| Dimensión | Contrato |
|---|---|
| Propietario canónico | Sistema de diseño CIS e Infraestructura · core/core-style |
| Consumidores | cis-admin, cis-infra, cis-inbox, usaia y servicios internos |
| Dependencias | API del servicio, recibos verificables |
| Estado | candidato |
Evidencia de adopción
Patrón propuesto. 0 implementaciones observadas en 0 repositorios.
La observación demuestra uso existente; la aceptación canónica sigue dependiendo de esta ficha y de su propietario.
| Dato | Resultado |
|---|---|
| Clasificación | Patrón propuesto |
| Implementaciones | 0 implementaciones observadas |
| Repositorios | Ningún repositorio observado |
| Snapshot | kit/componentes/componentes-observados.json |
Consumidores observados
El inventario conserva repositorio, archivo fuente y criterio de asociación. Observar una implementación no la convierte automáticamente en canónica.
Estados
| Estado requerido |
|---|
| operativo |
| degradado |
| fallido |
| sin datos |
Accesibilidad
- Conserva nombre accesible, orden de lectura y foco visible.
- Funciona a 320 px, con zoom de 200% y texto largo.
- El color nunca es la única señal de estado o acción.
- El contenido esencial permanece disponible sin JavaScript.
Código HTML
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
<fieldset class="ui-sample ui-form" data-payment-method="true"><legend>Medio de pago</legend><label><input type="radio" name="payment-0" checked=""> Transferencia bancaria</label><label><input type="radio" name="payment-0"> Tarjeta terminada en 1842</label><small>No se realizará el cobro hasta confirmar.</small></fieldset>Código TAILWIND
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
<fieldset class="ui-sample ui-form border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-payment-method="true"><legend>Medio de pago</legend><label><input class="border border-slate-400 bg-white px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2" type="radio" name="payment-0" checked=""> Transferencia bancaria</label><label><input class="border border-slate-400 bg-white px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2" type="radio" name="payment-0"> Tarjeta terminada en 1842</label><small class="text-sm text-slate-600">No se realizará el cobro hasta confirmar.</small></fieldset>Código REACT
Copia el bloque completo; después cambia contenido y destinos, no su anatomía.
import type { ChangeEventHandler } from "react";
/** Tono de la insignia de un medio: `ok` verificado, `warn` vencido o por actualizar, `err` rechazado, `neutral` sin tono. */
export type PaymentMethodTone = "ok" | "warn" | "err" | "neutral";
export interface PaymentMethodOption {
/** Medio de pago como lo reconoce la persona («Tarjeta terminada en 1842»). */
label: string;
/** Valor enviado con el formulario; si falta, el radio se compara por su texto y el navegador envía «on». */
value?: string;
disabled?: boolean;
/** Estado del medio («Vencida», «Predeterminado»); va en una insignia junto al texto y vacío no la muestra. */
status?: string;
/** Tono de la insignia del estado; sin valor es `neutral`. */
statusTone?: PaymentMethodTone;
}
export interface PaymentMethodProps {
/** Título del grupo. */
legend?: string;
/** Nombre compartido por los radios del grupo. Usa uno distinto por grupo en la página. */
name?: string;
/** Medios de pago disponibles, uno por radio. */
options?: PaymentMethodOption[];
/** Medio marcado al inicio en un grupo no controlado (el `value` de la opción o su texto). */
defaultValue?: string;
/** Medio marcado en un grupo controlado; va junto con `onChange`. */
value?: string;
/** Se llama al marcar un medio, también en un grupo no controlado. */
onChange?: ChangeEventHandler<HTMLInputElement>;
/** Nota bajo las opciones: cuándo se cobra o qué falta para usar un medio; vacía se omite. */
description?: string;
className?: string;
}
const PAYMENT_METHOD_OPTIONS: PaymentMethodOption[] = [
{ label: "Transferencia bancaria" },
{ label: "Tarjeta terminada en 1842" },
];
const PAYMENT_METHOD_BADGE: Record<PaymentMethodTone, string> = {
ok: "badge badge--ok",
warn: "badge badge--warn",
err: "badge badge--err",
neutral: "badge",
};
/**
* Grupo de radios para elegir el medio de pago de una contratación, con una nota sobre el cobro o el estado del medio elegido.
*
* Un medio que no se puede usar lleva `disabled` y su estado en una insignia (`status: "Vencida"`, `statusTone: "warn"`); la nota explica qué hacer.
*
* @example <PaymentMethod name="medio-pago" options={[{ label: "Transferencia bancaria", value: "transferencia" }, { label: "Tarjeta terminada en 1842", value: "tarjeta-1842" }]} defaultValue="transferencia" />
* @example <PaymentMethod name="medio-pago" options={[{ label: "Transferencia bancaria", value: "transferencia" }, { label: "Tarjeta terminada en 1842", value: "tarjeta-1842", disabled: true, status: "Vencida", statusTone: "warn" }]} defaultValue="transferencia" description="La tarjeta terminada en 1842 venció en agosto. Actualízala en tu cuenta para volver a usarla." />
*/
export function PaymentMethod({
legend = "Medio de pago",
name = "payment-0",
options = PAYMENT_METHOD_OPTIONS,
defaultValue = "Transferencia bancaria",
value,
onChange,
description = "No se realizará el cobro hasta confirmar.",
className,
}: PaymentMethodProps) {
const controlado = value !== undefined && onChange !== undefined;
const marcado = value ?? defaultValue;
return (
<fieldset className={["ui-form", className].filter(Boolean).join(" ")} data-payment-method>
<legend>{legend}</legend>
{options.map((opcion, i) => {
const clave = opcion.value ?? opcion.label;
return (
<label key={`${clave}-${i}`}>
<input
type="radio"
name={name}
value={opcion.value}
disabled={opcion.disabled}
onChange={onChange}
{...(controlado ? { checked: clave === value } : { defaultChecked: clave === marcado })}
/>
{` ${opcion.label}`}
{opcion.status ? <span className={PAYMENT_METHOD_BADGE[opcion.statusTone ?? "neutral"]}>{opcion.status}</span> : null}
</label>
);
})}
{description ? <small>{description}</small> : null}
</fieldset>
);
}