# Welcome to Monato Cash API Documentation

## Enabling Physical Cash Operations in Mexico

Monato Cash API provides secure cash-in and cash-out operations for physical locations across Mexico. Our API enables businesses to create operations that users can complete at physical payment locations, with real-time webhook notifications for status updates.

## What You Can Do With Monato Cash API

- **Create Cash-In Operations** - Allow users to deposit money at physical locations
- **Create Cash-Out Operations** - Allow users to withdraw money at physical locations (amount limits vary by location)
- **Monitor Operation Status** - Track operations in real-time with status updates
- **Webhook Integration** - Receive real-time notifications when operations change status
- **User Management** - Track daily limits and user operations


## Key Features

### 🔒 Secure Authentication

- HMAC-SHA256 signature verification for all API calls


### 📱 Physical Location Integration

- Operations can be completed at physical payment locations
- Different expiration windows: 3 days for cash-in, 60 minutes for cash-out (configurable)
- Real-time status tracking


### 🔔 Real-Time Notifications

- Webhook support for status changes (paid, expired, reversed)
- Automatic webhook activation testing
- Secure webhook signature verification


### 📊 Comprehensive Monitoring

- Operation status consultation
- Daily user limits (5 operations per user per day)
- Detailed error handling and validation


## Operation Types

### Cash-In Operations

- **Purpose**: Allow users to deposit money at physical locations
- **Limits**: No maximum amount limit
- **Expiration**: 3 days from creation
- **Status Flow**: `unpaid` → `paid` (or `expired`)


### Cash-Out Operations

- **Purpose**: Enable users to withdraw money at physical locations
- **Limits**: Maximum amount varies by physical location
- **Expiration**: 60 minutes by default, configurable by client
- **Status Flow**: `unpaid` → `paid` (or `expired`)


## Getting Started

Our comprehensive documentation provides everything you need to integrate Monato's Cash API services into your applications. Whether you're building a financial platform, payment solution, or business management system, we've made implementation straightforward.

### Quick Integration Steps

1. **Get API Credentials** - Contact our customer success team to obtain your `api_key` and `api_secret`
2. **Configure Webhooks** - Set up webhook endpoints for real-time notifications
3. **Create Operations** - Start creating cash-in and cash-out operations
4. **Monitor Status** - Track operations and handle status updates


## Business Rules

### Amount Limits

- **Cash-In / Cash-out**: Maximum amount varies by physical location


### User Limits

- **Daily Limit**: Maximum 5 operations per user per day
- **Reset Time**: Limits reset at midnight (Mexico City timezone)


### Document Validation

- **INE**: 13 digits (e.g., `1234567890123`)
- **CURP**: 18 characters (e.g., `ABCD123456HMNMNL01`)
- **RFC**: 10-13 characters (e.g., `ABCD123456ABC`)
- **Phone**: Exactly 10 digits (e.g., `5512345678`)


### Expiration Policy

- **Cash-In Operations**: Expire 3 days after creation
- **Cash-Out Operations**: Expire 60 minutes after creation by default, but can be configured by the client to last longer
- Expired operations cannot be completed
- Automatic expiration handling via background jobs


## Need Assistance?

Our engineering team is ready to support your integration journey:

- **Documentation**: Browse our [Cash API Quickstart Guide](/products/cash/guides/quickstart)
- **Support**: Contact us at [soporte@monato.com](mailto:soporte@monato.com)


*Monato: Powering the future of cash operations in Mexico*