# Payment Logos

Payment methods as small card-shaped logos, one at a time or as the row of methods a shop accepts.

- Category: Commerce
- Page: https://wunderui.com/components/payment-logos
- Tier: Core and Pro

## Install

Payment Logos ships with WunderUI Core and Pro in the @wunderui/react package.

## Import

```tsx
import { PaymentLogo, PAYMENT_LOGOS, PAYMENT_METHODS, PaymentLogoName, PaymentLogoProps, PaymentMark, PaymentMarkProps, PaymentMethod, PaymentMethods, PaymentMethodsProps, resolvePaymentLogo } from "@wunderui/react"
```

## Minimal usage

Then use it:

```tsx
import { PaymentLogo, PaymentMethods } from "@wunderui/react"

export function Payment() {
  return (
    <div className="flex flex-col gap-3">
      <span className="flex items-center gap-2 text-sm">
        <PaymentLogo name="Visa" label="" />
        Visa •••• 4242
      </span>
      <PaymentMethods methods={["Visa", "Mastercard", "PayPal", "Klarna"]} />
    </div>
  )
}
```

Expected result: You see a Visa logo beside the text Visa •••• 4242 and under it a row of four logos: Visa, Mastercard, PayPal and Klarna.

## When to use

### Use Payment Logos for

- The accepted methods under a pay button or in a shop footer
- The method of a saved card, an invoice or a transaction row
- A method in a table cell, at the small size

### Use something else

- [Brand Logo](https://wunderui.com/components/brand-logo) for the logo of a product or service that is not a payment method
- [Radio Group](https://wunderui.com/components/radio-group) for choosing one payment method
- [Selector Item](https://wunderui.com/components/selector-item) for a list of methods to pick from, each with a description

## Behavior

What the logos do with their name, size and colours. They are display only: no hover, focus, keyboard or loading behaviour.

- **An image, not a control:** PaymentLogo is a span with the image role and the method's name as its accessible name. It has no focus stop and a click does nothing.
- **Names and short spellings:** PaymentMethods maps the names people write (VISA, MC, AMEX, American Express, Apple Pay …) to their logo with resolvePaymentLogo. Any other name, such as Invoice or Swish, shows as a text chip as high as the logos.
- **Screen readers:** The row is announced as the group Accepted payment methods, then each logo by its method name, such as Visa or Mastercard. With label="" a logo is hidden.
- **Size and wrapping:** md is 32 × 20 and sm 24 × 15. The row is as wide as its parent and wraps 6 px apart, so nothing is cut off.
- **Colour and dark mode:** The card colours are the brands' own and stay the same in dark mode. The black Apple Pay card gets a light rim in dark mode, and bank transfer uses the card and border tokens.
- **Motion and reduced motion:** Nothing is animated, so there is nothing to reduce under reduced motion.

## Anatomy

- `PaymentLogo`: A span with the image role and the method's name: a 32 × 20 card (24 × 15 at sm) with 4 px corners, in the brand's colour or the card token, that clips its artwork.
- `Artwork`: An SVG on a 32 × 20 grid: the brand's mark or wordmark, or a bank in the secondary text colour for bank transfer. Hidden from screen readers; the card carries the name.
- `PaymentMethods`: A group named Accepted payment methods that turns a list of names into a wrapping row of PaymentLogo, 6 px apart. A name without a logo becomes a text chip of the same height.
- `PaymentMark`: The old name of PaymentLogo, kept as a deprecated alias so existing code keeps working.
- `Payment Methods Chip`: A text chip for a name without a logo, such as Invoice: as high as the logos, with a border, the card fill and the name in 10 px medium text.

## Best practices

### When to use

- Use Payment Logos where a screen says how something is or can be paid: a checkout, a saved card, an invoice or a transaction row.

### Do

- Pass label="" when the text beside the logo already names the method, such as Visa •••• 4242, so a screen reader does not read it twice.
- Show only the methods you accept, and change the row by market. The default row is Visa, Mastercard, Amex, PayPal, Apple Pay and Klarna.
- Put a short line such as Secure checkout above the row, so it is clear what the logos mean.

### Don't

- Don't use the logos to choose a method. They are images; use Radio Group or Selector Item for the choice and put a logo inside each option.
- Don't recolour the logos. The card colours are the brands' own and are the one documented exception to the token rule.
- Don't pass the same name twice to PaymentMethods. The name is the React key, so a repeat logs a warning.

## API reference

### PaymentLogo

| Prop | Type | Default | Description |
|---|---|---|---|
| name* | "PayPal" \| "Visa" \| "Mastercard" \| "Amex" \| "SEPA" \| "Apple Pay" \| "Google Pay" \| "Klarna" \| "Bank transfer" |  | The method: `Visa`, `Mastercard`, `Amex`, `SEPA`, `Apple Pay`, `Google Pay`, `PayPal`, `Klarna` or `Bank transfer` (the list is `PAYMENT_LOGOS`). |
| label | string |  | The accessible name. The method name by default; pass `""` when the text beside the logo names the method. |
| size | "sm" \| "md" | "md" | `md` 32 × 20 (default) or `sm` 24 × 15 for table cells and dense rows. |

Also accepts React.HTMLAttributes attributes.

### PaymentMark

| Prop | Type | Default | Description |
|---|---|---|---|
| name* | "PayPal" \| "Visa" \| "Mastercard" \| "Amex" \| "SEPA" \| "Apple Pay" \| "Google Pay" \| "Klarna" \| "Bank transfer" |  | Which payment method. |
| label | string |  | Accessible name. Defaults to the method name; pass "" when the text beside it already names it. |
| size | "sm" \| "md" |  | `sm` 24 × 15 for table cells and dense rows, `md` 32 × 20 for forms, lists and the accepted-methods row. Default `md`. |

Also accepts React.HTMLAttributes attributes.

### PaymentMethods

| Prop | Type | Default | Description |
|---|---|---|---|
| methods | string[] | ["VISA", "MC", "AMEX", "PayPal", "Apple Pay", "Klarna"] | The accepted methods, in this order. Known names and short spellings show their logo, any other name a text chip. `VISA`, `MC`, `AMEX`, `PayPal`, `Apple Pay` and `Klarna` by default. |
| size | "sm" \| "md" | "md" | The size of every logo in the row: `md` (default) or `sm`. |

Also accepts React.HTMLAttributes attributes.

## Examples

### Methods: nine logos

### Size: medium 32 × 20 and small 24 × 15

### Row: the methods a shop accepts

### Width: the logos wrap when the row is narrow

## In context

### Secure checkout: the logos of the market under the pay button

The summary is the same in every market; only the amounts and the accepted methods change. Swish has no logo, so it shows as a text chip.

### Payment row: the logo beside the card number

Saved methods in account settings. The text names the method, so the logo takes `label=""` and a screen reader reads the number only once.

### Footer: the row beside the legal links

The row sits on the right of the footer and moves below the links on a narrow screen, where the logos start on the left.

## For AI agents

`get_component("payment-logos")`

Hand your agent this page as Markdown or the WunderUI MCP server, not a screenshot.
