Sign in
Card spending controls

Create card spending limit control (V2)

Creates a card spending limit control and applies it to all cards defined in the scope and scope_id of the request. <br> Important This endpoint replaces the old version. However, please note that you have to set the Api-Version header to the version you want (e.g., 2024-01-01). If you do not specify a version, then the API will return the older version of the response.

post/v1/card_controls/spending_limits(v2)

Request body

scope'CARD' | 'CARDHOLDER' | 'ACCOUNT' | 'BUSINESS' | 'PARTNER' | 'PARTNER_CARDS' | 'BUSINESS_CARDS' | 'ACCOUNT_CARDS' | 'CARDHOLDER_CARDS' | 'NON_BUSINESS_CARDS' | 'PARTNER_CARDHOLDERS' required

The scope of the card spending control.

scope_idstring required

ID of the resource that corresponds with the scope. For example, if the scope is PARTNER, then the scope_id would be your partner ID. For business, it would be the business ID.

idempotency_keystring uuid required

A randomly generated UUID which the server uses to recognize subsequent retries of the same request.

positive_balance_limitboolean

It is set to true if the limit field represents positive balance limit. It is an optional field. Default value is false.

Example request

{
  "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
  "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
  "limit": {
    "amount": 10000,
    "conditions": [
      {
        "dimension": [
          "5411"
        ],
        "excluded_dimension": [
          "5411"
        ]
      }
    ]
  }
}

Response

The card spending limit control was successfully created.

idstring required

ID of the created card spending limit control.

scope'CARD' | 'CARDHOLDER' | 'ACCOUNT' | 'BUSINESS' | 'PARTNER' | 'PARTNER_CARDS' | 'BUSINESS_CARDS' | 'ACCOUNT_CARDS' | 'CARDHOLDER_CARDS' | 'NON_BUSINESS_CARDS' | 'PARTNER_CARDHOLDERS' required

The scope of the card spending control.

scope_idstring required

ID of the resource that corresponds with the scope. For example, if the scope is PARTNER, then the scope_id would be your partner ID. For business, it would be the business ID.

origin'SOLARISBANK' | 'PARTNER' required

Indicates whether the card spending control was created by Solaris SE or by you.

idempotency_keystring uuid required

A randomly generated UUID which the server uses to recognize subsequent retries of the same request.

positive_balance_limitboolean

It is set to true if the limit field represents positive balance limit. It is an optional field. Default value is false.

Example response

{
  "id": "7a911b90-0109-11ec-9a03-0242ac130003",
  "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
  "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
  "limit": {
    "amount": 10000,
    "conditions": [
      {
        "dimension": [
          "5411"
        ],
        "excluded_dimension": [
          "5411"
        ]
      }
    ]
  }
}