Create a cash-out operation | Cash

A cash-out operation lets your user withdraw money at a physical location. You create it, give your user the reference, and they collect the cash.

Request

Sign the request as described in Sign requests with HMAC.

Create a cash-out operation

curl -X POST "https://dev-api.finco.lat/api/v1/cash/cash_out" \
  -H "Content-Type: application/json" \
  -H "X-Client-Id: 4a8a08f09d37b73795649038408b5f33" \
  -H "X-Signature: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
  -H "X-Timestamp: 1705312200" \
  -d '{
    "amount": 250,
    "external_user_id": "USER789012",
    "document_type": "CURP",
    "document_id": "ABCD123456HMNMNL01",
    "phone": "5587654321"
  }'

Field	Required	Description
`amount`	Yes	Amount in MXN, integer, 50 to 3000. The minimum and maximum may vary by physical location.
`external_user_id`	Yes	Your unique identifier for the end user
`document_type`	No	`INE`, `CURP` or `RFC`
`document_id`	No	Document number. See document formats.
`phone`	No	Exactly 10 digits

See Create Cash-Out.

Response

201 Created

{
  "response_code": "0",
  "response_text": "Operacion creada",
  "result": {
    "operation_id": 124,
    "kind": "cash_out",
    "reference": "20511175512161627449",
    "status": "close",
    "transaction_id": "FMXdbnBuiw2SHqSyfzSkqN72q",
    "amount": 250,
    "created_at": "2025-01-15T10:30:00Z",
    "expire_at": "2025-01-15T11:30:00Z"
  }
}

Store the reference. Your user needs it to complete the operation at the physical location.

By default, the operation expires 60 minutes after creation. Check expire_at in the response.

Errors

Invalid parameters return 400. A rejected operation returns code 1:

400 Bad Request

{
  "response_code": "1",
  "response_text": "Operacion rechazada",
  "result": {
    "amount": 500,
    "external_user_id": "USER123456"
  }
}

See the error codes in Operation statuses.