PayPal Payout

Bienvenido al componente PayPal Payout dentro de Nappai. Este bloque actúa como un puente seguro entre tu sistema de automatización y tu cuenta de PayPal, permitiéndote gestionar pagos de manera eficiente.

Su propósito principal es facilitarte el envío de dinero a varias personas a la vez (pagos masivos o “batch payouts”). Además, te permite revisar el estado de las transacciones para asegurar que todo se procesó correctamente o para solucionar posibles incidencias.

¿Es la primera vez que lo usas? No te preocupes, en esta guía te explicaremos paso a paso cómo configurarlo y sacarle el máximo provecho de forma sencilla.

¿Cómo funciona?

Imagina que necesitas pagar nóminas a varios empleados, reembolsar a clientes o distribuir comisiones. Hacerlo uno por uno puede ser lento. Este componente soluciona ese problema.

Autenticación Segura: Primero, el componente se conecta a tu cuenta de PayPal de forma segura usando credenciales que has configurado previamente. Esto asegura que solo tú tengas acceso a las operaciones de pago.
Envío o Consulta: Una vez conectado, puedes elegir dos caminos principales:
- Enviar Pagos: Ingresas los detalles de los destinatarios y el monto. El componente agrupa esta información y la envía a PayPal para que se procesen los pagos.
- Verificar Estado: Si ya enviaste pagos en el pasado, puedes usar el “Batch ID” para consultar si están pendientes, se han enviado con éxito o si hubo algún error.
Resultados: Al finalizar, el componente te devuelve un resumen en formato estructurado (JSON) que puedes usar para guardar registros, enviar notificaciones a otros sistemas o tomar decisiones automáticas basadas en si el pago tuvo éxito o no.

Conexión y Credenciales

Para que este componente pueda hablar con PayPal de forma segura, es necesario configurar las credenciales de la API en tu panel de control de Nappai antes de usar el nodo.

Sigue estos pasos simples:

Dirígete a la sección de Credenciales en tu panel de Nappai.
Crea una nueva credencial del tipo PayPal API.
Ingresa los campos requeridos:
- Client ID: Tu identificador de cliente de PayPal.
- Client Secret: Tu código secreto de cliente.
- Environment: Selecciona si trabajarás con dinero real (Live) o en un entorno de prueba (Sandbox).
Guarda la credencial.
Cuando uses este componente en tu flujo de trabajo, simplemente selecciona la credencial que acabas de crear en el campo Credential.

Nota: Es importante no compartir tus credenciales públicamente y mantenerlas seguras dentro de la plataforma Nappai.

Entradas

Para configurar el envío o consulta de pagos, necesitarás rellenar los siguientes campos. Todos ellos son esenciales para que la operación se realice correctamente.

Campos de Entrada

Operation: Selecciona aquí si deseas Enviar un pago (Create) o Consultar el estado de uno existente (Get). Este es el primer paso crucial para definir el comportamiento del componente.
- Visible en: Send Payout, Get Payout
Payout Batch ID: Si estás verificando el estado de un pago previo, este campo es obligatorio. Es el código único que PayPal le asigna a tu lote de pagos. Sin este ID, no podemos saber qué pagos estás revisando.
- Visible en: Get Payout
Sender Batch ID: Este es un identificador único que tú eliges para llevar tu propio control interno del lote (por ejemplo, batch_2024_001). Ayuda a que puedas encontrar fácilmente estos pagos en tus propios registros de contabilidad.
- Visible en: Send Payout
Email Subject: El asunto que aparecerá en el correo electrónico que PayPal envía automáticamente a los destinatarios para notificarles sobre el pago.
- Visible en: Send Payout
Recipient Email: La dirección de correo electrónico de la persona que recibirá el dinero. Asegúrate de que sea una cuenta registrada en PayPal para evitar errores.
- Visible en: Send Payout
Amount: El monto de dinero que deseas enviar. Debe escribirse como un número decimal (por ejemplo: 10.50).
- Visible en: Send Payout
Currency: El código de la moneda en la que se realizará el pago (por ejemplo, USD para dólares, EUR para euros). Debe coincidir con las monedas aceptadas por tu cuenta de PayPal.
- Visible en: Send Payout
Note: Un mensaje opcional que el destinatario podrá ver junto a su pago. Puedes usarlo para dejar una nota personal o detalles sobre la transacción.
- Visible en: Send Payout

