Preguntas frecuentes
Encuentre la guía de DEUNA para preguntas comunes sobre la administración, las APIs, el proceso de pago, los SDKs, los plugins, las pruebas y los webhooks.
En esta página
Estas respuestas apuntan a la fuente de información actual en lugar de duplicar los contratos de configuración o API que pueden cambiar. Si una página no documenta una funcionalidad, considérala no confirmada y consulte a su gestor técnico de DEUNA (TAM) antes de utilizarla.
página de administración#
¿Cómo obtengo acceso a DEUNA Admin?
Un operador autorizado de su organización debe invitarle y asignar el rol necesario para su tarea. Comience con Administrar usuarios y roles, luego siga Autenticación de dos factores si su cuenta o organización lo requieren. Las credenciales de la API no crean una sesión de Admin.
¿Dónde configuro un procesador o método de pago?
Acceda a Conexiones En el panel de administración y siguiendo la guía correspondiente para ese proveedor. Los credenciales y la disponibilidad son específicos de la cuenta y el entorno. Utilice Conexiones para comprender el flujo de trabajo y catálogo de proveedores para confirmar que la funcionalidad está disponible antes de configurarla.
¿Puedo personalizar la apariencia del proceso de pago?
Sí, dentro de los controles compatibles con su experiencia de pago. Utilice Tema y controles compartidos para la configuración del tema DEUNA y la página de personalización específica del plugin o SDK cuando éste añade sus propias restricciones. Mantenga el contraste, la visibilidad y los diseños para dispositivos móviles utilizables después de cada cambio.
Integración mediante API#
¿Puedo integrarme directamente a través de la API?
Sí. Ejecute la guía rápida de la API desde un backend de confianza, y utilice catálogo de endpoints para el contrato público exacto de solicitud y respuesta. Nunca coloque una clave API privada en un navegador o aplicación móvil.
¿Qué credencial debo utilizar?
La respuesta depende de dónde se ejecuta la solicitud y de la autoridad que necesita. Un SDK de cliente utiliza el contexto de aplicación público documentado; las operaciones seguras de servidor a servidor utilizan una clave API privada; los flujos de clientes con inicio de sesión pueden utilizar además un token Bearer del cliente. La tabla de decisiones y los ejemplos de encabezados se encuentran en Claves de autenticación y API.
¿Cómo puedo realizar pruebas sin afectar la producción?
Utilice las credenciales de prueba y la URL base de prueba documentada en Fundamentos de integración. Mantenga las claves de prueba y producción, los webhooks, las cuentas de proveedor y la configuración del comerciante separados. Valide tanto los flujos exitosos como los fallidos antes de solicitar la activación en producción.
¿Dónde se documentan los códigos de respuesta y error?
El Errores y recuperación La referencia correspondiente explica los códigos de estado públicos y la recuperación segura. La referencia específica de un punto final es la autoridad para sus requisitos de solicitud, respuesta, audiencia y autorización.
Integración de pago, SDKs y plugins#
¿Qué integración de pago debo elegir?
Elija en función de la experiencia de usuario que desee controlar, la plataforma en la que se ejecuta y el límite de confianza para los datos de pago. Pago web compara la ruta principal de la web, mientras que el Descripción general del SDK Responsabilidades para aplicaciones Web, iOS, Android y React Native.
¿Dónde se encuentran los métodos y las funciones de devolución de llamada del SDK?
Comience en Descripción general del SDK, seleccione su plataforma y utilice la plataforma compartida. evento y respuesta Referencias donde corresponda. No se asume que las funcionalidades con nombres similares utilizan métodos idénticos en todas las plataformas.
¿Qué métodos de pago puedo mostrar?
La disponibilidad de los métodos de pago depende del país, la moneda, el canal, la conexión con el proveedor y la configuración de la cuenta. Filtre los resultados generados. catálogo de proveedores, y luego siga las instrucciones del proveedor o del método de pago seleccionado. No infiera la disponibilidad a partir de una captura de pantalla o del proceso de pago de otro comerciante.
¿Puedo integrarme a través de un plugin de comercio electrónico?
Uso Complementos Para ver las integraciones con plataformas de comercio mantenidas. Para VTEX, comience con Visión general de VTEX, complete las guías de instalación y configuración, y realice una prueba de compra antes del lanzamiento en producción.
¿Cómo afectan los cupones, los impuestos, el envío o las propinas al proceso de pago?
Estos pueden utilizar llamadas de retorno sincrónicas específicas del comerciante, siempre y cuando esa funcionalidad esté configurada para su cuenta. Webhook de pago dinámico Esta guía explica los límites de ejecución, el mapeo de solicitudes y respuestas, la validación y el manejo de errores. No utilice eventos o campos mutables que no hayan sido certificados para su uso.
Webhooks y resultados de pagos#
¿Necesito un webhook?
Utilice webhooks de estado cuando su backend debe reaccionar a los cambios en los pagos de forma asíncrona, sin depender del navegador, una redirección o una llamada de retorno de un SDK. Algunos métodos de pago alcanzan su estado final después de que el cliente abandona el proceso de compra. Implemente el flujo de notificación firmado y verificar el estado autorizado del pedido antes de la entrega o cualquier otra acción irreversible.
¿Qué ocurre si una notificación web se retrasa, se duplica o llega fuera de orden?
Verifique la firma, acepte permanentemente la notificación, elimine las duplicadas y evite que un evento anterior mueva su registro local hacia atrás. La entrega no es prueba de la semántica "exactamente una vez" o de la secuencia de ciclo de vida. Siga Reconozca y concilie y utilice un proceso de conciliación separado para los pagos sin resolver.
¿Es un callback o redirección del SDK prueba de pago?
No. La finalización en el lado del cliente es útil para la experiencia del cliente, pero su backend debe utilizar el resultado del lado del servidor y el flujo de estado asíncrono documentado antes de la entrega. Mantenga el estado de la interfaz de usuario, el estado del pago y el estado de liquidación como preocupaciones separadas.
Documentación y herramientas de IA#
¿Puede un agente de codificación con IA buscar en esta documentación?
Sí. Conecte un cliente compatible al acceso de solo lectura. Documentación de DEUNA para el servidor MCP. Busca la misma documentación pública, inventario de puntos finales y catálogo de proveedores publicados en este sitio, y no requiere ni acepta tus credenciales de DEUNA.
Una funcionalidad no está documentada. ¿Debería asumir que funciona?
No. Consulte con su representante de DEUNA o con el propietario del contrato público correspondiente. Incluya el entorno, el producto, el proveedor, la operación prevista y la página pública que consultó, pero elimine las claves de API, tokens, datos de tarjetas, claves privadas y datos del cliente.