{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/cash/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Welcome to Monato Cash API Documentation","siteUrl":"https://docs.monato.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"welcome-to-monato-cash-api-documentation","__idx":0},"children":["Welcome to Monato Cash API Documentation"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"enabling-physical-cash-operations-in-mexico","__idx":1},"children":["Enabling Physical Cash Operations in Mexico"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-can-do-with-monato-cash-api","__idx":2},"children":["What You Can Do With Monato Cash API"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Cash-In Operations"]}," - Allow users to deposit money at physical locations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Cash-Out Operations"]}," - Allow users to withdraw money at physical locations (amount limits vary by location)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Monitor Operation Status"]}," - Track operations in real-time with status updates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook Integration"]}," - Receive real-time notifications when operations change status"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Management"]}," - Track daily limits and user operations"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-features","__idx":3},"children":["Key Features"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-secure-authentication","__idx":4},"children":["🔒 Secure Authentication"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["HMAC-SHA256 signature verification for all API calls"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-physical-location-integration","__idx":5},"children":["📱 Physical Location Integration"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Operations can be completed at physical payment locations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Different expiration windows: 3 days for cash-in, 60 minutes for cash-out (configurable)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Real-time status tracking"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-real-time-notifications","__idx":6},"children":["🔔 Real-Time Notifications"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Webhook support for status changes (paid, expired, reversed)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automatic webhook activation testing"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Secure webhook signature verification"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-comprehensive-monitoring","__idx":7},"children":["📊 Comprehensive Monitoring"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Operation status consultation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Daily user limits (5 operations per user per day)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Detailed error handling and validation"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"operation-types","__idx":8},"children":["Operation Types"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cash-in-operations","__idx":9},"children":["Cash-In Operations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Purpose"]},": Allow users to deposit money at physical locations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Limits"]},": No maximum amount limit"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expiration"]},": 3 days from creation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status Flow"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unpaid"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paid"]}," (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]},")"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cash-out-operations","__idx":10},"children":["Cash-Out Operations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Purpose"]},": Enable users to withdraw money at physical locations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Limits"]},": Maximum amount varies by physical location"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expiration"]},": 60 minutes by default, configurable by client"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status Flow"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unpaid"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paid"]}," (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]},")"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"getting-started","__idx":11},"children":["Getting Started"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"quick-integration-steps","__idx":12},"children":["Quick Integration Steps"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Get API Credentials"]}," - Contact our customer success team to obtain your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api_key"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api_secret"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configure Webhooks"]}," - Set up webhook endpoints for real-time notifications"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Operations"]}," - Start creating cash-in and cash-out operations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Monitor Status"]}," - Track operations and handle status updates"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"business-rules","__idx":13},"children":["Business Rules"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"amount-limits","__idx":14},"children":["Amount Limits"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cash-In / Cash-out"]},": Maximum amount varies by physical location"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"user-limits","__idx":15},"children":["User Limits"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Daily Limit"]},": Maximum 5 operations per user per day"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reset Time"]},": Limits reset at midnight (Mexico City timezone)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"document-validation","__idx":16},"children":["Document Validation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["INE"]},": 13 digits (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1234567890123"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CURP"]},": 18 characters (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ABCD123456HMNMNL01"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["RFC"]},": 10-13 characters (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ABCD123456ABC"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Phone"]},": Exactly 10 digits (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["5512345678"]},")"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"expiration-policy","__idx":17},"children":["Expiration Policy"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cash-In Operations"]},": Expire 3 days after creation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cash-Out Operations"]},": Expire 60 minutes after creation by default, but can be configured by the client to last longer"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Expired operations cannot be completed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automatic expiration handling via background jobs"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"need-assistance","__idx":18},"children":["Need Assistance?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Our engineering team is ready to support your integration journey:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Documentation"]},": Browse our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/cash/guides/quickstart"},"children":["Cash API Quickstart Guide"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Support"]},": Contact us at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:soporte@monato.com"},"children":["soporte@monato.com"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Monato: Powering the future of cash operations in Mexico"]}]}]},"headings":[{"value":"Welcome to Monato Cash API Documentation","id":"welcome-to-monato-cash-api-documentation","depth":1},{"value":"Enabling Physical Cash Operations in Mexico","id":"enabling-physical-cash-operations-in-mexico","depth":2},{"value":"What You Can Do With Monato Cash API","id":"what-you-can-do-with-monato-cash-api","depth":2},{"value":"Key Features","id":"key-features","depth":2},{"value":"🔒 Secure Authentication","id":"-secure-authentication","depth":3},{"value":"📱 Physical Location Integration","id":"-physical-location-integration","depth":3},{"value":"🔔 Real-Time Notifications","id":"-real-time-notifications","depth":3},{"value":"📊 Comprehensive Monitoring","id":"-comprehensive-monitoring","depth":3},{"value":"Operation Types","id":"operation-types","depth":2},{"value":"Cash-In Operations","id":"cash-in-operations","depth":3},{"value":"Cash-Out Operations","id":"cash-out-operations","depth":3},{"value":"Getting Started","id":"getting-started","depth":2},{"value":"Quick Integration Steps","id":"quick-integration-steps","depth":3},{"value":"Business Rules","id":"business-rules","depth":2},{"value":"Amount Limits","id":"amount-limits","depth":3},{"value":"User Limits","id":"user-limits","depth":3},{"value":"Document Validation","id":"document-validation","depth":3},{"value":"Expiration Policy","id":"expiration-policy","depth":3},{"value":"Need Assistance?","id":"need-assistance","depth":2}],"frontmatter":{"seo":{"title":"Welcome to Monato Cash API Documentation"}},"lastModified":"2026-06-23T21:56:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/cash","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}