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 y el cliente paga en una página segura.

1. 1Ve a Accept Payments → Payment Links y haz clic en New Payment Link.
2. 2Fija un monto, o déjalo en $0.00 para que el cliente elija cuánto pagar. Puedes agregar un número de factura, un vencimiento (30 días por defecto), una descripción y el nombre, correo y teléfono del cliente.
3. 3Haz clic en Create Link. Luego envíalo: Copy URL para pegarlo en un correo o chat, o Text para mandarlo directo al teléfono del cliente.
4. 4El enlace se bloquea tras el primer pago exitoso, así que no puede pagarse dos veces. Puedes cancelar un enlace cuando quieras, y el tablero muestra cada uno como Pending, Paid, Cancelled o Expired.

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 o previsualizar, y un formulario para insertar en tu sitio web para que los clientes paguen sin salir de él.

Ve a Accept Payments → Pay Widget y actívalo (necesita el procesamiento de tarjetas activo). Luego configúralo:

1. 1Interruptor maestro: enciende o apaga los pagos. Apagado, los visitantes ven un aviso de "pagos no disponibles".
2. 2Tipos de pago: elige qué acepta la página – un monto fijo, donaciones, guardar una tarjeta, pagar una factura o suscripciones.
3. 3Rango de montos: fija un mínimo y un máximo. Se validan en el servidor, así que nadie puede alterar el enlace para pagar fuera del rango.
4. 4Marca y recibos: fija tu color de marca y el correo remitente / BCC de los recibos (tu logo viene de tu perfil de negocio).
5. 5Insertar: copia el código y pégalo en tu sitio. Muestra un formulario seguro apuntado al procesador, así que ningún dato de tarjeta toca tu sitio.
6. 6Botón Pagar ahora: usa el generador de botones para crear un botón listo para pegar – define el texto, un monto y una descripción opcionales, y luego elige color, tamaño y esquinas. Copia el HTML del botón para tu sitio o correo, o simplemente copia el enlace simple y apunta a él cualquier botón que ya tengas. Deja el monto en blanco para que el cliente lo ingrese. Elige cómo se abre: una página nueva, o una ventana emergente en tu propio sitio para que el cliente nunca salga de tu página. Define una URL de éxito para enviar al cliente a tu propia página de agradecimiento después de pagar – la ventana emergente se cierra y redirige allí; déjala en blanco para mostrar el recibo con un botón Cerrar.

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.

1. 1Monto fijo – tú fijas el precio (por el monto del código, o el rango) y el cliente simplemente paga. Ideal para un producto, una reserva o una cuota fija.
2. 2Donaciones – quien dona elige el monto, de fichas preestablecidas o un valor propio. Ideal para organizaciones sin fines de lucro, propinas y paga-lo-que-quieras.
3. 3Guardar una tarjeta – sin cargo; la tarjeta del cliente se guarda segura en la bóveda para una factura o suscripción futura.
4. 4Pagar una factura externa – 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. 5Pagar una factura de Merchant360 – 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 – la encuentran ellos mismos.
6. 6Suscripciones – el cliente se inscribe en un plan recurrente que configuraste (semanal, mensual, etc.) y la tarjeta se cobra automáticamente.

Llaves de API para desarrolladores

Si construyes tu propio sitio o app, puedes emitir una llave de API desde el pay widget para cobros servidor a servidor. Emite una llave, reemítela para rotarla o revócala. La llave completa se muestra una sola vez, así que guárdala al crearla.

El widget insertado y la página de pago no necesitan la llave: se autentican con el propio código. La llave es solo para llamadas directas servidor a servidor.

Verifica un pago en tu página de agradecimiento: cuando un botón Pagar ahora envía al cliente a tu URL de éxito, agregamos ?m360_ref=... a la dirección. Desde tu servidor (nunca desde el navegador – la llave es un secreto), 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 4 dígitos de la tarjeta, para que confirmes el pedido antes de mostrar un recibo. Considera la redirección como una pista; esta verificación es la prueba.

Checkout para desarrolladores (sesiones alojadas)

Checkout (Accept Payments → Checkout) es para desarrolladores que integran pagos en su propio sitio o app. En vez de un constructor de páginas, creas una sesión de checkout segura por el API de Merchant360 y envías al cliente a una página de pago alojada; los datos de tarjeta nunca tocan tu sitio.

La página te da Get API keys, la documentación del API y un enlace Try the demo, más una lista de cada sesión (monto, descripción, cliente y estado: open, complete o expired). Si solo quieres cobrar sin código, usa un enlace de pago o el pay widget de arriba.

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.

El formulario está hecho para teclear con seguridad: 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. Las sesiones creadas con llave de prueba muestran un aviso de test mode y nunca mueven dinero.

Métodos de pago en el checkout alojado

El checkout alojado se adapta a cómo paga el cliente:

1. 1Tarjeta – el flujo estándar: 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. 2Tarjeta 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 de tarjeta).
3. 3Tarjeta 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. Si el cobro a la tarjeta se rechaza en un pago dividido, la redención del regalo se revierte automáticamente – el saldo nunca queda varado.

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.

1. 1Llaves de API: crea una llave con nombre, modo Test o Live y los alcances permitidos (los preajustes cubren Payments, Read-only o Everything). La llave completa se muestra una vez; guárdala. Crear una llave pide un código de seguridad por texto; revocar no – y puedes marcar varias llaves y revocarlas juntas en un clic. El mismo API cobra tarjetas y banco (ACH) por igual.
2. 2Webhooks: 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). Merchant360 firma cada entrega con un secreto que puedes rotar.
3. 3Sigue las entregas en el registro Recent deliveries, con estado y conteo de intentos, y reintenta una fallida. Las fallidas también se reintentan solas con espera creciente.