---
title: "Create Cash-In"
method: POST
path: "/api/v1/cash/cash_in"
---

# Create Cash-In

`POST /api/v1/cash/cash_in`

Creates a new cash-in operation that allows users to deposit money at physical locations.

- **Amount Limits**: 10 - 6000 MXN (may vary by physical location)
- **Expiration**: 3 days from creation (on closed references)
- **Reference**: 20-digit unique reference number

**Open References**: Some clients can create "open references" without specifying an amount upfront.
When creating an open reference, the `amount` parameter can be omitted, and the actual amount
will be determined at the time of payment at the physical location.

## Headers

- `X-Client-Id` string, required
- `X-Signature` string, required
- `X-Timestamp` string, required

## Request body

- CashInOperationRequest
  - `amount` integer — Transaction amount in MXN (required for standard cash-in, optional for open references)
  - `external_user_id` string, required — Unique identifier for the end user
  - `document_type` 'INE' | 'CURP' | 'RFC' — Type of identification document (optional)
  - `document_id` string — Document identification number (optional)
  - `phone` string — User's phone number - exactly 10 digits (optional)

## Response `201`

Cash-in created successfully

- CashOperationResponse
  - `response_code` string — Response code ("0" for success)
  - `response_text` string — Response message
  - `result` object
    - `operation_id` integer — Unique identifier for the operation
    - `kind` 'cash_in' | 'cash_out' — Operation type
    - `reference` string — 20-digit unique reference number for payment at physical locations
    - `status` 'close' | 'paid' | 'expired' | 'reversed' — Current operation status
    - `transaction_id` string — 25-character unique transaction identifier
    - `amount` integer — Transaction amount in MXN (0 for open references until paid)
    - `created_at` string, date-time — ISO 8601 timestamp of operation creation
    - `expire_at` string, date-time — ISO 8601 timestamp when operation expires

## Other responses

- `400` — Bad Request - Invalid operation parameters
- `401` — Unauthorized - Invalid or missing authentication

---

[API](https://skmtc.net/monato/apis/cash-api.md) · [All operations](https://skmtc.net/monato/apis/cash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monato/cash-api/revisions/eb100e723d5e/schema)