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

# Pruebas en sandbox

Para probar todo el flujo de Devoluciones de Efectivo, proporcionamos un *endpoint* con el que puedes validar tus transacciones y verificar que el comportamiento de tus reglas de validación y autorización de la Devolución funciona correctamente.

**URL:<https://api.digitalfemsafemsa.io/payout_orders/test>**

## Simular Devolución de Efectivo

En este punto se debe tener una referencia creada. El *endpoint* activará el evento con la notificación del retiro y finalizará el flujo de forma exitosa si los parámetros ingresados son correctos.

```json
{
  "payout_order_id": "4468474a-48ed-4732-9f8a-666238eaa0ac",
  "amount": "190500"
}
```

### Simular punto de venta

De esta forma simularemos el punto de venta de OXXO, realizando una validación de una referencia.

```curl Request - cURL
-H "Accept: application/vnd.app-v2.1.0+json" \
-H "Content-type: application/json" \
-u key_YOUR_PRIVATE_API_KEY: \
-X POST -d '{
        "payout_order_id": "4468474a-48ed-4732-9f8a-666238eaa0ac",
        "amount": "190500"
     }' https://api.digitalfemsa.io/payout_orders/test
```
```json Response - JSON
{
   "id":"00d62802-45cd-44fd-b207-f9ce5e865951",
   "amount": 190500,
   "currency":"MXN",
   "allowed_payout_methods":[
      "cash_refund"
   ],
   "reason":"Devolución de compra",
   "livemode":false,
   "object":"payout_order",
   "expires_at":1638047643,
   "metadata":{
      "custom_client_id":"12345"
   },
   "status":"pending_confirmation",
   "payouts":[
      {
         "id":"payout_2qrPNUP7n13BMnRWJ",
         "amount":190500,
         "currency":"MXN",
         "payout_method":{
            "object":"payout_method",
            "type":"cash"
         },
         "object":"payout",
         "expires_at":1638047643
      }
   ]
}
```

> 🚧 IMPORTANTE:
>
> En modo sandbox, NO es necesario esperar 3 minutos para la confirmación de la devolución, cambia de estado en forma automática.

| Parámetro         | Descripción       | Tipo                |
| :---------------- | :---------------- | :------------------ |
| payout\_order\_id | ID de transacción | Guid                |
| amount            | Monto del retiro  | int ($30.00 = 3000) |