CHcheckout
Controls

Update a control

Updates an existing control.

put/issuing/controls/{controlId}

Request

Path parameters

controlIdstring required

The control's unique identifier.

Example:ctr_gp7vkmxayztufjz6top5bjcdra

Request body

OR
OR

Example request

{
  "description": "Allow the card to be used only in restaurants and supermarkets",
  "mcc_limit": {
    "type": "allow",
    "mcc_list": [
      "5932",
      "5411"
    ]
  }
}

Response

Control updated successfully

idstring required

The control's unique identifier.

descriptionstring

The description of the control.

control_type'velocity_limit' | 'mcc_limit' | 'mid_limit' required

The control's type.

A velocity_limit determines how much can be spent over a given period of time. An mcc_limit determines the types of businesses from which transactions can be processed. A mid_limit specifies the merchants from whom transactions can be processed.

target_idstring required

The ID of the card or control profile.

is_editableboolean required

Indicates whether you can change this control. <br> false This is an immutable control applied by Checkout.com and you cannot change it. <br> true You applied this control and can change it.

created_datestring UTC required
last_modified_datestring UTC required

Example response

{
  "id": "ctr_gp7vkmxayztufjz6top5bjcdra",
  "description": "Max spend of 500€ per week for restaurants",
  "control_type": "velocity_limit",
  "target_id": "crd_fa6psq42dcdd6fdn5gifcq1491",
  "is_editable": true,
  "created_date": "2021-09-09T19:41:39Z",
  "last_modified_date": "2021-09-09T19:41:39Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.