Explora la guía

Enlaces de pago, widget y checkout

Deja que tus clientes te paguen sin factura.

Qué es

Formas de cobrar en línea sin hacer una factura: un enlace de pago que envías por correo o texto, una página de pago alojada y el Pay widget que pones en tu sitio web, botones Pay Now, y sesiones de checkout que tu desarrollador crea con la API. Cada pago pasa por tu cuenta de Merchant360 y llega a tus transacciones.

Para quién es

Negocios que cobran depósitos, montos sueltos, donativos o suscripciones por mensaje o en su propio sitio web, y los desarrolladores que les arman el checkout.

Antes de empezar
  • Tu procesamiento de tarjetas está aprobado y activo. El Pay widget no se puede activar hasta entonces.
  • Para enviar un enlace por texto, el número móvil del cliente. Para enviarlo por correo, su dirección de correo.
  • Para llaves de API y webhooks, inicia sesión como dueño de la cuenta. Solo el dueño puede crearlas o revocarlas.
En esta página

Envía un enlace de pago

Crea un enlace, envíalo por correo o texto y el cliente paga desde cualquier dispositivo.

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.

Pasos
  1. 1Ve a Accept Payments → Payment links y haz clic en New payment link. El formulario New payment link se abre arriba de tu lista.
    El formulario New payment link con Link name, Amount, Invoice #, Expires in (days), Description y los campos del cliente, arriba de la lista de enlaces
    New payment link abre el formulario arriba de tus enlaces.
  2. 2Opcional: escribe un Link name (solo lo ves tú, por ejemplo Depósito de marzo).
  3. 3Escribe el Amount. Déjalo en $0.00 para que el cliente elija el monto.
  4. 4Opcional: agrega un Invoice #, cambia Expires in (days) (30 de forma predeterminada; si lo dejas vacío, el enlace nunca vence) y escribe una Description.
  5. 5Escribe Customer name, Customer email y Customer phone. Cuando el correo es válido aparece la casilla Email the link to the customer con la dirección, ya marcada. Desmárcala si vas a enviar el enlace de otra forma.
  6. 6Si usas campos de pago personalizados, elige qué pide este enlace en Custom fields on this link: All fields, Choose fields o None.
  7. 7Haz clic en Create link. El recuadro verde Payment link created – share the URL below muestra la dirección con un botón Copy, y Emailed to con la dirección cuando el correo salió.
  8. 8Para enviar el enlace después o de nuevo, usa su fila: Copy URL, Email (revisa la dirección y haz clic en Send) o Text (escribe el número móvil y haz clic en Send). Solo aparecen mientras el enlace está PENDING.
  9. 9Revisa la columna Status: PENDING, PAID (con la marca y los últimos cuatro de la tarjeta), CANCELLED o EXPIRED. Para detener un enlace, haz clic en Cancel en su fila y confirma.
    La lista de Payment links con las columnas Created, Amount, For, Customer, Status y Pay URL, y Copy URL, Text y Cancel en cada fila pendiente
    Cada enlace pendiente tiene Copy URL, Email, Text y Cancel.
Es bueno saber

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.

