PUT//
To update a merchant group, send a PUT request to the /merchantgroups/{token} endpoint. Include the merchant group token path parameter to specify the merchant group to update.
URL path parameters
| Fields | Description |
|---|---|
| token string Required | Unique identifier of the merchant group. Allowable Values: Existing merchant group token |
Request body
| Fields | Description |
|---|---|
| active boolean Optional | Indicates if the merchant group is active or not. Allowable Values: true, falseDefault value: false |
| mids array of strings Optional | Comma-separated list of alphanumeric merchant identifiers. You can include merchant identifiers in multiple merchant groups. Use the exact MID value as it appears in the card_acceptor.mid field of your Gateway JIT Funding request or transaction webhook. Marqeta performs an exact match on this value — no normalization or formatting is applied. If a merchant presents multiple MID formats across transactions (for example, with or without leading zeros), include all observed forms to ensure consistent matching.Allowable Values: Valid array of one or more merchant identifiers |
| name string Optional | Name of the merchant group. Allowable Values: 1–40 chars |
Sample request body
JSON
{
"name": "My Merchant Group",
"mids": [
"234567890123"
],
"active": true
}
Response body
| Fields | Description |
|---|---|
| active boolean Conditionally returned | Indicates if the merchant group is active or not. Allowable Values: true, false |
| created_time datetime Conditionally returned | Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| last_modified_time datetime Conditionally returned | Date and time when the resource was last modified, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| mids array of strings Conditionally returned | Comma-separated list of alphanumeric merchant identifiers. Allowable Values: Valid array of one or more merchant identifiers |
| name string Conditionally returned | Name of the merchant group. Allowable Values: 40 char max |
| token string Conditionally returned | Unique identifier of the merchant group. Allowable Values: Existing merchant group token |
Sample response body
JSON
{
"token": "my_merchantgroup",
"name": "My Merchant Group",
"mids": [
"123456789012345",
"345123456789012",
"123456789012",
"234567890123"
],
"active": true,
"created_time": "2022-05-01T13:22:07Z",
"last_modified_time": "2022-05-01T13:32:07Z"
}