GET//
Use this endpoint to retrieve a specific MCC group.
URL path parameters
| Fields | Description |
|---|---|
| token string Required | Unique identifier of the MCC group. Allowable Values: |
Response body
| Fields | Description |
|---|---|
| active boolean Conditionally returned | Indicates if the group is active or inactive. Allowable Values: true, falseDefault value: false |
| config object Conditionally returned | Allows for configuration options for this group, including control over the expiration of authorizations and automatic increases to the authorization amount. Allowable Values: authorization_controls |
| config.authorization_controls object Conditionally returned | Controls the expiration of authorizations and automatic increases to the authorization amount for MCCs specified in this group. By default, these authorization controls apply program-wide, meaning that they impact every card in your program. You can, however, exempt cards associated with any particular card product by setting that card product’s allow_mcc_group_authorization_controls field to false.Allowable Values: hold_expiration_days, hold_increase |
| config.authorization_controls.hold_expiration_days integer Conditionally returned | Specifies the number of days after which an authorization associated with this group expires. Allowable Values: 1–100 Default value: 7 |
| config.authorization_controls.hold_increase object Conditionally returned | Controls automatic increases to the authorization amount for MCCs specified in this group. Allowable Values: type, value |
| config.authorization_controls.hold_increase.type string Returned | Controls whether the value field represents a fixed amount or a percentage of the authorization amount.Allowable Values: AMOUNT, PERCENT, UP_TO_LIMITDefault value: AMOUNT |
| config.authorization_controls.hold_increase.value decimal Returned | Specifies the amount of the automatic increase to the authorization amount. The type field controls whether this amount is a fixed amount or a percentage.Allowable Values: Format: 0.00 |
| mccs array of objects Returned | 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 such as “9876-9880”. An MCC can belong to more than one group. Allowable Values: Existing merchant category codes |
| name string Returned | Name of the MCC group. Allowable Values: 255 char max |
| token string Conditionally returned | Unique identifier of the MCC 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. Allowable Values: 1–36 chars |
Sample response body
JSON
{
"token": "my_mccgroup_02",
"name": "My MCC Group 02",
"mccs": [
"0123",
"2224-2230"
],
"active": true,
"config": {
"authorization_controls": {
"hold_increase": {
"type": "AMOUNT",
"value": 10
},
"hold_expiration_days": 3
}
}
}