Enlaces de pago, widget y checkout

Enlaces de pago

Un enlace de pago es la forma más rápida de cobrar sin factura. Creas un enlace, lo envías por correo, texto o chat y el cliente paga en una página segura alojada desde cualquier dispositivo. Úsalo para un depósito, una cotización que el cliente aceptó por teléfono, un bote de propinas o cualquier monto suelto.

Cada enlace es de un solo uso: se bloquea tras el primer pago exitoso para que no pueda pagarse dos veces. Los enlaces pueden vencer en un plazo (30 días por defecto), llevar un número de factura y una descripción para tus registros, y pedir cualquier campo de pago personalizado que habilites.

Un enlace está pagado cuando su fila muestra Paid. El pago aparece en Money → Transactions con la descripción y el número de factura, el cliente recibe un recibo y tu alerta de pago sale si Email me when a payment comes in está activo. Un pago bancario en un enlace se marca pagado al iniciar el débito y liquida en el calendario bancario.

Si un cliente dice que el enlace no abre, revisa la fila: los enlaces Expired necesitan uno nuevo, los Cancelled se detuvieron a propósito y un enlace Paid ya se usó. Si falta el teléfono del cliente, Text no está disponible; agrega el número al cliente o pega la URL en tu propio mensaje.

1. 1Ve a Accept Payments → Payment Links y haz clic en New Payment Link.
2. 2Escribe el Amount, o déjalo en $0.00 para que el cliente elija cuánto pagar. Agrega un Invoice #, un valor de Expires in (days) (en blanco nunca vence), una Description y un Link name para tus registros.
3. 3Agrega Customer name, email y phone para ligar el enlace al cliente y que Text esté disponible. Elige qué Custom fields on this link preguntar: All fields, Choose fields o None.
4. 4Haz clic en Create Link. El aviso verde muestra la URL: haz clic en Copy URL para pegarla en un correo o chat, o en Text para enviarla directo al teléfono del cliente.
5. 5Sigue el tablero. Cada enlace muestra Pending, Paid, Cancelled o Expired. Haz clic en Cancel en un enlace que ya no quieras que se pague.

El pay widget y tu página de pago

El pay widget te da dos cosas: una página de pago alojada en tu propio enlace que puedes compartir, imprimir como código QR o previsualizar, y un formulario para insertar en tu sitio web para que los clientes paguen sin salir de él. Ambos usan la misma configuración.

Ve a Accept Payments → Pay Widget. La primera vez, haz clic en Turn on the Pay Widget; necesita el procesamiento de tarjetas activo. El widget empieza con pagos únicos de monto fijo, un mínimo de $1 y un máximo de $10,000, todo modificable.

Terminaste cuando la insignia de estado dice Live y el Master switch está On. Copy URL te da la dirección pública de la página de pago, y Preview muestra exactamente lo que ve un cliente. Cada pago por la página o el código insertado cae en Money → Transactions y en la lista Recent activity del widget.

Si los clientes reportan que los pagos no están disponibles, el Master switch está Off. Si un pago se rechaza por su monto, está fuera del Amount range. Si tu logo falta en la página, súbelo en la tarjeta Business profile de Settings.

1. 1Master switch: enciende o apaga los pagos. Apagado, los visitantes ven un aviso de pagos no disponibles tanto en la página alojada como en el código insertado.
2. 2Payment types: marca lo que acepta la página: Fixed amount, Donations, Save card on file, Pay external invoice, Pay Merchant360 invoice o Subscriptions. Los clientes solo pueden usar los tipos que marques aquí.
3. 3Amount range: fija un Minimum y un Maximum. Se validan en el servidor, así que nadie puede alterar el enlace para pagar fuera del rango.
4. 4Branding: fija tu Brand color, un Logo URL opcional y las páginas Success redirect y Cancel redirect donde aterrizan los clientes. Tu logo viene si no de tu perfil de negocio.
5. 5Receipts: el From email es la dirección a la que llegan los clientes cuando responden a un recibo, y el BCC email recibe copia de cada recibo. Ambos están también en la tarjeta Receipts de Settings, que aplica a todos los canales y tiene prioridad cuando está llena.
6. 6Embed snippet: elige el Payment type, copia el código y pégalo en tu sitio donde deba aparecer el formulario. Muestra un marco de pago seguro, así que ningún dato de tarjeta toca tu sitio.
7. 7Pay Now button: crea un botón de pago listo para pegar en tu sitio o correo. La guía completa está en la sección Botones de pago más abajo.

