Administrative divisions V2 (deprecated)

Create administrative division (deprecated)

DEPRECATED. Call Create holiday calendar instead.

Create an administrative division.

This is a v2 endpoint that offers more granular control over financial activities on non-business days. To understand the differences between v1 and v2 endpoints, refer to Platform setup - Holidays and administrative divisions.

Request body

namestring required

Administrative division name

type'City' | 'State' | 'Country' required

Admin division type

parent_idinteger

Parent ID

external_idstring

Client-supplied external ID. It must comply with the rule ^[a-zA-Z0-9-]+$.

parent_external_idstring

Parent external ID. Must comply with the rule ^[a-zA-Z0-9-]+$.

working_daysinteger[]

Week days that are working days where 0 = Sunday and 6 = Saturday. The default - [1,2,3,4,5] - corresponds to Monday through Friday.

metadataMetadata

A valid JSON schema as specified in https://json-schema.org/specification.html. Used to register the rules that are used to authorize the transaction.

This object uses parameters to specify business rules for holidays. For details, see Posting Transactions on Holidays.

Note: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to Get started with Pismo APIs.

Example request

{
  "name": "Scotland",
  "type": "State",
  "external_id": "8675309",
  "parent_external_id": "8675309",
  "working_days": [
    1,
    2,
    3,
    4,
    5
  ]
}

Response

Created

idinteger

Admininistrative division ID