Esta página documenta
@whop/elements@1.10.0 y @whop/elements-react@1.10.0.v1.0.0.
Se monta dentro de
Payments. Créalo para obtener un handle y luego monta sus elementos en ese handle. Llama a destroy() para eliminar el subcontrolador y liberar su espacio. Vuelve a crearlo para obtener un handle nuevo.Exclusivo.
CardFields es una alternativa a PaymentElement o CardElement en este handle de Payments. Monta uno a la vez. Destrúyelo antes de montar otro.Vista previa
Una demostración interactiva en vivo de la disposición predeterminada de este subcontrolador con datos de ejemplo:Opciones
Pásalas apayments.create('cardFields', { … }), o como props en <CardFields> en React. Las props inyectadas por el padre nunca aparecen aquí.Las redes de tarjeta aceptadas por el vendedor en orden de visualización: los objetos
networks de la entrada de tarjeta de la matriz, cuyos iconos servidos por la API determinan el logotipo de la marca del campo de número. Omítelo para obtenerlo junto con la clave.stacked (predeterminado) dispone los campos compuestos como una fila de número encima de la fecha de vencimiento y el código de seguridad. compact los dispone en una fila. Los campos montados por separado ignoran este diseño y se renderizan con bordes completos y esquinas redondeadas. El valor predeterminado es "stacked".Eventos
Pasa los callbacks en las opciones de creación o como props de React.onChange
Se dispara cuando cambia el estado de completitud. complete pasa a ser true después de que el comprador rellena los tres campos. Úsalo para habilitar la confirmación. brand es la red de la tarjeta detectada tal como la informa el campo; network es la misma detección en el vocabulario de redes de la API (coincide con los networks de la entrada de tarjeta de la matriz, null mientras se desconoce). last4 son los últimos cuatro dígitos del número, null hasta que el número está lo bastante avanzado. funding es el tipo de financiación detectado (credit, debit o prepaid), null hasta que el número identifica uno. issuingCountry es el código de dos letras en minúsculas del país en el que se emitió la tarjeta, null hasta que el número identifica uno.Métodos
Llámalos en el subhandle depayments.create('cardFields', { … }).tokenize
Método avanzado que tokeniza los tres campos sin crear un token de confirmación. Emite tokenized al controlador de pagos. Los errores de validación aparecen en el campo que falla y el método lanza una excepción. Usa payments.createConfirmationToken() para confirmar un pago.ParámetrosDevuelve Promise<object>collect
payments.createConfirmationToken() llama a esta acción para cardFields. No la llames directamente. Tokeniza los campos y devuelve los datos usados para crear el token de confirmación.ParámetrosDevuelve Promise<object>update
Combina nuevas props y callbacks en el subcontrolador.Parámetrosdestroy
Destruye el subcontrolador y sus elementos, y luego libera su espacio exclusivo. Un create("cardFields") posterior empieza de cero.Elementos
Los elementos que monta este subcontrolador. Cada uno tiene su propia página:CardNumberElement
Campo alojado del número de tarjeta, aislado según PCI. Los números de tarjeta nunca llegan a la página host.
CardExpiryElement
Campo alojado de la fecha de vencimiento de la tarjeta, aislado según PCI.
CardCvcElement
Campo alojado del código de seguridad de la tarjeta, aislado según PCI.

