Create an authorisation control beta

Creates an authorisation control for a given card. This prevents the card from being used with certain merchants, specified by their Merchant Category Code (MCC) or Merchant Identifier (MID).

Use mcc to block an entire merchant category or mid to block a specific merchant.

You can update a card's authorisation control at any point.

SecurityCommonAuth
Request
path Parameters
cardId
required
string <uuid> (cardId) <= 36 characters

The ID of the card to work with.

Example: e9293471-5eb3-4dbc-916c-dbaf9e2deefd
query Parameters
accountId
required
string (accountId)

The ID of the account to work with.

Example: accountId=C5462
personId
string <uuid> (personId) <= 36 characters

The ID of the person to work with.

Example: personId=775596ae-2624-40af-a9dc-9756110a4a04
Request Body schema: application/json
name
required
string <= 255 characters

Name of the authorization control.

id
string <= 36 characters

Unique identifier of the resource. If an id is not provided one will be generated.

active
boolean

If the auth control is active. Default is true.

startTime
string <date-time>

Date and time when the control goes into effect, in UTC.

endTime
string <date-time>

Date and time when the control ends, in UTC.

object

When including merchantScope only one of mcc or mid is required. Adding an mcc or mid will create a block against this merchant.

Responses
201

Created

400

Bad request

401

Unauthorised

403

Forbidden

404

Not found

405

Method not allowed

415

Unsupported media type

429

Too many requests

500

Internal server error

post/cards/{cardId}/auth-controls
Request samples
application/json
{
  • "name": "Spending controls",
  • "id": "82813e6b-6f2b-4f01-9b63-6f4c390cd590",
  • "active": true,
  • "startTime": "2023-03-14T12:08:53Z",
  • "endTime": "2023-03-14T12:08:53Z",
  • "merchantScope": {
    }
}
Response samples
application/json
{
  • "name": "Spending controls",
  • "id": "a1e54aed-8a68-4602-a792-30f4c67497cf",
  • "active": true,
  • "startTime": "2023-03-14T12:08:53Z",
  • "endTime": "2023-03-14T12:08:53Z",
  • "merchantScope": {
    }
}