En esta pantallaWhat it does
New payment linkAbre el formulario para crear un enlace.
Amount *El monto que paga el cliente. Déjalo en $0.00 para que el cliente elija el monto.
Invoice # (optional)Una referencia que se imprime en la página de pago, el recibo y la transacción.
Expires in (days)Cuánto tiempo el enlace puede pagarse. 30 por defecto; en blanco significa nunca.
Description (optional)De qué es el pago, mostrado al cliente y guardado en la transacción.
Link name (optional)Una etiqueta privada para tu tablero, por ejemplo Depósito de marzo.
Customer name / email / phone (optional)Liga el enlace a un cliente y habilita Text al número de teléfono.
Custom fields on this linkAll fields, Choose fields o None: cuáles de tus campos personalizados pregunta la página de pago.
Create linkCrea el enlace y muestra el aviso con la URL.
Copy URLPone la URL de pago en tu portapapeles.
TextEnvía el enlace por SMS al celular del cliente. Respeta STOP como todo texto de Merchant360.
CancelDetiene un enlace para que ya no pueda pagarse. La fila muestra Cancelled.
Filter linksFiltra el tablero por monto, cliente, número de factura o estado mientras escribes.
Created, Amount, For, Customer, Status, Pay URLLas columnas del tablero. Status es Pending, Paid, Cancelled o Expired.
Consejo
Envía el enlace por texto para el pago más rápido: el teléfono guardado del cliente se llena solo, y el SMS respeta STOP como todo texto de Merchant360. Deja el monto abierto para un bote de propinas o una donación.
Importante
Cada enlace se paga una sola vez. Después del primer pago exitoso muestra PAID y no se puede pagar de nuevo.
Si algo sale mal
Enter a valid amount.
Escribe el monto como número, o déjalo en $0.00 para un monto abierto.
Amount must be under $999,999.99.
Divide el monto en más de un enlace, o envía una factura.
Enter a valid mobile number.
Escribe los 10 dígitos del número móvil del cliente y haz clic en Send.
This number has opted out of texts (replied STOP).
El cliente dejó de recibir textos de tu negocio. Envía el enlace con Email, o usa Copy URL y envíalo tú.
The email was not sent
Revisa la dirección. Luego haz clic en Email en la fila del enlace y envíalo de nuevo.
Link is PAID – only a pending link can be texted.
Un enlace pagado, cancelado o vencido no se puede volver a enviar. Crea un enlace nuevo.
La fila no tiene Copy URL, Email ni Text
Solo aparecen en enlaces PENDING. El enlace ya se pagó, se canceló o venció.

Hazlo con la API:Payment links

Cobra en tu sitio web

Activa el Pay widget, elige qué acepta y agrégalo, o un botón Pay Now, a tu sitio.

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.

Antes de empezar
  • Tu procesamiento de tarjetas está activo. Mientras no lo esté, la página muestra Set up payment processing first.
Pasos
  1. 1Ve a Accept Payments → Pay widget. La primera vez, haz clic en Turn on the pay widget. El widget empieza con pagos únicos de monto fijo, un mínimo de $1 y un máximo de $10,000.
    La página Pay widget antes de activarse, con la tarjeta y el botón Turn on the pay widget
    La primera vez: Turn on the pay widget.
  2. 2La siguiente pantalla dice Pay widget is live y muestra Your API key una sola vez. Cópiala si un desarrollador la va a usar y haz clic en I've saved it →.
  3. 3Arriba de la página, revisa que la etiqueta de estado diga Live. Copy URL copia la dirección de tu página de pago; Preview la abre como la ve un cliente.
  4. 4Master switch: haz clic en el interruptor. ON significa que los clientes pueden pagar en tu página alojada y en el widget insertado. OFF significa que ven Payments aren't available. Se guarda al hacer clic.
    La página Pay widget con el estado Live, la dirección de la página de pago, Copy URL, Preview y el Master switch en ON
    La etiqueta de estado, la dirección de tu página de pago y el Master switch.
  5. 5Payment types: haz clic en el interruptor de cada tipo que quieras en ON. Cada cambio se guarda solo y muestra Saved. Un tipo en ON (excepto Fixed amount) muestra su propio enlace Preview y Copy.
    La tarjeta Payment types con Fixed amount, Donations, Save card on file, Pay external invoice, Pay Merchant360 invoice y Subscriptions
    Payment types: activa los que quieras.
  6. 6Amount range: escribe Minimum y Maximum y haz clic en Save. Save aparece cuando cambias un valor.
  7. 7Branding: elige un Brand color y haz clic en Save. El logo es el de Billing Settings → Business profile.
  8. 8Allowed return domains: escribe los dominios, uno por línea, a los que la página de pago puede enviar al cliente después de pagar, y haz clic en Save. El dominio de tu sitio web siempre está permitido.
  9. 9Receipts: opcional, From email (para que los recibos lleven tu marca) y BCC email (una copia de cada recibo), y haz clic en Save.
  10. 10Embed snippet: elige el Payment type (y el Amount para Fixed amount), agrega una Description si quieres, haz clic en Copy y pega el código en tu sitio web donde debe aparecer el formulario.
Es bueno saber

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.