Botones de pago

Un botón de pago es un botón de Comprar, Pagar o Donar para tu propio sitio web o correo. El cliente hace clic y paga en tu página segura alojada, o en una ventana emergente sobre tu propia página, y tú no escribes ni una línea de código.

Encuentra el generador en Accept Payments → Pay Widget, en la tarjeta Pay Now button. Todo lo que configuras se refleja en la vista previa en vivo, y el HTML y el enlace simple se actualizan sobre la marcha.

Terminaste cuando pegaste el Button HTML en tu constructor de sitios o correo, o apuntaste un botón existente al Plain link. El botón sigue funcionando hasta que apagues el widget, y cada pago que pase por él aparece en Recent activity y en Money → Transactions.

Si el botón abre una página que dice que los pagos no están disponibles, el Master switch está Off. Si un botón con monto en blanco no abre, activa Donations bajo Payment types, porque un monto abierto usa ese tipo. Si la ventana emergente no aparece en tu sitio, el código no se pegó con el botón; el botón igual enlaza a la página de pago como respaldo.

1. 1Texto y monto: define el Button text (Pagar ahora, Donar, Reservar, lo que quieras) y un Amount. Con un monto fijado, el botón cobra exactamente eso. Déjalo en blanco y el cliente elige cuánto pagar, presentado como un Open payment neutral o como Donation.
2. 2Description: una línea opcional que acompaña a la página de pago y a tus reportes, para que siempre sepas de qué fue el pago.
3. 3Dale estilo: elige un Button color (o usa el de tu marca), un Size (Small, Medium, Large), Corners (Pill, Rounded, Square) y Full width si el botón debe estirarse. La vista previa muestra exactamente lo que vas a pegar.
4. 4Elige cómo se abre (Opens): New page lleva al cliente a tu página de pago alojada (marca Open in a new tab si lo prefieres); Popup on your page abre el mismo formulario seguro sobre tu propio sitio.
5. 5Success URL (optional): tras un pago exitoso, envía al cliente a tu propia página de agradecimiento. En modo emergente la ventana se cierra y redirige allí; en blanco, el cliente ve el recibo con un botón Close.
6. 6Cópialo: Copy bajo Button HTML te da el botón completo con estilo para pegar. O copia el Plain link y apunta a él un botón, imagen o elemento de menú que ya tengas.

Qué puede aceptar tu página de pago

El Pay Widget es una herramienta que cambia de forma según los tipos de pago que actives. Cada tipo es una forma distinta de cobrar. Combínalos, o corre uno solo; la página muestra solo lo que corresponde al enlace que el cliente abre.

Las suscripciones necesitan planes. En la página Subscriptions (enlazada desde el widget) crea cada plan con nombre, monto, período de cobro y, opcionalmente, prueba gratis, cargo de alta, número de pagos y términos. Los clientes eligen un plan en tu página de pago, el primer pago se cobra de inmediato y la tarjeta queda en archivo para el resto. La lista Subscribers muestra cada inscripción con su estado y próximo cobro, y permite pausar, reanudar, reintentar un cobro fallido o cancelar.

La página también acepta lo que permite tu tarjeta Payment methods: tarjeta, y banco cuando los pagos bancarios están activos. Con dual pricing se muestran ambos precios y la elección del cliente fija el total.

Si un cliente no puede inscribirse en un plan, el tipo de pago Subscriptions está apagado o el plan está archivado. Si un tipo que el código pide no está marcado en Payment types, el widget lo rechaza, así que marca el tipo primero.

1. 1Fixed amount: tú fijas el precio (por el monto del código o el botón Pay Now) y el cliente lo paga. Ideal para un producto, una reserva o una cuota fija.
2. 2Donations: quien dona elige el monto de fichas preestablecidas o escribe un valor propio. Ideal para organizaciones sin fines de lucro, propinas y paga-lo-que-quieras.
3. 3Save card on file: sin cargo; la tarjeta del cliente se guarda en la bóveda para una factura o suscripción futura.
4. 4Pay external invoice: el cliente escribe tu número de factura y el monto, y paga. Ideal cuando tus facturas viven en QuickBooks, Xero u otro sistema.
5. 5Pay Merchant360 invoice: el cliente busca una factura que enviaste desde Merchant360 por su correo y código de cliente, ve el saldo y la paga. Sin enlace.
6. 6Subscriptions: el cliente se inscribe en un plan que configuraste (de diario a anual) y la tarjeta se cobra automáticamente.

