> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/feature-references/feature-references-lac-es/referencias-de-funciones-y-productos/tarjetas-de-flota-compatibilidad-con-mudflap.md).

# Tarjetas de flota - Compatibilidad con Mudflap

La compatibilidad con Mudflap para flotas comerciales permite a los sitios de Verifone Commander aceptar códigos de combustible de Mudflap como método de pago.

## Historial de revisiones

| Fecha               | Descripción      |
| ------------------- | ---------------- |
| 31 de julio de 2026 | Borrador inicial |

## Resumen

El soporte para flotas comerciales de Mudflap permite que los sitios de Verifone Commander acepten códigos de combustible de Mudflap como método de pago, ampliando la oferta Commander Fleet con aceptación directa de la red comercial de flotas de Mudflap junto con Comdata y WEX-OTR.

Mudflap es un servicio de pago de combustible usado por operadores propietarios y pequeñas flotas de camiones. En lugar de presentar una tarjeta física de flota, el conductor recibe un código numérico de combustible a través de la app móvil de Mudflap y presenta ese código en el punto de venta, en la caja para compras en el interior, o en el surtidor de combustible para abastecimiento en el exterior.

Con el soporte para flotas comerciales de Mudflap, Verifone Commander acepta estos códigos de combustible y los autoriza directamente con Mudflap en tiempo real. Mudflap funciona como proveedor de pagos para flotas comerciales en Commander, junto con las ofertas existentes de Comdata y WEX-OTR, y usa las mismas superficies de configuración, licencias e informes que el resto de la familia Commander Fleet.

El conductor paga a Mudflap a través de la app, el sitio nunca cobra directamente la tarjeta del conductor y Mudflap envía por correo electrónico al conductor un recibo compatible con IFTA después de cargar combustible. También hay un recibo impreso disponible en el sitio.

### Valor comercial

* Atrae al sitio la red nacional de conductores independientes y pequeñas flotas de Mudflap. El conductor paga a través de la app y el sitio recibe el pago mediante su liquidación normal de flota.
* Integración directa en Commander: no se necesita un terminal aparte ni hardware independiente para aceptar Mudflap.
* Coherente con la oferta de flota existente: la misma licencia comercial de flota, la misma área de configuración de Commander Central y los mismos informes estándar de flota.

### Comportamiento de la función

<table><thead><tr><th width="278.4443359375">Situación</th><th>Comportamiento</th></tr></thead><tbody><tr><td>El cliente paga en el interior con un código de flota</td><td>El cajero selecciona el método de pago Código de flota; se le pide al cliente que ingrese el código de combustible de la app de Mudflap. Mudflap autoriza la transacción en tiempo real.</td></tr><tr><td>El conductor carga combustible en el exterior, en el surtidor</td><td>El conductor ingresa el código móvil/de combustible en el surtidor. El abastecimiento se autoriza hasta el menor entre el monto aprobado por Mudflap y el límite del surtidor del sitio.</td></tr><tr><td>Prepago en el interior</td><td>El surtidor se detiene en el monto autorizado (o en el límite máximo de combustible del sitio, el que sea menor), incluso cuando se seleccionan varios productos de combustible.</td></tr><tr><td>Conexión con Mudflap</td><td>Commander verifica la conexión con el host de Mudflap aproximadamente una vez por minuto y refleja el resultado en el estado en línea del proveedor.</td></tr></tbody></table>

### Plataformas compatibles y requisitos previos

<table><thead><tr><th width="302.888916015625">Requisito</th><th>Detalles</th></tr></thead><tbody><tr><td>Software de Commander</td><td>Base057.01.00 o posterior</td></tr><tr><td>Commander Central (antes C-Site Management)</td><td>PCS v1.26.0 o posterior, para la configuración del sitio</td></tr><tr><td>Licencia</td><td>Licencia Comercial Fleet Direct (CFD): la misma licencia que se usa para Comdata y WEX-OTR. Todos los proveedores de flotas comerciales en el sitio se habilitan juntos y vencen juntos con esta licencia. Mudflap requiere específicamente el tipo de licencia Direct; consulte Restricciones de funciones.</td></tr><tr><td>Inscripción en Mudflap</td><td>El sitio debe estar inscrito en Mudflap y tener disponibles sus credenciales comerciales de Mudflap (ID de comerciante y token de acceso) para la configuración.</td></tr></tbody></table>

