Saltearse al contenido
Nappai Documentation

PayPal Order

PayPal Order crea pedidos de pago en tu cuenta de PayPal y consulta los que ya existen. Un pedido es la petición de cobro que tu cliente aprueba en PayPal: al crearlo, recibes un enlace que el cliente abre para pagar con su cuenta de PayPal o su tarjeta.

Cuándo usarlo

  • Un cliente confirma una compra por chat o por correo y quieres enviarle un enlace de pago de PayPal.
  • Quieres generar el enlace de pago de una reserva desde el mismo flujo que la registra.
  • Quieres comprobar si un cliente ya ha aprobado el pago de su pedido antes de prepararlo.

Configuración

Necesitas una credencial PayPal API con el Client ID y el Client Secret de tu aplicación de PayPal, y el entorno: Sandbox para pruebas o Live para cobros reales. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial PayPal API de tu cuenta.
Operation (obligatorio)La acción que realiza el componente: Create o Get. Por defecto, Create. Consulta Operaciones.
Order IDSolo en Get, y obligatorio en ella. El identificador del pedido en PayPal.
IntentSolo en Create. CAPTURE si el pago se cobrará de una vez; AUTHORIZE si solo se reservará el importe en la cuenta del cliente para cobrarlo después. Por defecto, CAPTURE.
AmountSolo en Create, y obligatorio en ella. El importe con decimales, por ejemplo 10.00.
CurrencySolo en Create. La moneda del pedido, como EUR o USD. Por defecto, USD.
DescriptionSolo en Create. Texto que describe la compra. Opcional.

Operaciones

  • Create: crea un pedido por el importe y la moneda indicados y devuelve el enlace para que el cliente lo apruebe.
  • Get: devuelve el estado y los datos de un pedido.

Resultado

La salida Data devuelve un elemento con los datos del pedido: su identificador, su estado, la intención, el importe, la moneda, la descripción y la fecha de creación. Al crearlo, incluye el enlace de aprobación (approve_url) que tienes que enviar al cliente. Cuando el pedido ya tiene un cobro o una reserva, incluye también su identificador y su estado.

Puedes conectarla a un correo o a un mensaje de WhatsApp para enviar el enlace al 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 tienda de artesanía vende por Instagram y cobra con PayPal.

  1. Cuando un cliente confirma un pedido, el flujo recibe el importe y lo que ha comprado.
  2. Añade PayPal Order con Operation en Create, Amount en 45.00, Currency en EUR y en Description el nombre de la pieza.
  3. Conecta la salida Data a un mensaje que envíe al cliente el enlace approve_url.
  4. Más tarde, usa otro PayPal Order con Operation en Get y el Order ID para comprobar si el cliente ha aprobado el pago.

Buenas prácticas

  • Prueba tus flujos con una credencial en Sandbox antes de usar una en Live.
  • Guarda el Order ID con el pedido de tu tienda: es lo que necesitas para consultarlo después.

Componentes relacionados