GET///
Retrieve a merchant (MID) exemption.
URL path parameters
| Fields | Description |
|---|---|
| token string Required | Unique identifier of the authorization control resource. Allowable Values: Existing authorization control resource token |
Response body
| Fields | Description |
|---|---|
| active boolean Conditionally returned | Indicates whether the merchant identifier authorization control exception is active. This field is returned if it exists in the resource. Allowable Values: true, false |
| association object Conditionally returned | Defines the group of users to which the authorization control applies. This object is required if the merchant_scope object is not included in your request. Your request can include both the association and merchant_scope objects.If you include this object in your request, you must populate one or more of its fields. If no fields are populated, the authorization control applies to all users. Allowable Values: card_product_token, user_token |
| association.card_product_token string Conditionally returned | Unique identifier of a card product. Specify a card product token in the card_product_token field to apply the authorization control to all users holding active cards associated with the card product.Pass either card_product_token or user_token, not both.Allowable Values: 1–36 chars |
| association.user_token string Conditionally returned | Unique identifier of a user. Specify a user token in the user_token field to apply the authorization control to a single user.Pass either card_product_token or user_token, not both.Allowable Values: 1–36 chars |
| created datetime Conditionally returned | Date and time when the resource was created, in UTC. This field is returned if it exists in the resource. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| end_time datetime Conditionally returned | Date and time when the exception ends, in UTC. This field is returned if it exists in the resource. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| last_updated datetime Conditionally returned | Date and time when the resource was last updated, in UTC. This field is returned if it exists in the resource. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| merchant_group_token string Conditionally returned | Unique identifier of the merchant group to be exempted. This field is returned if it exists in the resource. Allowable Values: 1–36 chars |
| mid string Conditionally returned | Merchant to be exempted. This field is returned if it exists in the resource. Allowable Values: 1–36 chars |
| name string Returned | Name of the merchant identifier authorization control exemption. Allowable Values: 255 char max |
| start_time datetime Conditionally returned | Date and time when the exception starts, in UTC. This field is returned if it exists in the resource. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| token string Conditionally returned | Unique identifier of the merchant identifier authorization control exemption. This field is always returned. Allowable Values: Existing merchant identifier authorization control exemption token |
Sample response body
JSON
{
"token": "my_exempt_token",
"name": "my_exempt_mid",
"association": {
"card_product_token": "my_card_product"
},
"mid": "12345678901",
"active": true,
"created_time": "2022-06-19T13:22:07Z",
"last_modified_time": "2022-06-19T13:22:07Z"
}