En esta pantallaWhat it does
Turn on the pay widgetAparece una vez, antes de que exista el widget. Crea el widget y emite tu primera llave de API.
Live / Off / Revoked / Not configuredLa etiqueta de estado arriba de la página.
Copy URL / PreviewCopia la dirección de tu página de pago alojada, o la abre como la ve un cliente.
Master switchON acepta pagos en la página alojada y en el widget insertado. OFF muestra Payments aren't available en ambos.
Payment typesUn interruptor por tipo: Fixed amount, Donations, Save card on file, Pay external invoice, Pay Merchant360 invoice, Subscriptions. Cada uno se guarda solo.
Amount range: Minimum / MaximumLímites de cada pago único y donativo, revisados en el servidor.
Branding: Brand colorEl color de tu página de pago. El logo viene de Billing Settings → Business profile.
Allowed return domainsLos únicos dominios a los que la página de pago puede enviar al cliente después de pagar. El dominio de tu sitio web siempre está permitido.
Receipts: From email / BCC emailFrom pone tu marca en el recibo; BCC te envía una copia de cada recibo.
Embed snippet: Payment type, CopyEl código para pegar en tu sitio web según el tipo elegido.
Recent activityLos últimos 50 eventos de tu widget con When, Mode, Amount, Customer, Card y Outcome, y Refund en cada cobro. Acepta reembolsos parciales.
Consejo
Copia la URL pública de tu página de pago para compartirla directo, o usa Preview para ver exactamente lo que ve un cliente antes de enviarla.
Importante
Poner el Master switch en OFF detiene los pagos en tu página alojada, en cada widget insertado y en cada botón Pay Now al mismo tiempo.
Si algo sale mal
Set up card payment processing first – the pay widget needs active processing to be enabled.
Tu procesamiento aún no está activo. Haz clic en Set up billing tools o pregunta a Electronic Payments.
Minimum can't be below $1.00. / Maximum can't be above $1,000,000. / Minimum must be less than maximum.
Cambia el Amount range para que el mínimo sea de al menos $1.00 y menor que el máximo.
Brand color must be a 6-digit hex code like #1e293b.
Elige el color con el selector, o escribe un código como #1e293b.
From address isn't a valid email. / BCC address isn't a valid email.
Revisa que la dirección no tenga errores, o deja el campo vacío.
Los clientes ven Payments aren't available
El Master switch está en OFF. Ponlo en ON.
Se rechaza el tipo de un snippet
Ese tipo está en OFF en Payment types. Ponlo en ON.

Hazlo con la API:Pay widget

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.

Antes de empezar
  • El Pay widget está activado (ve El pay widget y tu página de pago).
Pasos
  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.
    La tarjeta Payment types con un interruptor y una descripción corta para cada tipo
    Cada tipo tiene su interruptor y su descripción.
  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.
Es bueno saber

Las suscripciones necesitan planes. En la página Subscriptions (enlazada desde el widget y listada en Recurrentes y planes del menú Accept Payments) 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.

En esta pantallaWhat it does
Payment typesLas seis casillas que deciden qué ofrece el widget. Coming soon marca un tipo aún no disponible en tu cuenta.
New planAbre el formulario New subscription plan: Plan name, Description, What's included, Amount, Billing period (Daily, Weekly, Every 2 weeks, Monthly, Bi-monthly, Quarterly, Every 6 months, Yearly), Number of payments, Free trial (days), One-time setup fee, Terms, Create plan.
Archive (plan)Oculta un plan a nuevas inscripciones. Los suscriptores existentes siguen cobrándose.
Subscribers: All / Active / Paused / Failed / CancelledFiltra la lista de inscripciones. Cada fila muestra el plan, el conteo de pagos y Next charge.
Pause / Resume / Retry now / CancelAcciones por suscriptor. Retry now vuelve a correr un cobro fallido una vez que el cliente actualizó su tarjeta.
Enable the Subscriptions payment type aboveEl aviso en la tarjeta de planes hasta que Subscriptions esté marcado.
Consejo
Activar más tipos no satura la página; el widget muestra solo lo que corresponde al enlace que el cliente abre.
Si algo sale mal
Enable the "Subscriptions" payment type above before customers can sign up.
Activa Subscriptions en Payment types en la página Pay widget.
Plan name is required.
Escribe un Plan name en el formulario New subscription plan.
Amount must be at least $1.00.
Los planes empiezan en $1.00.
Number of payments must be between 1 and 999, or left blank for open-ended.
Escribe un número de 1 a 999, o déjalo vacío para que el plan cobre hasta que se cancele.
Artículos relacionados