### Restricciones de la función

* No se admiten reembolsos para los medios de pago de Mudflap. Los intentos de reembolso con el método de pago Código de flota se rechazan en el punto de venta.
* No se admite el procesamiento en reserva (sin conexión). Si no se puede contactar al host de Mudflap, las nuevas transacciones de Mudflap se rechazan en lugar de aprobarse localmente.
* No se admite la aprobación parcial para ventas en el interior. Si el monto que aprueba Mudflap es menor que el total del ticket, la transacción se rechaza; el cliente puede volver a intentar con menos artículos o con otro método de pago.
* Mudflap solo está disponible con la licencia Comercial Fleet Direct. En sitios con licencia Comercial Fleet Primary, las tarjetas Comdata y WEX-OTR siguen procesándose a través del procesador de pagos principal del sitio, pero los códigos de combustible de Mudflap no se aceptan en absoluto: Mudflap no tiene respaldo del procesador principal.

### Interacción con otras funciones

* **Comdata y WEX-OTR:** Mudflap coexistirá con ambos. A diferencia de esos proveedores, los códigos de combustible de Mudflap se aceptan tanto en posiciones de caja comerciales como minoristas; los códigos de flota de Comdata y WEX-OTR ingresados en una posición minorista siguen rechazándose.
* **Teclas suaves de la pantalla de inactividad:** La tecla suave de código móvil puede aparecer en las posiciones de caja independientemente del estado de la licencia de flota comercial. Los sitios agregan o quitan la tecla suave por posición de caja o de surtidor según sus propios requisitos.
* **Códigos de producto:** Los artículos se envían a Mudflap usando códigos de producto NACS estándar: no se requiere un mapeo especial de productos en el sitio.

## Configuración del soporte para flotas comerciales de Mudflap

Mudflap se habilita mediante la licencia de flota comercial (Direct). Cuando la licencia está presente en el sitio, el proveedor Mudflap queda disponible; cuando la licencia no está presente o vence, el proveedor se deshabilita junto con los demás proveedores de flota comercial.

### Configuración desde Commander Central

Mudflap se configura desde Commander Central en la misma área de configuración que los demás proveedores de flota comercial. La configuración se envía desde Commander Central al Commander del sitio y se conserva a través de las actualizaciones de software.

Configure la configuración de Mudflap en Commander Central desde **Operaciones de pago > Commander Fleet > Proveedores > Mudflap**

