Personalizar enlaces de pago
Elija la marca, los módulos de checkout, los campos del cliente, los controles del enlace y la experiencia de retorno utilizados por los enlaces de pago de DEUNA.
En esta página
Use esta guía para decidir qué personalizar y dónde configurarlo. Un enlace de pago combina valores predeterminados a nivel de comerciante, configuraciones en un enlace individual y las reglas visuales compatibles con CustomStyle.
Elija el control correcto#
| Objetivo | Configúrelo en | Guía detallada |
|---|---|---|
| Establecer logotipo, color principal, configuración regional o dominio alojado | Configuración del comerciante con su TAM | Esta página |
| Habilitar inicio de sesión, información del cliente, facturación o resumen del pedido | Valores predeterminados del comerciante o compatible checkout_modules en el enlace | Configuraciones del widget |
| Establecer productos, métodos de pago, expiración, límites de compra o límites de reintento | DEUNA Admin o API de enlaces de pago | Administrar enlaces de pago o Enlace de pago a través de API |
| Cambiar el texto de checkout compatible y el estilo visual | CustomStyle | Resumen de CustomStyle |
| Enviar al cliente a una página del comerciante después de un resultado | URLs de retorno compatibles en el enlace | Enlace de pago a través de API |
| Confirmar el resultado de pago autoritativo | Recuperación en backend y webhooks | Ganchos web |
Establecer valores predeterminados del comerciante#
Trabaje con su TAM para definir la experiencia base heredada por los enlaces de pago. Confirme cada configuración para el comerciante y el entorno donde se ejecutará el enlace.
Marca, configuración regional y URL alojada
La presentación base puede incluir:
- logotipo de la empresa, alineación y tamaño;
- el color de acción principal;
- el idioma predeterminado orientado al cliente; y
- el dominio alojado de enlace de pago asignado al comerciante.
Mantenga un contraste suficiente para botones y texto de estado, use una imagen que permanezca legible en pantallas estrechas y pruebe la configuración regional configurada con etiquetas reales de productos y métodos de pago.
Módulos de checkout y datos del cliente
Los módulos determinan qué pantallas e información encuentra el cliente. Los mismos módulos están documentados para la experiencia de checkout general, por lo que sus reglas de campos permanecen centralizadas en Configuraciones del widget.
| Módulo | Propósito del Payment Link |
|---|---|
LoginPattern | Reconocer a un comprador que regresa e iniciar el flujo de contraseña de un solo uso compatible. |
UserInfoPattern | Recopilar los campos de identidad y contacto del cliente requeridos por el comerciante. |
BillingPattern | Recopilar información de facturación en el checkout principal o en una vista separada. |
OrderDetailPattern | Mostrar los productos y el desglose del monto asociado con el pedido. |
Para la información de facturación que se muestra directamente en el checkout principal, configura no más de cuatro campos. Si el pedido ya contiene datos de facturación, el cliente puede ver un resumen en lugar de un formulario vacío. Coloca el país antes del estado o provincia y la ciudad cuando se recopilen esos campos dependientes.
La recopilación de documentos de identidad es parte de la configuración de pago y datos del cliente. Usa la referencia de documento de identidad para revisar las etiquetas de documentos compatibles antes de solicitarlo.
Configurar un enlace individual#
Elige la ruta de creación que posee el enlace:
Un enlace creado por la API puede incluir estos grupos de configuraciones:
| Grupo de configuración | Qué controla |
|---|---|
| Pedido e ítems | Nombres de productos, cantidades, precios, impuestos, descuentos e imágenes visibles para el cliente. |
| Opciones de pago | Los métodos de pago y procesadores compatibles ofrecidos para ese enlace. |
checkout_modules | Módulos compatibles como LoginPattern, UserInfoPatterny OrderDetailPattern. Los valores predeterminados del comerciante se aplican cuando se omite este campo. |
configuration | Nombre del enlace, expiración, límite de compras completadas y límite de reintentos de pago. |
redirect_urls | Destinos del cliente compatibles para comportamiento de éxito, pendiente, error, cierre o respaldo. |
No uses un retorno del navegador como prueba de pago. Un cliente puede cerrar la página, perder conectividad o regresar mientras el resultado del proveedor aún está pendiente. Preserva el token del pedido y confirma el estado final mediante recuperación en el backend o Webhooks DEUNA.
Estilizar la interfaz de usuario orientada al cliente#
Uso CustomStyle para anulaciones visuales y de texto compatibles. Se aplica a las superficies de checkout de DEUNA; no cambia qué módulos están habilitados ni qué campos acepta la API de Payment Link.
Abre el Resumen de CustomStyle para seleccionar un área de checkout, previsualizarla y ensamblar un objeto consolidado. Consulta cada guía enfocada para conocer las limitaciones de Payment Link; no todos los elementos exclusivos del widget aparecen en la experiencia de Payment Link alojado.
Verificar la experiencia#
Antes de compartir un enlace de producción:
- Abre el enlace en escritorio y en una ventana gráfica móvil estrecha.
- Confirme el logotipo, el contraste, la configuración regional, la información del producto, los totales y los métodos de pago habilitados.
- Complete los flujos de cliente invitado y cliente recurrente cuando el inicio de sesión está habilitado.
- Valide cada campo obligatorio del cliente, de identidad y de facturación para el país de destino.
- Pruebe el comportamiento de éxito, pendiente, rechazo, cierre y enlace caducado.
- Confirme que cada destino del navegador funcione y que su backend aún reciba o recupere el resultado de pago autoritativo.