Hazlo con la API:Subscriptions

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.

Antes de empezar
  • El Pay widget está activado. Para un botón sin monto, Donations está en ON en Payment types.
  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.
Es bueno saber

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.

En esta pantallaWhat it does
Button textLa etiqueta del botón.
AmountUn monto fijo que cobra el botón. En blanco deja que el cliente escriba el monto (necesita Donations activo).
Open payment / DonationCómo se presenta un botón sin monto: una página Pay neutral, o con texto de donación.
DescriptionTexto opcional que acompaña a la página de pago y a tus reportes.
Button colorEl color del botón. Por defecto, el de tu marca.
SizeSmall, Medium o Large.
CornersPill, Rounded o Square.
Full widthEstira el botón al ancho de su contenedor.
OpensNew page, o Popup on your page. La ventana emergente no necesita instalación más allá de pegar el código y cae a la página de pago como respaldo.
Open in a new tabPara New page: abre la página de pago en una pestaña nueva.
Success URL (optional)Adónde va el cliente tras pagar. En blanco muestra el recibo con un botón Close.
PreviewLa vista en vivo del botón tal como se verá en tu sitio.
Button HTML / CopyEl botón completo con estilo para pegar en un constructor de sitios o correo.
Plain link / CopyLa URL de pago sola para apuntar cualquier botón o imagen existente.
Consejo
Un mismo botón puede vivir en tantos lugares como quieras, y sigue funcionando hasta que apagues el widget. ¿Verificas pedidos en tu propia página de agradecimiento? Mira Llaves de API para desarrolladores más abajo; la verificación ?m360_ref= comprueba que el pago realmente se acreditó.
Si algo sale mal
Enter an amount, or turn on “Donations” under Payment Types so customers can choose the amount.
Escribe un Amount en el botón, o activa Donations.
El cliente no llega a tu página de agradecimiento
Agrega el dominio de tu sitio web en Allowed return domains en la página Pay widget y haz clic en Save. La página de pago solo regresa a los clientes a esos dominios.
El botón abre una página que dice que los pagos no están disponibles
El Master switch está en OFF. Ponlo en ON.

Hazlo con la API:Pay buttons

Lo que ve tu cliente

La página de pago segura detrás de los enlaces, las sesiones de checkout, WooCommerce y la extensión.

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.

La página de checkout alojado – logo y nombre del negocio, resumen del pedido y el formulario seguro de tarjeta
El checkout alojado: tu logo y nombre, el resumen del pedido y el formulario seguro. La Payment Extension, el API, WooCommerce y LeadConnector abren esta misma página.
En esta pantallaWhat it does
Logo y nombre del negocioTomados de tu Business profile en Settings.
Resumen del pedidoEl monto, la descripción y las partidas que pasó tu sesión.
Apple PayPago con billetera de un toque donde se soporta. Muestra tu recargo o dual pricing en la hoja.
Pay with VaultLa barra que usan los clientes que regresan para pagar con una tarjeta guardada en cualquier parte de Merchant360, verificada por un código por texto.
Card number, Exp month, Exp year, CVV, Billing ZIPEl formulario seguro de tarjeta. El número se enmascara al salir del campo; el vencimiento se elige de menús.
Ficha de marcaVisa, Mastercard, Amex o Discover más Credit o Debit, mostrada desde los primeros dígitos.
Save my card with Vault to check out faster everywhereSin marcar por defecto. Guarda la tarjeta al aprobar, ligada al celular del cliente.
Campos de pago personalizadosCualquier campo que habilitaste para Checkout en Settings, preguntado antes de Pay.
Pay $XEl botón siempre muestra el total exacto que se cobrará a la tarjeta.
Aviso de modo de pruebaSe muestra en sesiones creadas con una llave Test. No se mueve dinero.