Llaves de API para desarrolladores

Si construyes tu propio sitio o app, la tarjeta API key de la página Pay Widget emite una llave para cobros servidor a servidor y para verificar pagos. Emite una llave, usa Re-issue para rotarla o Revoke para revocarla. La llave completa se muestra una sola vez, así que guárdala al crearla.

El widget insertado y la página de pago alojada no necesitan la llave: se autentican con el propio código. La llave es solo para llamadas directas desde tu servidor. Cualquiera con la llave puede correr cobros contra tu cuenta, así que trátala como una contraseña.

Verifica un pago en tu página de agradecimiento: cuando un botón Pay Now envía al cliente a tu Success URL, agregamos ?m360_ref=... a la dirección. Desde tu servidor (nunca desde el navegador), llama a GET /api/cygma/v1/verify?reference=<ese valor> con tu llave de API en el encabezado Authorization. Responde si el pago realmente se completó, con el monto y los últimos cuatro de la tarjeta, para que confirmes el pedido antes de surtirlo.

Terminaste cuando la tarjeta muestra el prefijo de la llave con su fecha de emisión. Para llaves con alcances, webhooks y llaves Test y Live, usa la página Developers; es la consola de desarrollador completa.

Si una llave se filtra, haz clic en Re-issue: la llave vieja deja de funcionar de inmediato y la nueva se muestra una vez. Si usas Revoke por error, cualquier integración que use la llave se rompe hasta que emitas una nueva y actualices tu servidor.

Checkout para desarrolladores (sesiones alojadas)

Checkout (Accept Payments → Checkout) es para desarrolladores que integran pagos en su propio sitio o app. En vez de una página de arrastrar y soltar, tu código crea una sesión de checkout segura por el API de Merchant360 y envía al cliente a una página de pago alojada, o la abre como ventana emergente con el Checkout Button. Los datos de tarjeta nunca tocan tu sitio, y redirigimos al cliente de regreso y notificamos a tu webhook cuando paga.

La página te da Get API keys, la documentación del API y Try the demo, más una lista de cada sesión de checkout con su monto, descripción, cliente y estado. Los campos de pago personalizados que habilites para Checkout en Settings aparecen también en la página alojada.

Una sesión está lista cuando su estado dice COMPLETE y view payment abre la transacción. Las sesiones creadas con una llave Test llevan una insignia test y nunca mueven dinero.

Si solo quieres cobrar sin código, usa un enlace de pago o el pay widget. Si una sesión muestra EXPIRED, el cliente no pagó a tiempo; crea una nueva. BANK PAYMENT PROCESSING significa que el cliente eligió Pay by bank y el débito está liquidando.

Lo que tu cliente ve en el checkout alojado

Cada sesión de checkout abre la misma página segura: tu logo y nombre arriba, el resumen del pedido a la izquierda y el formulario de pago a la derecha. Es la página detrás del Open secure checkout de la Payment Extension, de las sesiones creadas por API, de los modos redirect y popup de WooCommerce y de los pagos de LeadConnector.

Donde Apple Pay está disponible, un botón de Apple Pay aparece automáticamente arriba del formulario de tarjeta. En un iPhone o Mac el cliente confirma con Face ID o Touch ID; en otros navegadores escanea un código rápido con su iPhone. No hay nada que configurar de tu lado, y tus reglas de precios (surcharge o dual pricing) se muestran en la hoja de Apple Pay. El mismo botón aparece en la página de pago de tus facturas electrónicas.

En el formulario, el número de tarjeta enmascara sus dígitos centrales en cuanto el cliente pasa al siguiente campo, la ficha de marca (Visa, Mastercard, Amex, Discover, y Credit o Debit) aparece desde los primeros dígitos y el vencimiento se elige de menús, nunca se teclea. Los llaveros móviles pueden autollenar la tarjeta guardada del cliente. La barra Pay with Vault queda arriba del formulario para clientes que regresan, y la casilla Save my card with Vault debajo permite que un cliente nuevo guarde su tarjeta para la próxima vez.

Las sesiones creadas con una llave Test muestran un aviso de modo de prueba y nunca mueven dinero. Cualquier campo de pago personalizado habilitado para Checkout se pregunta en el formulario, y el recibo se envía por correo en cuanto el pago aprueba.

Si falta el botón de Apple Pay, el dispositivo o navegador del cliente no lo soporta; el formulario de tarjeta funciona normal. Si la tarjeta de un cliente se rechaza con un error de dirección, el código postal no coincidió con la dirección de facturación de la tarjeta.