![](https://content.gitbook.com/content/5nJgnNKJ9ZrZeEdr7pqh/blobs/s2GoM06Zj4rcLrlCWYb3/images/image1.jpeg)

<table><thead><tr><th width="237.3333740234375">Configuración</th><th>Descripción</th></tr></thead><tbody><tr><td>Token de acceso</td><td>La credencial de acceso de Mudflap del sitio. El valor se oculta en pantalla, se almacena cifrado y solo es visible para los administradores (comerciante y organización del comerciante) y el personal de soporte de Verifone.</td></tr><tr><td>ID de comerciante (MID)</td><td>El identificador de comerciante de Mudflap del sitio.</td></tr><tr><td>URL del host</td><td>La dirección del servicio de Mudflap. Se proporciona un valor predeterminado; cámbielo solo si se le indica.</td></tr></tbody></table>

### Configuración del punto de venta

Para la aceptación en el interior, el sitio agrega una entrada Code al registrador como una tecla suave que actúa como un MOP de entrada manual, lo que activa el mensaje al cliente para el código de combustible. Para la aceptación en el exterior, la tecla suave de código móvil se agrega a las posiciones de surtidor deseadas.

{% stepper %}
{% step %}
En Commander Central, abra la configuración del Commander y seleccione **Forecourt > DCR > Configuración de DCR**

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FFrCefqjxWLrCClUKk78e%2Fimage.png?alt=media&amp;token=14cf023b-f35a-431a-baec-3d3b55791289" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Vaya a la pestaña Pantalla de inactividad.
{% endstep %}

{% step %}
Haga clic en una ranura vacía de tecla programable y elija **CODE** de la lista Tipo de tecla suave y luego guarde.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FxKufN3DilPrF4HrfTVu9%2Fimage.png?alt=media&amp;token=e019fe35-69f0-4bf4-9be2-55e1bb80eb0a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
En el sitio, actualice el Config Client y confirme que la tecla CODE aparece en el diseño de la pantalla de inactividad del DCR.
{% endstep %}

{% step %}
Realice una inicialización completa de Fuel y DCR para aplicar el cambio a los surtidores.

<figure><img src="https://770378058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FiOekZyDQXlAmsbOicoFM%2Fimage.png?alt=media&amp;token=fe521b79-8a51-44ec-bf4f-20ec22e3436a" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Es bueno saberlo:** La opción CODE aparece en Commander Central solo para Commanders en Base057.01.00 o posterior. Si la configuración DCR de un sitio se copia a un Commander con una versión más antigua, la tecla CODE se omite automáticamente (el espacio muestra NA).
{% endhint %}

## Uso del soporte para flotas comerciales de Mudflap

### Ventas en el interior

{% stepper %}
{% step %}

## Registre los artículos del cliente

Registre los artículos del cliente como de costumbre.
{% endstep %}

{% step %}

## Seleccione la tecla suave Code

Al cobrar, seleccione el método de pago Código de flota.
{% endstep %}

{% step %}

## Ingrese el código de combustible

Se le pide al cliente que ingrese el código de combustible de su app de Mudflap.
{% endstep %}

{% step %}

## Autorice la transacción

Commander envía el código a Mudflap para su autorización.
{% endstep %}

{% step %}

## Complete o vuelva a intentar la venta

Si se aprueba, la venta se completa y se imprime el recibo. Si se rechaza, se muestra el mensaje devuelto por Mudflap: el cliente puede volver a intentarlo con otro método de pago.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
La aprobación debe cubrir el monto total del ticket. Si Mudflap aprueba menos que el total del ticket, la venta se rechaza; pida al cliente que quite artículos o use otro método de pago para la diferencia.
{% endhint %}

### Abastecimiento prepago

Para un prepago en el interior, el abastecimiento se detiene en el monto autorizado o en el límite máximo de combustible del sitio, el que sea menor. Esto también aplica cuando el cliente selecciona varios productos de combustible dentro del mismo prepago: el monto total dispensado no puede exceder el total autorizado.

### Abastecimiento en el exterior en el surtidor

{% stepper %}
{% step %}

## Seleccione la opción de código

El conductor selecciona la opción de código móvil/de combustible en el surtidor.
{% endstep %}

{% step %}

## Ingrese el código de combustible

El conductor ingresa el código de combustible de la app de Mudflap.
{% endstep %}

{% step %}

## Inicie el abastecimiento

Después de que Mudflap apruebe, el abastecimiento queda habilitado hasta el menor entre el monto aprobado y el límite del surtidor del sitio.
{% endstep %}
{% endstepper %}

### Rechazos y errores

Cuando una transacción no se puede completar, se muestra un mensaje tanto en la pantalla del cajero como en la del cliente. La primera línea indica la categoría; cuando Mudflap proporciona un motivo específico, aparece en una segunda línea. Los mensajes están disponibles en inglés y español.

| Mensaje                                                                                                             | Qué significa                                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Saldo insuficiente                                                                                                  | Venta en el interior: el monto que aprobó Mudflap es menor que el total del ticket. La venta se rechaza y cualquier monto que Mudflap haya reservado se libera automáticamente: no queda ningún fondo retenido. Vuelva a intentar con menos artículos o con otro método de pago. |
| Ubicación o código de combustible no encontrado. / p. ej., "El código de combustible no es válido o no se reconoce" | El código de combustible es incorrecto o expiró, o Mudflap no reconoce el sitio. Pida al conductor que revise el código en su app de Mudflap.                                                                                                                                    |
| La autorización falló. Comuníquese con el soporte de Mudflap.                                                       | Las credenciales de Mudflap del sitio no se están aceptando. Revise la configuración de Mudflap del sitio o comuníquese con soporte.                                                                                                                                             |
| Transacción rechazada por el host. / más el motivo de Mudflap                                                       | Mudflap rechazó la transacción por otro motivo; la segunda línea muestra la causa específica.                                                                                                                                                                                    |

Si se pierde la conexión con Mudflap después de que se completa el abastecimiento, Commander vuelve a intentar automáticamente el mensaje de pago final aproximadamente una vez por minuto, hasta diez veces. Si aún no puede comunicarse con Mudflap, la transacción se coloca en la lista de excepciones y aparece en el informe de excepciones de Mudflap para seguimiento.

## Comportamientos conocidos y casos límite

<table><thead><tr><th width="334">Escenario</th><th>Comportamiento esperado</th></tr></thead><tbody><tr><td>Se ingresa un código de combustible de Mudflap en una posición de caja minorista (no comercial)</td><td>La transacción se procesa normalmente. Los códigos de flota de Comdata y WEX-OTR ingresados en una posición minorista se rechazan.</td></tr><tr><td>La licencia comercial de flota ha vencido, pero la tecla suave de código móvil sigue en pantalla</td><td>La tecla suave aún puede mostrarse, pero las transacciones de flota no se procesan. Los sitios pueden quitar la tecla suave de posiciones individuales si lo desean.</td></tr><tr><td>Mudflap aprueba menos que el total del ticket en una venta en el interior</td><td>La transacción se rechaza con "Saldo insuficiente" en ambas pantallas, y el monto reservado se libera automáticamente. El cliente puede volver a intentar con menos artículos.</td></tr><tr><td>El sitio está licenciado como Commercial Fleet Primary (no Direct)</td><td>Los códigos de combustible de Mudflap no se aceptan en absoluto, mientras que las tarjetas Comdata y WEX-OTR siguen procesándose a través del procesador de pagos principal del sitio.</td></tr><tr><td>Prepago con varios productos de combustible</td><td>El abastecimiento total de todos los productos se detiene en el monto autorizado.</td></tr><tr><td>Condiciones de sobrecarrera del surtidor en un prepago</td><td>El surtidor se detiene en el monto autorizado o en el límite máximo de combustible del sitio.</td></tr><tr><td>El host de Mudflap no está disponible</td><td>Las nuevas transacciones se rechazan: no hay aprobación en reserva. El estado en línea del proveedor refleja el estado de la conexión, que se verifica aproximadamente una vez por minuto.</td></tr><tr><td>No se puede llegar a Mudflap al completar después del abastecimiento</td><td>Commander vuelve a intentarlo automáticamente y luego coloca la transacción en la lista de excepciones, visible en el informe de excepciones.</td></tr><tr><td>Actualización de software (Actualización automática)</td><td>La configuración de Mudflap, incluido el token de acceso, se conserva durante la actualización.</td></tr></tbody></table>

## Informes

Mudflap usa el mismo conjunto estándar de reportes de flota del lado del terminal que los demás proveedores de flota comercial:

* **Resumen diario del terminal** -- totales a nivel de día para la actividad de Mudflap (pensado principalmente para uso de back office).
* **Detalle** -- detalle a nivel de transacción (pensado principalmente para uso de back office).
* **Detalles de excepciones del día** -- transacciones que no se pudieron finalizar con Mudflap, con el resultado del fallo, el monto, el número de rastreo (STAN) y el número de cuenta, además de los totales de excepciones. Este es el informe que debe revisarse cuando una finalización no pudo llegar a Mudflap.

Para imprimir el informe de excepciones en el punto de venta:

{% stepper %}
{% step %}

## Abra el menú de red

Desde Funciones de CSR, abra el menú de red.
{% endstep %}

{% step %}

## Seleccione el informe seguro EPS

Seleccione el informe seguro EPS.
{% endstep %}

{% step %}

## Abra el informe de excepciones

Seleccione Informe de MudFlap y luego Informe de excepciones.
{% endstep %}
{% endstepper %}

![](https://content.gitbook.com/content/5nJgnNKJ9ZrZeEdr7pqh/blobs/ytd5rFOM6DzLfQetPV3Q/images/image2.png)

*Ejemplo del informe de excepciones de Mudflap.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verifone.com/feature-references/feature-references-lac-es/referencias-de-funciones-y-productos/tarjetas-de-flota-compatibilidad-con-mudflap.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
