Skip to main content
POST
Create MCC group
This feature is in Beta and not ready for production integration.

Authorizations

Authorization
string
header
required

Application (M2M) OAuth2 access token (client credentials).

Headers

X-Organization-ID
string<uuid>

ID of the organization to perform this operation on behalf of. Required for BANK and PLATFORM app token callers targeting a specific organization. If omitted, the request uses the authenticated caller's own organization. Must be a valid non-empty UUID. Present but malformed values return 400.

Body

Creates a Merchant Category Code group — a named, editable set of MCCs applied as an authorization control. The organization the group belongs to is taken from the caller's context (X-Organization-ID header or the caller's own org), never from the body.

id
string
required

Caller-supplied identifier, unique within the organization.

mccs
string[]
required

Four-digit MCCs, or hyphenated ranges (e.g. 9876-9880).

name
string
required

Human-readable name for the group.

active
boolean

Whether the group is active when created. Defaults to false.

Response

Created

A caller-managed Merchant Category Code group applied as an authorization control at the debit card issuer. Exactly one of Guid? MccGroupResponse.OrganizationId (organization-scoped) or Guid? MccGroupResponse.CardId (card-scoped) is set.

id
string
required
active
boolean
required
createdAt
string<date-time>
required
mccs
string[]
required
name
string
required
updatedAt
string<date-time>
required
cardId
null | string<uuid>
organizationId
null | string<uuid>