Kobana UI
GitHub

PaymentMethodSelector

Seletor de método de pagamento em cartões de rádio (Cartão, Pix, Boleto, Transferência).

Carregando...

Instalação

npx @kobana/ui add payment-method-selector

Dependências instaladas automaticamente: card, radio-group, label (shadcn/ui), lucide-react

Importação

import { PaymentMethodSelector } from "@/components/kobana/payment-method-selector"

Props

PropTipoDefaultDescrição
methodsPaymentMethod[]Cartão, Pix, Boleto, TransferênciaMétodos de pagamento disponíveis
valuestringValor (value) do método atualmente selecionado
onValueChange(value: string) => voidCallback disparado ao selecionar um método
disabledbooleanfalseDesabilita a seleção de métodos
classNamestringClasses adicionais aplicadas ao container

Tipo PaymentMethod

CampoTipoDescrição
valuestringIdentificador único do método
labelstringTítulo exibido para o método
descriptionstring?Descrição opcional exibida abaixo do título
iconReact.ReactNode?Ícone opcional exibido à esquerda

Uso

const [method, setMethod] = useState("pix")

<PaymentMethodSelector value={method} onValueChange={setMethod} />

Use a prop methods para customizar as opções, seus rótulos, descrições e ícones:

import { CreditCard, QrCode } from "lucide-react"

<PaymentMethodSelector
  value={method}
  onValueChange={setMethod}
  methods={[
    { value: "card", label: "Cartão", description: "Crédito", icon: <CreditCard className="h-5 w-5" /> },
    { value: "pix", label: "Pix", description: "Instantâneo", icon: <QrCode className="h-5 w-5" /> },
  ]}
/>

O componente é totalmente controlado: forneça value e atualize-o em onValueChange. Ideal para fluxos de checkout que precisam apresentar os métodos de cobrança da Kobana.

On this page