Hazlo con la API:Checkout sessions

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.
Tres estados del checkout alojado – captura de tarjeta, una tarjeta de regalo aplicada parcialmente con la tarjeta pagando el resto, y una tarjeta de regalo cubriendo todo
De izquierda a derecha: pago con tarjeta; una tarjeta de regalo cubre parte (la tarjeta paga el resto); una tarjeta de regalo cubre todo – sin tarjeta.
En esta pantallaWhat it does
Card / Pay by bankLa elección de forma de pago arriba del formulario. Pay by bank aparece solo cuando los pagos bancarios están activos.
Subtotal / Surcharge / TotalLa caja desglosada mostrada en tarjetas de crédito cuando hay un programa de recargo activo.
Card price / Cash priceAmbos totales con dual pricing; la forma de pago define cuál se cobra.
Have a Merchant360 gift card?Abre la captura de tarjeta de regalo cuando tu programa eGift está activo. Apply muestra qué cubre la tarjeta y qué falta.
Pay with gift cardEl botón cuando una tarjeta de regalo cubre el monto completo; no se necesita tarjeta.
Apple PayPago con billetera de un toque donde se soporta.
Consejo
¿Reembolsas un pedido pagado en parte con tarjeta de regalo? Reembolsa la porción de tarjeta normal, y anula la redención del regalo desde tus herramientas eGift para que el valor regrese a la tarjeta.

Hazlo con la API:Checkout sessions

Para desarrolladores

Llaves de API, sesiones de checkout y webhooks.

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.

  1. 1En la página Pay widget, baja a la tarjeta API key.
  2. 2Haz clic en Issue key (o Re-issue para reemplazar la llave que tienes).
  3. 3El recuadro New key issued – save this now muestra la llave completa. Haz clic en Show para leerla o en Copy para copiarla, y guárdala en tu servidor.
  4. 4Para desactivar una llave, haz clic en Revoke y confirma. Cualquier servidor que la use deja de funcionar.
Es bueno saber

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.

En esta pantallaWhat it does
Issue key / Re-issueCrea una llave o reemplaza la actual. La llave vieja deja de verificar de inmediato.
New key issued, save this nowLa vista única de la llave completa con Copy y Show / Hide. Al cerrar la tarjeta solo queda el prefijo.
RevokeDeshabilita la llave. Cualquier integración servidor a servidor que la use deja de funcionar.
No key on fileSe muestra hasta que emitas una llave. El widget y la página alojada funcionan sin ella.
Importante
Cualquiera con esta llave puede hacer cobros en tu cuenta. Guárdala en tu servidor, nunca en una página web.
Si algo sale mal
La tarjeta muestra No key on file.
No se ha emitido ninguna llave. El widget y la página alojada funcionan sin ella; haz clic en Issue key solo si un desarrollador la necesita.
Ya no aparece la llave completa
Solo se muestra una vez. Haz clic en Re-issue para una llave nueva y actualiza tu servidor.

Hazlo con la API:Authentication

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.

Pasos
  1. 1Ve a Accept Payments → Checkout.
  2. 2Haz clic en Get API keys para abrir Developers & API y crear una llave, en API docs para la referencia para desarrolladores, o en Try the demo para ver un checkout de ejemplo.
  3. 3Tu desarrollador crea sesiones de checkout con la API. Cada una aparece en Checkout sessions con su monto, descripción y correo del cliente.
  4. 4Revisa el estado de cada fila: OPEN, BANK PAYMENT PROCESSING, COMPLETE o EXPIRED. La marca test señala las sesiones hechas con una llave Test. Haz clic en view payment para abrir la transacción de una sesión pagada.
    La página Checkout con How Checkout works, Get API keys, API docs, Try the demo y la lista de sesiones de checkout con su estado
    Checkout: los botones para desarrolladores y cada sesión de checkout.
Es bueno saber

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.

En esta pantallaWhat it does
Get API keysAbre la página Developers para crear una llave Test o Live con el alcance de checkout.
API docsLa documentación de desarrollador para crear sesiones y manejar webhooks.
Try the demoAbre un checkout de muestra para ver la página alojada antes de integrar.
Checkout sessions (N)Cada sesión creada en tu cuenta, la más reciente primero, con un conteo de cuántas están pagadas.
OPEN / BANK PAYMENT PROCESSING / COMPLETE / EXPIREDEl estado de la sesión. OPEN espera al cliente; COMPLETE está pagada; EXPIRED no se pagó a tiempo.
testInsignia en sesiones creadas con una llave Test.
view paymentAbre la transacción detrás de una sesión completada.
Si algo sale mal
No checkout sessions yet. Create one through the API to see it here.
Las sesiones aparecen solo después de que tu sitio web o app las crea con la API.
Una sesión muestra EXPIRED
El cliente no pagó a tiempo. Crea una sesión nueva.

