POST/
Use this endpoint to create an MCC group.
You must have the
program-manager role to use this endpoint.Request body
| Fields | Description |
|---|---|
| active boolean Optional | Indicates if the group is active or inactive. Allowable Values: true, falseDefault value: false |
| config object Optional | 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 Optional | 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 apply to 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 Optional | 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 Optional | Controls automatic increases to the authorization amount for MCCs specified in this group. Allowable Values: type, value |
| config.authorization_controls.hold_increase.type string Required | 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 Required | 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 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 such as “9876-9880”. An MCC can belong to more than one group. Allowable Values: Existing merchant category codes |
| name string Required | Name of the MCC group. Allowable Values: 255 char max |
| token string Optional | 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 request body
JSON
{
"token": "my_mccgroup_01",
"name": "My MCC Group 01",
"mccs": [
"0123",
"2224-2230",
"3876"
],
"active": true,
"config": {
"authorization_controls": {
"hold_increase": {
"type": "PERCENT",
"value": 20
},
"hold_expiration_days": 2
}
}
}
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 apply to 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_01",
"name": "My MCC Group 01",
"mccs": [
"0123",
"2224-2230",
"3876"
],
"active": true,
"config": {
"authorization_controls": {
"hold_increase": {
"type": "PERCENT",
"value": 20
},
"hold_expiration_days": 2
}
}
}