---
updatedAt: 2025-09-22T21:32:14.000Z
agentTools:
  projectIndex: https://developers.digitalfemsa.io/llms.txt
---

# Resumen

<HTMLBlock>{`
<div style="color:#2C4CF5">
  <h2>Devoluciones de efectivo con Oxxo Pay</h2>
</div>
`}</HTMLBlock>

## Definición

En esta documentación encontrarás la guía para realizar Devoluciones de Efectivo, la solución que permite ofrecer a tus clientes reembolsos de aquellas compras en línea abonadas en efectivo en la cadena OXXO. La generación de referencias de Devolución está disponible vía API y también a través de Panel, este último, sin necesidad de integración.

## Características

* Expiración de la referencia de 7 días por default, customizable dentro de un rango de 1 a 365 días por Direct API.
* Servicio gratuito de notificaciones con referencia y código QR por mail a usuario final.
* Disponibilidad del servicio en tiendas OXXO de Lunes a Domingo de 06:00 a 22:00 horas.
* Monto mínimo $30.00 MXN y monto máximo $3,000.00 MXN por referencia. No se admiten decimales distintos de cero.
* Se pueden generar "n" referencias por orden hasta alcanzar el monto a devolver (siempre que no supere el monto total del pago original).
* OXXO cobrará en la tienda una comisión al usuario final de 17 mxn por transacción que será descontado del monto a devolver

## Flujo

### Panel Oxxo Pay

En caso de optar por generación de referencias de devolución a través de [Panel Oxxo Pay](https://panel.digitalfemsa.io/), el flujo es el siguiente:

<Image align="center" src="https://files.readme.io/61340e0-2.png" />

<br />

### Direct API

En caso de optar por generación de referencias de devolución a través de [Direct API](https://developers.digitalfemsa.io/docs/devolucion-efectivo-direct-api), el flujo es el siguiente:

<Image align="center" src="https://files.readme.io/befdd38-3.png" />

## Servicio de notificaciones

Oxxo Pay dispone de un servicio de notificaciones a usuario final que se activarán por default enviando mails a la dirección de correo del customer del cargo asociado de pago en efectivo.

**Notificaciones que se envían:**

| Notificación                | Descripción                                                                                                                                                  | Vía   |
| :-------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- | :---- |
| Generación de la referencia | Cuando se genera la referencia de cobro para que el usuario final acuda a un OXXO con el número y el QR.                                                     | Email |
| Cobro                       | Cuando el usuario final ha cobrado con el QR o la referencia de devolución de efectivo en cualquier OXXO del país.                                           | Email |
| Expiración                  | Cuando la referencia y el QR ya no son válidos para cobrar la devolución, después de los 7 días posteriores a su creación.                                   | Email |
| Cancelación                 | Cuando la referencia es cancelada por el comercio, se le envía una notificación al usuario final para informar que no tendrá validez la referencia indicada. | Email |

**Ejemplos de notificaciones**

### Generación de la referencia

<Image alt="Generación de la referencia" align="center" width="80% " src="https://files.readme.io/7b94d24-cashin.png">
  Generación de la referencia
</Image>

### Cobro

<Image alt="Cobro" align="center" width="70% " src="https://files.readme.io/0f3eb30-Screenshot_2024-05-24_at_11.31.01_AM.png">
  Cobro
</Image>

### Expiración

<Image alt="Expiración" align="center" width="70% " src="https://files.readme.io/75500e1-Screenshot_2024-05-24_at_11.33.13_AM.png">
  Expiración
</Image>