Saltearse al contenido
Nappai Documentation

Stripe Charge

Stripe Charge trabaja con los cobros de tu cuenta de Stripe. Puede crear un cobro nuevo a un cliente o a una tarjeta, consultar un cobro concreto o la lista de cobros, y cambiar la descripción de un cobro.

Para pagos que necesitan confirmación del cliente o que quieres retener y cobrar más tarde, usa Stripe Payment Intent.

Cuándo usarlo

  • Quieres cobrar a un cliente que ya tiene una tarjeta guardada en Stripe cuando ocurre algo en tu flujo.
  • Quieres revisar los últimos cobros de un cliente para responder a una consulta.
  • Quieres buscar un cobro concreto para saber si se completó.
  • Quieres añadir una descripción a un cobro para identificarlo mejor en Stripe.

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, Create. Consulta Operaciones.
Get ModeSolo en Get. By ID consulta un cobro concreto; All devuelve la lista de cobros. Por defecto, By ID.
Charge IDEl identificador del cobro en Stripe (empieza por ch_). Obligatorio en Get con By ID y en Update.
Customer IDEl identificador del cliente en Stripe (empieza por cus_). En Create, cobra al cliente con su forma de pago predeterminada. En Get con All, muestra solo los cobros de ese cliente.
AmountEl importe en la unidad más pequeña de la moneda, por ejemplo céntimos: 1000 son 10,00. Obligatorio en Create.
CurrencyLa moneda del cobro, como eur o usd. Por defecto, usd. Solo en Create.
Source TokenSolo en Create. Un token de tarjeta de Stripe (empieza por tok_). No admite formas de pago que empiezan por pm_; para esas usa Stripe Payment Intent.
DescriptionTexto libre que se guarda con el cobro. En Create y Update.
LimitSolo en Get con All. Número máximo de cobros que se devuelven, entre 1 y 100. Por defecto, 100.

En Create tienes que rellenar al menos Customer ID o Source Token.

Operaciones

  • Create: crea un cobro por el importe y la moneda indicados, al cliente o a la tarjeta del token.
  • Get: con By ID devuelve un cobro; con All devuelve la lista de cobros, de un cliente si lo indicas.
  • Update: cambia la descripción de un cobro existente.

Resultado

La salida Data devuelve el cobro creado, consultado o actualizado. Con Get y All, devuelve un elemento por cada cobro encontrado. Cada elemento incluye el identificador, el importe, la moneda y el estado del cobro, entre otros datos de Stripe.

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

Ejemplo

Una academia cobra la matrícula a alumnos que ya tienen tarjeta guardada en Stripe.

  1. Añade Stripe Charge con Operation en Create.
  2. En Customer ID, pasa el identificador de Stripe del alumno que llega desde el formulario de inscripción.
  3. Pon Amount en 25000 y Currency en eur para cobrar 250,00 €.
  4. En Description, escribe “Matrícula curso de otoño”.
  5. Conecta la salida Data a un correo de confirmación para el alumno.

Buenas prácticas

  • Prueba tus flujos con la clave de pruebas de Stripe antes de usar la clave real.
  • Recuerda que los importes van en céntimos: un error en el importe se cobra de verdad con la clave real.

Componentes relacionados