Métodos de pago en el checkout alojado

El checkout alojado se adapta a cómo paga el cliente y a lo que permite tu tarjeta Payment methods. Card siempre está. Pay by bank aparece cuando los pagos bancarios están activos, y la sesión muestra entonces BANK PAYMENT PROCESSING hasta que el débito liquida. Con dual pricing el cliente ve el precio con tarjeta y el precio en efectivo y el total sigue su elección.

El pago está listo cuando la página muestra la confirmación de pago y el cliente es enviado a tu página de éxito. Los pagos con tarjeta aparecen de inmediato en Money → Transactions; los pagos bancarios aparecen en Money → ACH Transactions y liquidan en el calendario bancario.

Si falta Pay by bank, enciende Bank (ACH / eCheck) en la tarjeta Payment methods. Si falta la caja de tarjeta de regalo, tu programa eGift no está activo. Si la porción con tarjeta de un pago dividido se rechaza, la redención del regalo se revierte automáticamente para que el saldo nunca quede varado.

1. 1Tarjeta: el flujo estándar con número enmascarado, ficha de marca, vencimiento en menús, CVV y código postal, con el botón Pay mostrando siempre el total exacto. Si tu cuenta aplica recargo a crédito, la caja desglosada Subtotal / Surcharge / Total aparece sobre Pay en tarjetas de crédito.
2. 2Pay by bank: el cliente conecta su banco o escribe los números de ruta y cuenta, acepta la autorización de débito en la página y el pago muestra el precio en efectivo con dual pricing. Liquida en unos días hábiles.
3. 3Tarjeta de regalo, parcial: con tu programa eGift activo, Have a Merchant360 gift card? aparece sobre los campos de tarjeta. Aplicarla muestra exactamente qué cubre y qué falta; la tarjeta del cliente paga el resto, y el recargo se calcula solo sobre la porción con tarjeta.
4. 4Tarjeta de regalo, total: una tarjeta de regalo que cubre todo quita los campos de tarjeta y el botón se vuelve Pay with gift card.

Desarrolladores: llaves de API y webhooks

La página Developers (en el menú de Merchant360, solo dueños) es la base para construir sobre Merchant360. Tiene dos partes: llaves de API con alcances y una consola de webhooks firmados con registro de entregas. Solo el dueño de la cuenta puede crear o revocar llaves y endpoints.

Llaves de API: cada llave tiene nombre, modo Test o Live y los alcances que permite. Los preajustes cubren Payments, Read-only o Everything, o marca alcances uno por uno. Las llaves Test van al sandbox y caen en Transacciones en modo de prueba; las Live mueven dinero real. La llave completa se muestra una vez al crearla. El mismo API cobra tarjetas y banco (ACH) por igual.

Webhooks: agrega tu endpoint https y elige qué eventos recibir: todos, o específicos como invoice paid, payment succeeded o refunded, y ach settled o returned. Cada entrega lleva un encabezado M360-Signature que tu servidor verifica con el secreto de firma, que se muestra una vez y puede rotarse.

Terminaste cuando la llave aparece bajo Your keys con su conteo de alcances y fecha de último uso, y el endpoint muestra Enabled con entregas en el registro Recent deliveries. Send test event comprueba el cableado antes de que lleguen eventos reales.

Si una entrega muestra estado fallido, revisa la columna Code (la respuesta HTTP de tu servidor) y haz clic en Retry; las entregas fallidas también se reintentan solas con espera creciente. Si una llave quedó expuesta, revócala y crea una nueva. Si no puedes ver la página, iniciaste sesión como miembro del equipo; es solo para dueños.

1. 1Llaves de API: bajo Create an API key escribe un Name, elige el Mode (Test o Live), elige un preajuste o marca Scopes y haz clic en Create key. Copia la llave del aviso Key created; no se mostrará de nuevo. Crear una llave pide un código de seguridad por texto.
2. 2Revoca una llave desde Your keys, o marca varias y haz clic en Revoke selected keys para revocarlas juntas.
3. 3Webhooks: haz clic en Add endpoint, escribe el Endpoint URL (https), elige All events o los eventos específicos y guarda. Guarda el Signing secret que se muestra una vez.
4. 4Sigue las entregas en Recent deliveries, con estado y conteo de intentos, y reintenta una fallida con Retry. Usa Send test event para confirmar tu receptor, Rotate secret si el secreto se filtra, y Disable o Delete para detener las entregas.