> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# PaymentElement

> Muestra los métodos de pago disponibles y recopila los campos y avisos obligatorios del método seleccionado. Usa `change` para habilitar tu botón de pago. En su controlador de activación, llama a `payments.createConfirmationToken()`. Confirma el token en el servidor y luego pasa cualquier paso pendiente a `payments.handleNextAction(…)`. Usa `addressChange` para las actualizaciones que dependen de la dirección.

> [!NOTE]
>
> Esta página documenta `@whop/elements@1.10.0` y `@whop/elements-react@1.10.0`.

*Desde `v1.0.0`.*

Se monta dentro de [`Payments`](https://docs.whop.com/es/elements/latest/payments/overview). Pasa las props y los callbacks a través de las opciones de creación o de las props de React. Conserva el handle creado, o la `ref` de React, para llamar a `select()`.

> [!NOTE]
>
> **Exclusivo.**`PaymentElement` es una alternativa a `CardElement` o `CardFields` en este handle de Payments. Monta uno cada vez. Destrúyelo antes de montar otro.

> [!NOTE]
>
> **Espera a `BrandingElement`.** Este elemento permanece en su estado de carga hasta que se monta `BrandingElement` en el mismo handle de Payments.

Se monta dentro de un ámbito `WhopPayments`. Renderiza los mosaicos de los métodos que ofrece el cobro y, después, lo que recopile el método seleccionado: los campos de tarjeta, los campos que declara o el botón de Apple Pay.

Móntalo dentro de `<Payments>`, que es dueño del cobro y del token de confirmación. `<Payments>` se monta a su vez dentro de `<WhopElements>`. Renderiza los mosaicos de los métodos del cobro y recopila lo que declare el método seleccionado, así que una tarjeta, una hoja de wallet y una redirección bancaria se resuelven con la misma línea.

```tsx React theme={null}
import { WhopElements, Payments, PaymentElement, BrandingElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Payments /* options */>
        <PaymentElement onChange={(e) => console.log(e)} onAddressChange={(e) => console.log(e)} />
        <BrandingElement />
      </Payments>
    </WhopElements>
  );
}
```

```tsx React Native theme={null}
import { useRef, useState } from 'react';
import { Button, ScrollView } from 'react-native';
import { EmailElement, PaymentElement, Payments, type PaymentsHandle } from '@whop/elements-react-native';

export function PaymentStep() {
  const payments = useRef<PaymentsHandle | null>(null);
  const [ready, setReady] = useState(false);

  return (
    <Payments
      ref={payments}
      accountId="biz_xxxxxxxx"
      plan="plan_xxxxxxxx"
      returnUrl="https://example.com/checkout/return"
    >
      <ScrollView>
        <EmailElement />
        <PaymentElement onChange={(p) => setReady(p.complete)} />
      </ScrollView>
      <Button
        title="Pay"
        disabled={!ready}
        onPress={async () => {
          const token = await payments.current!.createConfirmationToken();
          console.log(token.confirmationToken, token.type);
        }}
      />
    </Payments>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const payments = window.WhopElements().payments.create({ /* options */ });
  payments.create('payment', {
    onChange: (e) => console.log(e),
    onAddressChange: (e) => console.log(e)
  }).mount('#payments-payment');
  payments.create('branding').mount('#payments-branding');
</script>
```

```swift Swift theme={null}
import Elements
import SwiftUI

// .whopElements(environment:) runs once at the app root. See Getting started.
struct CheckoutScreen: View {
    @State private var selection = WhopPaymentSelection(isComplete: false, type: nil, displayName: nil, category: nil)

    var body: some View {
        WhopPayments(accountID: "biz_xxxx", charge: .plan(id: "plan_xxxx")) { payments in
            ScrollView {
                VStack(alignment: .leading, spacing: 20) {
                WhopPaymentElement(selection: $selection)
                    WhopBrandingElement()
                }
                .padding()
            }
        }
    }
}
```

Datos de ejemplo. [Abre el Playground](https://docs.whop.com/es/elements/latest/payments/overview#playground).

[PaymentElement ejecutándose en Android, en la app de ejemplo de React Native](https://app.revyl.ai/embed/c05028fb-0d33-4f36-b6f9-5339a4b9a054?controls=0)

## Props

**order** `string[]`

Controla el orden de visualización en cualquiera de los diseños. Los tipos de la lista aparecen primero, en orden. Los tipos que no están en la lista conservan su orden relativo. No afecta a la disponibilidad. Por defecto es `[]`.

**wallets** `object`

Controla qué wallets ofrece el elemento. Cada clave tiene por defecto `'auto'`, que ofrece la wallet allí donde la cuenta, el dispositivo del comprador y el cobro la admiten. `'never'` elimina esa wallet de la lista de métodos. Úsalo cuando tu página dibuje sus propios botones de Apple Pay, Google Pay o PayPal con `paymentRequest`, para que los compradores vean cada wallet una sola vez. `payPal: 'never'` elimina el método PayPal. Los métodos de pago guardados no se ven afectados. Por defecto es `{}`. Desde `v1.8.0`.

**propiedades**

**applePay** `"never" | "auto"`

**googlePay** `"never" | "auto"`

**payPal** `"never" | "auto"`

**fields** `object`

Controla la recopilación de los datos de facturación. `billingDetails: 'minimal'` (por defecto) sigue la matriz de cada método. Los métodos recopilan el nombre y el formato de país completo por defecto. Una anulación puede recopilar solo el mínimo declarado o nada. Para las tarjetas, el mínimo es el nombre en la tarjeta, el país y el código postal. `'full'` exige el nombre y el formato de país completo para todos los métodos nuevos. `'never'` oculta el bloque. `address: 'minimal'` recopila solo el mínimo declarado de cada método más un país allí donde ese mínimo no lo incluya (y también el código postal cuando `billingDetails: 'full'` indica que el checkout está sujeto a impuestos), excepto para wallets, cripto, débitos bancarios, transferencias bancarias, pagos con tarjeta presente y compras dentro de la app, que no recopilan ninguna dirección, y excepto para un método cuyo proveedor exige la dirección de facturación completa (`requires_full_billing_address`), cuyo mosaico sigue las mismas reglas que un checkout sin esa marca; en los demás casos prevalece sobre `billingDetails: 'full'`; úsalo cuando el vendedor no recopile una dirección de facturación completa. `phone: 'never'` oculta solo el campo de teléfono de facturación cuando tu formulario ya lo recopila; pasa `billingDetails.phone` a `createConfirmationToken` para los métodos que lo requieran. En su lugar, pasa la dirección a `createConfirmationToken`. El selector de país incluye solo los países que admiten el método y la moneda del pago. Con un plan de pago a plazos seleccionado, se limita a los países que cubre el plan: el país de facturación es el país de la transacción con el que se procesa el cobro. Se bloquea cuando solo hay uno disponible. Por defecto es `{"billingDetails":"minimal"}`.

**propiedades**

**billingDetails** `"minimal" | "full" | "never"`

**address** `"minimal" | "auto"`

**phone** `"never" | "auto"`

**defaultValues** `object`

Rellena previamente los datos de facturación cuando el bloque de facturación de cada método se renderiza por primera vez. El comprador puede editar todos los campos rellenados. `address.country` es un código ISO 3166-1 alfa-2 y solo se aplica cuando el método seleccionado lo acepta. `phone` rellena el campo de teléfono de facturación de los métodos que lo recopilan, en formato E.164 como `+14155552671`; se ignora un número fuera de los países de teléfono admitidos por el método. Solo se rellenan y envían los campos que renderiza el bloque. Pasa cualquier otro dato a `createConfirmationToken` en `billingDetails`. Desde `v1.1.0`.

**propiedades**

**billingDetails** `object`

**propiedades**

**name** `string`

**phone** `string`

**address** `object`

**propiedades**

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**layout** `"accordion" | "horizontal"`

Diseño del selector. `accordion` (por defecto) apila los métodos y despliega los detalles en línea. `horizontal` muestra mosaicos del mismo ancho y sin desplazamiento, con los detalles del seleccionado debajo. A partir de cuatro métodos, un mosaico More abre un selector nativo. El método elegido allí ocupa el último mosaico hasta la siguiente selección. La selección y la confirmación se comportan igual. Por defecto es `"accordion"`.

**separated** `boolean`

Solo para `accordion`. Añade espaciado y un estilo de tarjeta separado entre los métodos. Se ignora cuando `layout` es `horizontal`. Por defecto es `false`.

**autoSelect** `boolean`

Si se selecciona el primer método ofrecido tras la resolución. El valor por defecto `true` respeta `order` y emite `selected` y `change` como una interacción del comprador. Se ejecuta una vez antes de la interacción del comprador y no hace nada cuando no se ofrece ningún método. Establécelo en `false` para montar sin selección. Independientemente de esto, si una actualización elimina el método seleccionado, la selección recurre al primer método ofrecido. Un elemento que ya no tiene selección se queda sin selección. Por defecto es `true`.

## Eventos

Pasa los callbacks en las opciones de creación o como props de React.

### `onChange`

Se dispara cuando cambia la selección. `complete: true` significa que el comprador seleccionó un método y completó sus campos de tarjeta o sus campos obligatorios. Úsalo para habilitar la confirmación. `paymentMethod` es el método de pago seleccionado, guardado o nuevo, o `null` mientras no hay nada seleccionado: `displayName` e `icons` nombran la elección tal como la muestra el elemento (con `balance.imageUrl`, la imagen del titular de un saldo), `card` incluye la red, los últimos cuatro dígitos y el tipo de financiación de una tarjeta, `requiresBillingPhone` indica si el método necesita un teléfono en los datos de facturación y `countries` enumera desde dónde puede pagar el método en la moneda del cobro. `type`, `requiresBillingPhone` y `method` en el nivel superior están obsoletos: léelos desde `paymentMethod`. `supportsBuyerFee` en el nivel superior también está obsoleto, sin reemplazo: Whop fija el precio de su tarifa de servicio al comprador por sí mismo.

**payload** `PaymentElementChangeEvent`

**propiedades**

**complete** `boolean` *required*

Si el comprador seleccionó un método y completó sus campos de tarjeta o sus campos obligatorios. Úsalo para habilitar la confirmación.

**paymentMethod** `PaymentElementPaymentMethod | null` *required*

El método de pago seleccionado, o `null` mientras no hay nada seleccionado.

**propiedades**

**id** `string | null` *required*

El método de pago guardado que eligió el comprador, o `null` para un método que el comprador está introduciendo ahora o para un saldo.

**type** `string` *required*

El tipo de método de pago: `card`, `klarna`, `apple_pay`, `balance`, etc.

**category** `string` *required*

La familia a la que pertenece el tipo, como `card`, `wallet`, `bnpl` o `balance`.

**displayName** `string` *required*

Cómo nombrar la elección: la etiqueta propia de un método guardado ("Visa •••• 4242", "Cash App \$tag"), el nombre de un saldo ("Acme", "Personal Balance"), la red y los últimos cuatro dígitos de una tarjeta a medida que el comprador la escribe o, si no, el nombre propio del método ("Klarna").

**icons** `PaymentMethodIcons`

El arte del icono de la elección: los iconos propios de un método guardado, el arte de la red de una tarjeta escrita o, si no, los iconos del método. Siempre es un conjunto de iconos, con versiones SVG y PNG.

**propiedades**

**square** `PaymentMethodIconVariants | null`

**propiedades**

**light** `object` *required*

**propiedades**

**svg** `string` *required*

**dark** `object` *required*

**propiedades**

**svg** `string` *required*

**card** `PaymentMethodIconVariants | null`

**propiedades**

**light** `object` *required*

**propiedades**

**svg** `string` *required*

**dark** `object` *required*

**propiedades**

**svg** `string` *required*

**balance** `object`

Lo que se sabe de una elección de saldo más allá de su tipo: `imageUrl` es la imagen del titular del saldo, una única URL de imagen rasterizada en lugar de un conjunto de iconos, para mostrarla en lugar de `icons`. No está presente para otros métodos, ni para un saldo cuyo titular no tiene imagen.

**propiedades**

**imageUrl** `string`

**card** `object`

Lo que se sabe de una elección de tarjeta: los detalles de una tarjeta guardada, o los de una tarjeta escrita a medida que el comprador la escribe. No está presente para otros métodos.

**propiedades**

**network** `string`

**last4** `string`

**funding** `string`

**requiresBillingPhone** `boolean` *required*

Si el método necesita un teléfono en los datos de facturación, incluso cuando `fields.phone` deshabilita el campo de teléfono propio del elemento.

**countries** `string[]` *required*

Los códigos de país de dos letras, en minúsculas, desde los que el método puede pagar en la moneda del cobro.

**type** `string` *deprecated*

> [!WARNING]
>
> Obsoleto. Usa `paymentMethod.type`.

**supportsBuyerFee** `boolean` *deprecated*

> [!WARNING]
>
> Obsoleto. Whop fija el precio de su tarifa de servicio al comprador por sí mismo, así que a una página no le sirve de nada. Se eliminará en la próxima versión mayor.

**requiresBillingPhone** `boolean` *deprecated*

> [!WARNING]
>
> Obsoleto. Usa `paymentMethod.requiresBillingPhone`.

**method** `object` *deprecated*

> [!WARNING]
>
> Obsoleto. Usa `paymentMethod`. No está presente cuando el comprador elige un método guardado.

**propiedades**

**type** `string` *required*

**category** `string` *required*

**template** `string` *required*

**display\_name** `string` *required*

**countries** `object[]` *required*

**propiedades**

**country** `string` *required*

**min\_amount** `number | null` *required*

**max\_amount** `number | null` *required*

**min\_amount** `number | null` *required*

**max\_amount** `number | null` *required*

### `onAddressChange`

Se dispara unos 300 ms después de que cambie la dirección de facturación interna. Úsalo para impuestos, envío u otras actualizaciones que dependen de la dirección. `country` es un código ISO 3166-1 alfa-2. El payload omite las demás claves de la dirección cuando están vacías o no se usan en ese país. `complete: true` significa que el bloque de facturación es válido y está completo. Este evento solo se dispara mientras el elemento de pago se encarga de recopilar la dirección. Con `fields.billingDetails: 'never'`, usa tu propia fuente de dirección. Con un `AddressElement` montado, usa su evento `change`.

**payload** `object`

**propiedades**

**complete** `boolean` *required*

**address** `object` *required*

**propiedades**

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *required*

### `onLoaderStart`

Se ejecuta después de que el esqueleto de carga se pinta por primera vez y antes de `onReady`.

### `onReady`

Se ejecuta después del primer pintado completo del elemento.

### `onError`

Se ejecuta cuando el elemento no se carga o falla. El contenido de respaldo permanece visible. Usa `code` para el manejo programático. `sourceKey` identifica una fuente de estado del host que falló.

**e** `object`

**propiedades**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Métodos

Llámalos en el handle que devuelve `create`, o a través de una `ref` de React.

### `select`

Selecciona un método por la misma vía que una interacción del comprador. Por ejemplo, `select('cashapp')` despliega el mosaico y emite `selected` y `change`. Las tarjetas siguen en `complete: false` hasta que sus campos estén completos. Los métodos desconocidos, no disponibles o limitados por importe se rechazan con el código `METHOD_NOT_OFFERED`. `select(null)` borra la selección y emite `change` con `complete: false`. Úsalo con `autoSelect={false}` para tener control externo total.

**Parámetros**

**input** `string | null` *required*

**Devuelve** `Promise<void>`

### `mount`

Monta el elemento en `target` y comienza a cargarlo. Los componentes de React se montan solos.

**Parámetros**

**target** `string | HTMLElement` *required*

### `destroy`

Elimina el elemento y libera su frame y sus suscripciones. Puedes llamarlo más de una vez. React elimina el elemento automáticamente.

### `update`

Combina nuevas props en el elemento montado. En React, cambia las props del componente en su lugar.

**Parámetros**

**options** `Partial\<PaymentElementProps\>` *required*

## Estilos

Aplica estilo a estas partes mediante `appearance.classes`. Usa camel case o kebab case para los nombres de las propiedades e incluye las unidades. Las hojas de estilo de la página no pueden llegar al frame del elemento. El framework valida cada declaración antes de inyectarla.

| Clase | Aplica a |
| - | - |
| `.whop-Address` | La raíz del formulario de dirección |
| `.whop-AddressErrorSummary` | La línea de resumen que se muestra cuando la validación revela campos faltantes o no válidos |
| `.whop-AddressField` | Una celda de campo en el formulario de dirección |
| `.whop-AddressFieldError` | La línea de error de un campo de dirección: debajo del campo en el diseño completo, debajo del grupo como mensaje del compositor en el diseño compacto |
| `.whop-AddressFieldInput` | Un campo de texto en el formulario de dirección |
| `.whop-AddressFieldInputInvalid` | Se añade a un campo de dirección mientras no supera la validación |
| `.whop-AddressFieldInvalid` | Se añade a una celda de campo compacta mientras no supera la validación |
| `.whop-AddressFieldLabel` | Etiqueta de un campo de dirección: encima del campo, o dentro de él con etiquetas flotantes |
| `.whop-AddressFieldSelect` | Un selector (país, estado, tipo de organización) en el formulario de dirección |
| `.whop-AddressGroup` | El grupo con borde que contiene todos los campos en el diseño compacto |
| `.whop-AddressLine2Toggle` | Interruptor contraído de la línea 2 de la dirección |
| `.whop-AddressManualEntry` | El botón de texto "Enter address manually" debajo del formulario contraído: despliega el formato completo del país |
| `.whop-AddressSearchButton` | El botón de búsqueda en el borde final del campo de calle en un teléfono |
| `.whop-AddressSuggestion` | Una fila de sugerencia en la superposición de autocompletado |
| `.whop-AddressSuggestionActive` | Se añade a la fila de sugerencia activa por teclado o puntero |
| `.whop-AddressSuggestionManual` | La fila "Enter address manually" que cierra la lista de sugerencias |
| `.whop-AddressSuggestions` | La superposición de sugerencias de autocompletado anclada al campo de la línea 1 de la dirección |
| `.whop-AddressSuggestionsEmpty` | La línea discreta que se muestra cuando la consulta terminó sin direcciones coincidentes |
| `.whop-CardField` | Campo de número de tarjeta, vencimiento o código de seguridad |
| `.whop-CardFieldError` | Mensaje de validación de la tarjeta |
| `.whop-CardFieldGroup` | Los campos de tarjeta agrupados: el número arriba, el vencimiento y el código de seguridad debajo |
| `.whop-CardFieldInput` | Contenedor de campo PCI con borde |
| `.whop-CardFieldInputFocused` | Contenedor de campo PCI con foco |
| `.whop-CardFieldInputInvalid` | Contenedor de campo PCI no válido o incompleto |
| `.whop-CardLabel` | Etiqueta de información de la tarjeta |
| `.whop-Payment` | La raíz del elemento de pago |
| `.whop-PaymentBalance` | Un monedero en el mosaico de saldo |
| `.whop-PaymentBalanceHint` | El importe disponible del monedero en la moneda del cobro |
| `.whop-PaymentBalanceList` | La lista desplazable de monederos del comprador en el mosaico de saldo |
| `.whop-PaymentBalanceMore` | La fila centinela que carga más saldos al desplazarse hasta quedar visible |
| `.whop-PaymentBalanceRow` | La fila de saldo en la que se puede hacer clic |
| `.whop-PaymentBalanceRowSelected` | Fila de saldo seleccionada |
| `.whop-PaymentBalanceRowUnavailable` | Un monedero que no puede pagar en este momento (bloqueado o vacío), atenuado y deshabilitado |
| `.whop-PaymentBillingBlock` | El bloque interno de dirección de facturación del elemento de pago |
| `.whop-PaymentCardFields` | El panel de campos de tarjeta en línea |
| `.whop-PaymentCompactBalance` | El saldo seleccionado en un checkout directo compacto |
| `.whop-PaymentCompactSavedMethod` | El método guardado seleccionado en un checkout directo compacto |
| `.whop-PaymentCurrencyFallback` | El cambio a la moneda alternativa cuando no se ofrece nada |
| `.whop-PaymentDetailIcon` | El icono de plantilla junto a la explicación de la región de detalle |
| `.whop-PaymentDetailRegion` | La región de detalle desplegada de un método seleccionado: primero las superficies de recopilación (campos de tarjeta en línea, campos declarados) y luego la explicación y las líneas informativas como bloque inferior |
| `.whop-PaymentDetailSubtext` | El subtexto de consentimiento debajo de la explicación en los métodos de monedero |
| `.whop-PaymentDetailText` | La línea explicativa de la región de detalle |
| `.whop-PaymentError` | Panel de error de métodos de pago no disponibles |
| `.whop-PaymentFieldError` | El mensaje Invalid debajo de un campo declarado |
| `.whop-PaymentFieldInput` | Un campo declarado del método en la región de detalle |
| `.whop-PaymentFieldInputInvalid` | Se añade a un campo declarado mientras su valor no cumple el formato declarado |
| `.whop-PaymentFieldLabel` | Etiqueta de un campo de pago declarado |
| `.whop-PaymentInstallmentDetail` | El importe por cuota de una fila de opción de cuotas |
| `.whop-PaymentInstallmentLabel` | La etiqueta de una fila de opción de cuotas |
| `.whop-PaymentInstallmentList` | La lista de opciones del selector de cuotas |
| `.whop-PaymentInstallmentRadio` | El indicador de opción en una fila de opción de cuotas |
| `.whop-PaymentInstallmentRow` | Una fila de opción de cuotas |
| `.whop-PaymentInstallmentRowSelected` | La fila de opción de cuotas seleccionada |
| `.whop-PaymentInstallments` | El selector de cuotas del método de pago |
| `.whop-PaymentInstallmentsLabel` | El encabezado del selector de cuotas |
| `.whop-PaymentInstallmentsNotice` | El aviso sobre comisiones del emisor debajo de un nivel seleccionado sin comisión declarada |
| `.whop-PaymentMandateLink` | El enlace a los términos del mandato dentro del aviso de mandato |
| `.whop-PaymentMandateNotice` | El aviso de autorización de mandato en los métodos cuya configuración de matriz declara un mandato |
| `.whop-PaymentMethod` | Un método de pago: la fila más su región de detalle desplegable |
| `.whop-PaymentMethodDetail` | La región desplegable que muestra el detalle del método seleccionado: campos de tarjeta en línea, explicación o campos declarados |
| `.whop-PaymentMethodIcon` | El icono del método en una fila |
| `.whop-PaymentMethodLabel` | El nombre visible del método en una fila |
| `.whop-PaymentMethodMoreSelect` | El selector nativo invisible extendido sobre el mosaico More |
| `.whop-PaymentMethodMoreTile` | Mosaico de desbordamiento con iconos de métodos y un selector nativo |
| `.whop-PaymentMethodPanel` | El panel de detalle del método seleccionado debajo de la fila de mosaicos (diseño horizontal) |
| `.whop-PaymentMethodRadio` | El indicador de opción en una fila de método |
| `.whop-PaymentMethodRadioSelected` | Indicador de opción del método de pago seleccionado |
| `.whop-PaymentMethodRow` | La fila de método de pago en la que se puede hacer clic |
| `.whop-PaymentMethodRowSelected` | Fila del método de pago seleccionado |
| `.whop-PaymentMethods` | La lista de métodos de pago |
| `.whop-PaymentMethodSelected` | Se añade al método de pago seleccionado: su fila más su región de detalle desplegada |
| `.whop-PaymentMethodSeparated` | Se añade a un elemento de método, o a un desplegable de más métodos, mientras se muestra como su propia tarjeta separada |
| `.whop-PaymentMethodsSeparated` | Lista de métodos en acordeón separado |
| `.whop-PaymentMethodTile` | Un mosaico de método en la fila horizontal de mosaicos |
| `.whop-PaymentMethodTileRow` | Fila horizontal de mosaicos de métodos con los métodos sobrantes en el mosaico final More |
| `.whop-PaymentMethodTileSelected` | Mosaico del método de pago seleccionado |
| `.whop-PaymentMoreRow` | La fila desplegable "N more payment methods" |
| `.whop-PaymentPayerDocument` | Campos del documento de identidad del comprador específicos de la moneda |
| `.whop-PaymentPayerDocumentError` | Error del documento de identidad del comprador |
| `.whop-PaymentPayerDocumentLabel` | Etiqueta del documento de identidad del comprador |
| `.whop-PaymentPayerDocumentType` | Selector del tipo de documento de identidad del comprador |
| `.whop-PaymentSavedMethod` | Específicamente, un método de pago guardado: también lleva PaymentMethod |
| `.whop-PaymentSavedMethodHint` | El detalle final del método guardado: el vencimiento de una tarjeta |
| `.whop-PaymentSavedMethodRow` | Específicamente, la fila de método guardado en la que se puede hacer clic: también lleva PaymentMethodRow |
| `.whop-PaymentSavedMethodRowSelected` | Fila del método de pago guardado seleccionado |
| `.whop-PaymentSavedMethods` | Específicamente, la lista de métodos guardados: también lleva PaymentMethods, así que una sola regla aplica estilo a ambas listas |
| `.whop-PaymentSavedMethodSeparated` | Específicamente, el marcador de separado en un método guardado |
| `.whop-PaymentSavedMore` | El control que obtiene la siguiente página de métodos de pago guardados |
| `.whop-PaymentSavedMoreSpinner` | El indicador de carga que se muestra mientras se carga la siguiente página de métodos de pago guardados |
| `.whop-PaymentSettlementNotice` | La indicación del plazo de liquidación en los métodos cuya configuración de matriz declara uno |

```ts theme={null}
const payments = whop.payments.create({
  appearance: {
    classes: {
      'whop-Address': { borderRadius: '8px', fontWeight: '600' },
      'whop-AddressErrorSummary': { borderRadius: '8px', fontWeight: '600' },
      'whop-AddressField': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

// 90 classes use this shape
payments.update({
  appearance: { classes: { 'whop-Address': { fontWeight: '700' } } }
});
```

En React, pasa `appearance` a `<Payments>`. Establécelo globalmente con `WhopElements({ appearance })`.

## Parámetros

**order** `[WhopPaymentMethodType]`

Orden de los mosaicos para este montaje, que anula el `methodOrder` del controlador. Los tipos de la lista ocupan su posición en la lista; el resto conserva su orden de entrada detrás de ellos.

**selection** `Binding\<WhopPaymentSelection\>?`

Lee de vuelta la selección actual y si está completa. El controlador registra ambas cosas en cualquier caso.

## `WhopPaymentSelection`

Lo que devuelve una selección:

* `isComplete: Bool`: el método seleccionado tiene todo lo que necesita
* `type: WhopPaymentMethodType?`: el método seleccionado
* `displayName: String?`: su etiqueta, tal como la escribe la matriz
* `category: String?`: `card`, `wallet`, `bank_debit`, …

## Estados

Muestra mosaicos de esqueleto mientras se carga la matriz de métodos y el mensaje de error cuando falla la lectura. Un método cuya categoría no puede ejecutar esta compilación se omite en lugar de renderizarse como un mosaico roto. Seleccionar una wallet cambia la superficie de confirmación por Apple Pay.

## Información útil

* Apple Pay no necesita nada de tu app: ni identificador de comerciante ni la capacidad `In-App Payments`. El comerciante es el registrado en la cuenta de Whop, y el mosaico se renderiza siempre que el dispositivo pueda pagar.
* Un método que declara un campo `secure` lo renderiza como un campo alojado. Esos valores nunca entran en tu proceso.
* Los métodos guardados de un comprador con sesión iniciada aparecen encima de los nuevos. Monta [`WhopEmailElement`](https://docs.whop.com/es/elements/latest/payments/email#swift) para ofrecer el inicio de sesión que genera la credencial; elegir una fila guardada no recopila nada y genera una referencia.
* Un cobro con tarjeta que publica niveles de pago a plazos muestra un selector de plan dentro del panel de la tarjeta. Un plan que la tarjeta del comprador no admite se contrae en lugar de atenuarse, y un plan cuya región no se corresponde con el país de facturación se rechaza antes de que se ejecute cualquier tokenizador.
* Un mercado que exige un documento de identidad (hoy, un cobro en `ars`) renderiza el selector de tipo y el campo de número dentro del panel. Ese número pasa por tu app de camino al tokenizador, a diferencia de la tarjeta, y aun así nunca llega a Whop.
* Los valores de la tarjeta y de los campos seguros se tokenizan antes de la generación, así que el token de confirmación es lo único que pasa por tu app.
* Monta [`WhopAddressElement`](https://docs.whop.com/es/elements/latest/payments/address#swift) junto a él cuando un método necesite un país de facturación: la lista de mosaicos se limita a los métodos que ese país permite.

## Instalación

```swift theme={null}
dependencies: [
    .package(url: "https://github.com/whopio/elements-swift.git", from: "0.1.0")
]
```

> [!NOTE]
>
> Móntalo dentro de un ámbito `WhopPayments(accountID:charge:)`, que crea el controlador y se lo pasa a su contenido. `payments.buyer` es el comprador con sesión iniciada una vez que un inicio de sesión por correo electrónico lo ha verificado. `WhopBrandingElement` también tiene que estar en pantalla, porque Whop es el comerciante registrado en estas ventas y `createConfirmationToken` se rechaza sin él. Aplica estilo con `.whopElementsAppearance(_:)`. El módulo es `Elements`, no `WhopElements` del SDK de wallet. Consulta [Primeros pasos](https://docs.whop.com/es/elements/latest/getting-started.md) y [Appearance](https://docs.whop.com/es/elements/latest/appearance.md).

## Props

**order** `string[]`

Orden de visualización de los métodos, con la semántica de `paymentMethodOrder` de Stripe. Los tipos que no están en la lista conservan su orden relativo de entrada detrás de los de la lista. También se puede establecer una vez en `<Payments>`.

**onChange** `(payload: PaymentChangePayload) =\> void`

Se dispara con cada cambio de selección y de completitud. Condiciona tu botón de envío a `complete`.

**style** `StyleProp\<ViewStyle\>`

Se aplica al `View` exterior del elemento. Para la personalización del tema, es preferible `appearance.parts` en el provider, que cubre todos los elementos de esta superficie. Ten en cuenta que, por ahora, los nombres de las partes de React Native son un conjunto propio, no los nombres de clase `whop-*` de la web, por lo que un objeto de appearance de la web no se puede trasladar sin cambios.

**fallback** `ReactNode`

Se renderiza en lugar del esqueleto integrado mientras el elemento se carga.

**onReady** `() =\> void`

Se dispara una vez que el elemento es interactivo. `<Payments>` los agrupa, así que normalmente lo que quieres es su propio `onLoadingChange`.

**onError** `(error: \{ message: string; code?: string \}) =\> void`

Un fallo de carga o de configuración de este elemento. En cualquier caso, el elemento renderiza su propia vista de error.

## `PaymentChangePayload`

Lo que devuelve `onChange`:

* `complete: boolean`: el método seleccionado tiene todo lo que necesita
* `type?: string`: el tipo de método seleccionado, por ejemplo `card`
* `method?: { type, category, template, display_name }`: la entrada del método seleccionado en la matriz

## Estados

Tres filas de esqueleto hasta que llega la matriz de métodos y, después, los mosaicos. Seleccionar un mosaico despliega su región de detalle debajo. `onChange` informa de `complete` cuando el método seleccionado tiene todo lo que necesita, que es lo que condiciona tu botón de envío. Un cobro sin ningún método apto renderiza un estado vacío explicativo en lugar de nada.

## Información útil

* Los números de tarjeta nunca pasan por tu código. Los campos son entradas nativas aisladas según PCI, y el SDK entrega a Whop un token, de modo que tu app queda fuera del alcance de PCI.
* Apple Pay y Google Pay presentan la hoja propia de la plataforma. Ninguno necesita nada de ti: Apple Pay usa el comerciante registrado en la cuenta de Whop, así que no hay identificador de comerciante que pasar ni capacidad que añadir en Xcode, y `googlePayMerchantName` solo establece el nombre que se muestra en la hoja, que por defecto es Whop.
* Los métodos de redirección y 3D Secure abren `ASWebAuthenticationSession` en iOS y Custom Tabs en Android. Siempre el navegador del sistema, nunca una WebView, para que la página del emisor quede fuera del límite de confianza de tu app.
* Establece `returnUrl` en `<Payments>` con una URL **https** que tú alojes. La API rechaza cualquier cosa que no sea https o loopback (`PaymentsApi::ValidateReturnUrl`), así que aquí no hay disponible un esquema de app personalizado. No registras ningún deep link: después de que el emisor redirija, `handleNextAction` consulta el pago hasta que se estabiliza y cierra el navegador por sí mismo.

> [!NOTE]
>
> Envuelve tu app en `<WhopElements getToken={…}>` una vez y luego monta `<Payments>` alrededor de los elementos. Consulta [Primeros pasos](https://docs.whop.com/es/elements/latest/getting-started.md) y [Appearance](https://docs.whop.com/es/elements/latest/appearance.md).


## Related topics

- [Payments](https://docs.whop.com/es/elements/latest/payments/overview.md)
- [Crea un checkout con Payment Elements](https://docs.whop.com/es/developer/guides/payment-elements.md)
- [CardElement](https://docs.whop.com/es/elements/latest/payments/card.md)