Salidas

Una vez que el componente ha ejecutado la acción, te devolverá información valiosa que puedes usar en el siguiente paso de tu automatización.

Response: Contiene el resultado completo de la operación. Si enviaste un pago, aquí encontrarás el ID del lote, el estado inicial y enlaces de confirmación. Si consultaste un pago, verás si está “Pendiente”, “Enviado” o “Exitoso”.

Ejemplo de Respuesta JSON

Cuando el componente tiene éxito, recibirás una estructura de datos similar a esta. Puedes usar estos valores para mapearlos en otros nodos (por ejemplo, para guardar en una base de datos o enviar un correo de confirmación). json { “batch_header”: { “batch_id”: “5OTW12345678901”, “batch_status”: “PENDING”, “time_created”: “2024-01-01T10:00:00Z”, “time_completed”: null }, “items”: [ { “recipient_type”: “EMAIL”, “amount”: { “value”: “10.00”, “currency”: “USD” }, “note”: “Comisión de venta #123”, “sender_item_id”: “item_001”, “transaction_id”: null, “status”: “PENDING” } ] }

Conectividad

Este componente suele conectarse lógicamente a otros bloques dentro de Nappai para completar el ciclo de automatización:

Entrada de Datos: Generalmente recibe la lista de destinatarios y montos de un nodo anterior (como una base de datos de empleados, un archivo CSV o un formulario web) y los agrupa para enviar.
Manejo de Errores/Éxito: Su salida se conecta frecuentemente a:
- Nodos de Notificación: Para informar al usuario que el pago se procesó.
- Bases de Datos: Para registrar el Batch ID generado y el estado final de la transacción.
- Condiciones: Para verificar si el pago tuvo éxito o falló y tomar acciones correctivas automáticas.

Ejemplo de Uso

Escenario: Pago automático de reembolsos a clientes

Imagina que vendes productos online y necesitas reembolsar a los clientes que devolvieron artículos.

Paso 1: Obtienes una lista de clientes que devolvieron productos.
Paso 2: Usas el componente PayPal Payout.
- En Operation, seleccionas “Create”.
- En Recipient Email, mapeas el correo del cliente.
- En Amount, mapeas el valor del reembolso (ej. $20.00).
- En Currency, seleccionas “USD”.
- En Note, escribes “Reembolso por devolución del artículo X”.
Paso 3: El componente envía el pago a PayPal.
Paso 4: Dependiendo de si el pago fue exitoso o no, tu sistema puede enviar un correo de confirmación al cliente o notificar al departamento de finanzas si hubo algún error.

Consejos y Mejores Prácticas

Prueba en Sandbox: Antes de enviar dinero real, usa el modo “Sandbox” en las credenciales. Esto te permite simular pagos sin gastar dinero y verificar que tu automatización funciona bien.
Revisa los Correos Electrónicos: Asegúrate de que los correos electrónicos de los destinatarios estén bien escritos. Si hay un error en el correo, PayPal no podrá entregar el pago.
Usa Notas Útiles: Aunque es opcional, usar el campo Note ayuda a que los destinatarios entiendan de dónde viene el dinero, mejorando la claridad de tus transacciones.
Guarda el Batch ID: El Batch ID es tu “ticket” de referencia. Guárdalo siempre que puedas, ya que lo necesitarás si necesitas consultar el estado o resolver problemas más tarde.

Consideraciones de Seguridad

Protege tus Credenciales: Nunca compartas el Client ID o Client Secret directamente en chats o documentos compartidos. Úsalos únicamente en el panel de credenciales de Nappai.
Valida los Datos: Asegúrate de que las cuentas de correo electrónico de los destinatarios sean válidas y estén activas en PayPal. Los pagos no pueden enviarse a cuentas cerradas o inexistentes.
Monedas Correctas: Verifica que la moneda que seleccionas esté habilitada en tu cuenta de PayPal Business para evitar rechazos en la transacción.