Skip to main content

​
Overview

Cash Collection Points are physical locations where users can make cash deposits, receive refunds, or perform other cash-based transactions. These points help bridge online platform operations with offline cash handling.

​
Create Collection Point

Create a new cash collection point location.
​
name
string
required
Name of the collection point (max 120 characters)
​
address
string
Physical address of the location (max 250 characters)
​
location
array
Geographic coordinates as [longitude, latitude]
​
contactPhone
string
Contact phone number (max 30 characters)
​
openingHours
object
Operating hours schedule (free-form object)
​
isActive
boolean
default:"true"
Whether the collection point is currently active
curl -X POST "https://api.rodando.com/cash-collection-points" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Centro Habana - Calle 23",
    "address": "Calle 23 #456, Centro Habana, La Habana",
    "location": [-82.3666, 23.1136],
    "contactPhone": "+53 7 555-0123",
    "openingHours": {
      "monday": "9:00 AM - 6:00 PM",
      "tuesday": "9:00 AM - 6:00 PM",
      "wednesday": "9:00 AM - 6:00 PM",
      "thursday": "9:00 AM - 6:00 PM",
      "friday": "9:00 AM - 6:00 PM",
      "saturday": "10:00 AM - 2:00 PM",
      "sunday": "Closed"
    },
    "isActive": true
  }'

{
  "id": "bb0e8400-e29b-41d4-a716-446655440000",
  "name": "Centro Habana - Calle 23",
  "address": "Calle 23 #456, Centro Habana, La Habana",
  "location": {
    "type": "Point",
    "coordinates": [-82.3666, 23.1136]
  },
  "contactPhone": "+53 7 555-0123",
  "openingHours": {
    "monday": "9:00 AM - 6:00 PM",
    "tuesday": "9:00 AM - 6:00 PM",
    "wednesday": "9:00 AM - 6:00 PM",
    "thursday": "9:00 AM - 6:00 PM",
    "friday": "9:00 AM - 6:00 PM",
    "saturday": "10:00 AM - 2:00 PM",
    "sunday": "Closed"
  },
  "isActive": true,
  "createdAt": "2026-03-09T10:00:00.000Z",
  "updatedAt": "2026-03-09T10:00:00.000Z"
}

​
Use Cases

​
Cash Deposits

Collection points can be used for users to deposit cash into their platform wallets. Staff at the collection point verify the deposit and update the user’s account.

​
Refund Processing

When processing refunds for cash payments, collection points serve as locations where users can collect their refund money. This is referenced in the normal refund flow for orders.

​
Prepaid Plan Purchases

Users can purchase prepaid plans with cash at collection points. The collection point ID is recorded with the transaction for tracking and reconciliation.

​
Location Format

The location field accepts coordinates in two formats: Array format (recommended): 
{
  "location": [-82.3666, 23.1136]
}
String format (comma-separated): 
{
  "location": "-82.3666, 23.1136"
}
Coordinates are stored as GeoJSON Point geometry with [longitude, latitude] order.

​
Opening Hours

The openingHours field is a flexible object that can store schedule information in any format. Common patterns include: Day-by-day schedule: 
{
  "openingHours": {
    "monday": "9:00 AM - 6:00 PM",
    "tuesday": "9:00 AM - 6:00 PM",
    "wednesday": "9:00 AM - 6:00 PM",
    "thursday": "9:00 AM - 6:00 PM",
    "friday": "9:00 AM - 6:00 PM",
    "saturday": "10:00 AM - 2:00 PM",
    "sunday": "Closed"
  }
}
Grouped schedule: 
{
  "openingHours": {
    "weekdays": "9:00 AM - 6:00 PM",
    "saturday": "10:00 AM - 2:00 PM",
    "sunday": "Closed"
  }
}
24/7 operation: 
{
  "openingHours": {
    "schedule": "24/7"
  }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us