Hazlo con la API:Checkout sessions

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.

Antes de empezar
  • Iniciaste sesión como dueño de la cuenta. Otros usuarios ven Owner access required.
Pasos
  1. 1Ve a Accept Payments → Developers & API.
  2. 2En Create an API key, escribe un Name (por ejemplo Servidor de producción) y elige el Mode: Test o Live.
  3. 3En Scopes, marca read y write en cada área que necesite la llave, o haz clic en un preset: Payments, Read-only o Everything.
    Developers & API con Create an API key: Name, Mode Test o Live, y las casillas de Scopes con los presets Payments, Read-only y Everything
    Create an API key: nombre, modo y alcances.
  4. 4Haz clic en Create key y escribe el código que te llega por texto. Copia la llave de Key created – copy it now; no se vuelve a mostrar.
  5. 5Your keys lista cada llave con su número de alcances y su último uso. Haz clic en Revoke en una llave, o marca varias y haz clic en Revoke selected keys.
  6. 6En Webhooks, haz clic en Add endpoint. Escribe el Endpoint URL (https), deja All events (recommended) o desmárcalo y elige eventos, y haz clic en Create.
    La sección Webhooks con el campo Endpoint URL (https), All events (recommended), Create y Cancel
    Add endpoint: la URL y los eventos a enviar.
  7. 7Copia el Signing secret – shown once y guárdalo. Tu servidor lo usa para revisar el encabezado M360-Signature.
  8. 8En cada endpoint, los íconos son Send test event, Rotate secret, Disable (o Enable) y Delete.
  9. 9Recent deliveries lista Event, Status, Attempts, Code y When. Haz clic en Retry en una entrega FAILED, o en Refresh para recargar la lista.
Es bueno saber

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.

En esta pantallaWhat it does
Create an API key: Name, Mode, ScopesName etiqueta la llave (por ejemplo Production server). Mode es Test o Live. Scopes limita lo que la llave puede hacer; los preajustes son Payments, Read-only, Everything.
Create keyCrea la llave tras un código de seguridad por texto. El aviso Key created la muestra una vez con Copy.
Your keysCada llave con su conteo de alcances, fecha de último uso (o never used) y Revoke.
Revoke / Revoke N selected keysDeshabilita una llave o todas las marcadas. Las apps que las usen dejan de funcionar de inmediato.
Add endpointAbre el formulario: Endpoint URL (https), Events (All events, o específicos), Cancel.
Signing secret, shown onceEl secreto usado para verificar el encabezado M360-Signature. Guárdalo ahora; rota el endpoint si lo pierdes.
Enabled / DisabledSi el endpoint recibe entregas actualmente.
Send test eventEnvía un evento de muestra al endpoint para que confirmes tu receptor.
Rotate secretEmite un nuevo secreto de firma. El viejo deja de verificar de inmediato.
Disable / DeletePausa las entregas, o elimina el endpoint. Las entregas se detienen de inmediato.
Recent deliveries: When, Event, Status, Attempts, CodeEl registro de entregas por endpoint. Code es la respuesta HTTP de tu servidor. Refresh lo recarga.
RetryReenvía ahora una entrega fallida.
Consejo
Esto es territorio de desarrolladores. Si trabajas con un ISV o un desarrollador web, mándalos aquí; si no construyes software, puedes saltarlo.
Si algo sale mal
Only the account owner can manage API keys.
Inicia sesión como dueño, o pídele al dueño que cree la llave.
Grant at least one scope.
Marca al menos un alcance, o haz clic en un preset.
Enter an https URL.
Escribe la dirección completa del endpoint, empezando con https://.
Una entrega muestra FAILED
Code es la respuesta de tu servidor. Corrige el receptor y haz clic en Retry. Las entregas fallidas también se reintentan solas.
Se expuso una llave o un signing secret
Revoca la llave y crea una nueva, o haz clic en Rotate secret en el endpoint. El secreto anterior deja de funcionar de inmediato.

Hazlo con la API:Webhooks

Sigue leyendo
Hazlo con la API

Los desarrolladores pueden hacer lo mismo con la API de Merchant360.