Saltearse al contenido
Nappai Documentation

Stripe Customer Card

Stripe Customer Card gestiona las tarjetas guardadas de un cliente de Stripe. Puede añadir una tarjeta nueva al cliente, consultar una tarjeta concreta o todas las que tiene, y quitar una tarjeta.

Todas las operaciones trabajan sobre un cliente que ya existe en Stripe. Para crear clientes, usa Stripe Customer.

Cuándo usarlo

  • Un cliente ha introducido su tarjeta en tu formulario de pago y quieres guardarla en su ficha de Stripe.
  • Antes de renovar un servicio, quieres comprobar qué tarjetas tiene guardadas el cliente.
  • Un cliente pide que borres una tarjeta que ya no usa.

Configuración

Necesitas una credencial Stripe API con la clave secreta de tu cuenta de Stripe. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Stripe API de tu cuenta.
Operation (obligatorio)La acción que realiza el componente. Por defecto, Add. Consulta Operaciones.
ModeSolo en Get. By ID consulta una tarjeta concreta; All devuelve todas las tarjetas del cliente. Por defecto, By ID.
Customer ID (obligatorio)El identificador del cliente en Stripe (empieza por cus_). Se usa en todas las operaciones.
Card IDEl identificador de la tarjeta en Stripe (empieza por card_). Obligatorio en Get con By ID y en Remove.
Source TokenSolo en Add y obligatorio en ella. El token de la tarjeta que se va a guardar (empieza por tok_), el que genera el formulario de pago de Stripe.

Operaciones

  • Add: guarda una tarjeta nueva en el cliente a partir de su token.
  • Get: con By ID devuelve una tarjeta del cliente; con All devuelve todas sus tarjetas.
  • Remove: quita una tarjeta del cliente.

Resultado

La salida Data devuelve la tarjeta añadida, consultada o quitada. Con Get y All, devuelve un elemento por cada tarjeta. Cada elemento incluye el identificador de la tarjeta, la marca, los últimos cuatro dígitos y la fecha de caducidad.

Puedes conectarla a un mensaje de confirmación para el cliente o a una condición que compruebe si tiene alguna tarjeta. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo usarlo. Consulta Tool Mode.

Ejemplo

Un servicio de suscripción quiere guardar la tarjeta del cliente después de que la introduzca en su página de pago.

  1. La página de pago envía al flujo el identificador del cliente y el token de la tarjeta.
  2. Añade Stripe Customer Card con Operation en Add.
  3. Pasa el identificador a Customer ID y el token a Source Token.
  4. Conecta la salida Data a un correo que confirme al cliente que su tarjeta terminada en los cuatro dígitos devueltos se ha guardado.

Componentes relacionados