Welcome to Monato Cash API Documentation

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.

• 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

• HMAC-SHA256 signature verification for all API calls

• 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

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

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

• 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)

• 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)

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.

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

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

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

• 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)

• 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

Our engineering team is ready to support your integration journey:

• Documentation: Browse our Cash API Quickstart Guide
• Support: Contact us at soporte@monato.com

Monato: Powering the future of cash operations in Mexico