Skip to main content

An MCC group defines a set of merchant category codes (MCCs) that you can reference from spend controls and authorization controls.

mccs
object[]
required

The set of merchant category codes that you want to include in this group. For each element, valid characters are 0-9, and the length must be 4 digits. You can also specify a range like "9876-9880". An MCC can belong to more than one group.

Maximum array length: 500
name
string
required

The name of the group.

Maximum string length: 255
token
string

The unique identifier of the group. If you do not include a token, the system will generate one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated.

Required string length: 1 - 36
active
boolean
default:true

[IMPROVED] Indicates whether the group is active or inactive. If omitted when creating a group, the group is created active — the create endpoint defaults a missing value to true, not false.

config
object

Allows for configuration options for this group, including control over the expiration of authorizations and automatic increases to the authorization amount.