Locations

Create a location

Creates a catalog location for the caller's organization.

post/v1/locations

Request

  • Base URL
    https://orders-api.paymongo.com
  • URL
    https://orders-api.paymongo.com/v1/locations
  • Auth
    HTTP basic

Request body

location_slugstring required
namestring required
order_number_mode'daily' | 'sequential'

OrderNumberMode is "daily" (resets each Asia/Manila day) or "sequential" (never resets). Defaults to "daily" when omitted.

pass_on_feesboolean

PassOnFees charges the payer the processing fees on every checkout session of this location. Defaults to false.

review_urlstring
warehouse_idsstring[]

WarehouseIDs are the inventories-api warehouses the location sells from, at most 100. Omit to leave the menu untracked.

Example request

{
  "location_slug": "bgc-branch",
  "name": "BGC Branch",
  "order_number_mode": "daily",
  "review_url": "https://g.page/r/bgc-branch/review",
  "warehouse_ids": [
    "ww_abc123"
  ]
}

Response

Created

has_moreboolean

Example response

{
  "data": {
    "created_at": "2026-06-24 07:55:00+00:00",
    "id": "loc_abc123",
    "livemode": true,
    "location_slug": "bgc-branch",
    "name": "BGC Branch",
    "order_number_mode": "daily",
    "purchase_validation_enabled": true,
    "review_url": "https://g.page/r/bgc-branch/review",
    "status": "live",
    "updated_at": "2026-06-24 07:55:00+00:00",
    "warehouse_ids": [
      "ww_abc123"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.