Skip to content

Spend Controls

Manage spend rules and authorisation forwarding to approve or reject card payments in real time.

Operations
Webhooks

Get all spend rules for a managed card

Request

Fetch the list of spend rules associated with the managed card identified by the id path parameter.

Security
auth_token and api-key
Path
idstring^[0-9]+$required
curl -i -X GET \
  'https://sandbox.weavr.io/multi/managed_cards/{id}/spend_rules' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'api-key: YOUR_API_KEY_HERE'

Responses

Success

Headers
request-refstringrequired

A request identifier. Providing this reference when contacting our support team will help us investigate your query.

Bodyapplication/json
cardLevelSpendRulesobject(CardLevelSpendRules)
profileLevelSpendRulesobject(ProfileLevelSpendRules)
identityLevelSpendRulesobject(IdentityLevelSpendRules)
allowedMerchantCategoriesArray of strings, <= 200 itemsdeprecated

Whitelist MCC: A list of allowed merchant category codes (MCCs). If the MCC does not match, then the transaction will be declined. If an MCC is also in the blocked list, the blocked list will take precedence. This field is deprecated - use "cardLevelSpendRules"."allowedMerchantCategories" instead.

blockedMerchantCategoriesArray of strings, <= 200 itemsdeprecated

Blacklist MCC: A list of disallowed merchant category codes (MCCs). If the MCC matches, then the transaction will be declined. If an MCC is also in the allowed list, the blocked list will take precedence. This field is deprecated - use "cardLevelSpendRules"."blockedMerchantCategories" instead.

allowedMerchantIdsArray of strings, <= 200 itemsdeprecated

Whitelist Merchant Id: A list of allowed merchant IDs. If the Merchant Id does not match, then the transaction will be declined. If a Merchant Id is also provided in the blocked list, the blocked list will take precedence. This field is deprecated - use "cardLevelSpendRules"."allowedMerchantIds" instead.

blockedMerchantIdsArray of strings, <= 200 itemsdeprecated

Blacklist Merchant Id: A list of disallowed merchant IDs. If the Merchant Id matches, then the transaction will be declined. If a Merchant Id is also in the allowed list, the blocked list will take precedence. This field is deprecated - use "cardLevelSpendRules"."blockedMerchantIds" instead.

allowedMerchantCountriesArray of strings, <= 50 itemsdeprecated

Whitelist Merchant Country: A list of allowed merchant countries, in ISO 3166-1 alpha-2 format. If the Merchant country does not match, then the transaction will be declined. If a Merchant Country is also provided in the blocked list, the blocked list will take precedence. This field is deprecated - use "cardLevelSpendRules"."allowedMerchantCountries" instead.

blockedMerchantCountriesArray of strings, <= 50 itemsdeprecated

Blacklist Merchant Country: A list of disallowed merchant countries, in ISO 3166-1 alpha-2 format. If the Merchant country matches, then the transaction will be declined. If a Merchant Country is also in the allowed list, the blocked list will take precedence. This field is deprecated - use "cardLevelSpendRules"."blockedMerchantCountries" instead.

allowContactlessbooleandeprecated

Indicates if a contactless transaction is allowed on the card. This field is deprecated - use "cardLevelSpendRules"."allowContactless" instead.

allowAtmbooleandeprecated

Indicates if an ATM Withdrawal transaction is allowed on the card. This field is deprecated - use "cardLevelSpendRules"."allowAtm" instead.

allowECommercebooleandeprecated

Indicates if an online transaction is allowed on the card. This field is deprecated - use "cardLevelSpendRules"."allowECommerce" instead.

allowCashbackbooleandeprecated

Indicates if a cashback transaction at a physical terminal is allowed on the card. This field is deprecated - use "cardLevelSpendRules"."allowCashback" instead.

allowCreditAuthorisationsbooleandeprecated

Indicates if a the card can receive a credit transaction. This field is deprecated - use "cardLevelSpendRules"."allowCashback" instead.

minTransactionAmountinteger, (int64), >= 0deprecated

The minimum transaction amount, in card currency, that is allowed. If the transaction amount is less than this value, then the transaction will be declined. Omit this, or set to 0 if no maximum transaction amount is to be set. This field is deprecated - use "cardLevelSpendRules"."minTransactionAmount" instead.

maxTransactionAmountinteger, (int64), >= 0deprecated

The maximum transaction amount, in card currency, that is allowed. If the transaction amount is greater than this value, then the transaction will be declined. Omit this, or set to 0 if no maximum transaction amount is to be set. This field is deprecated - use "cardLevelSpendRules"."maxTransactionAmount" instead.

spendLimitArray of objects(SpendLimit)deprecated

The total amount of funds that can be spent using this card, in a given time interval. This field is deprecated - use "cardLevelSpendRules"."spendLimit" instead.

Response
{
  "allowedMerchantCategories": [
    "string"
  ],
  "blockedMerchantCategories": [
    "string"
  ],
  "allowedMerchantIds": [
    "string"
  ],
  "blockedMerchantIds": [
    "string"
  ],
  "allowedMerchantCountries": [
    "st"
  ],
  "blockedMerchantCountries": [
    "st"
  ],
  "allowContactless": true,
  "allowAtm": true,
  "allowECommerce": true,
  "allowCashback": true,
  "allowCreditAuthorisations": true,
  "minTransactionAmount": 0,
  "maxTransactionAmount": 0,
  "spendLimit": [
    { … }
  ],
  "cardLevelSpendRules": {
    "allowedMerchantCategories": [ … ],
    "blockedMerchantCategories": [ … ],
    "allowedMerchantIds": [ … ],
    "blockedMerchantIds": [ … ],
    "allowedMerchantCountries": [ … ],
    "blockedMerchantCountries": [ … ],
    "allowContactless": true,
    "allowAtm": true,
    "allowECommerce": true,
    "allowCashback": true,
    "allowCreditAuthorisations": true,
    "rolloverPolicy": { … },
    "spendLimit": [ … ],
    "minTransactionAmount": 0,
    "maxTransactionAmount": 0
  },
  "profileLevelSpendRules": {
    "allowedMerchantCategories": [ … ],
    "blockedMerchantCategories": [ … ],
    "allowedMerchantIds": [ … ],
    "blockedMerchantIds": [ … ],
    "allowedMerchantCountries": [ … ],
    "blockedMerchantCountries": [ … ],
    "allowContactless": true,
    "allowAtm": true,
    "allowECommerce": true,
    "allowCashback": true,
    "allowCreditAuthorisations": true,
    "rolloverPolicy": { … },
    "authForwardingEnabled": true
  },
  "identityLevelSpendRules": {
    "allowedMerchantCategories": [ … ],
    "blockedMerchantCategories": [ … ],
    "allowedMerchantIds": [ … ],
    "blockedMerchantIds": [ … ],
    "allowedMerchantCountries": [ … ],
    "blockedMerchantCountries": [ … ],
    "allowContactless": true,
    "allowAtm": true,
    "allowECommerce": true,
    "allowCashback": true,
    "allowCreditAuthorisations": true,
    "rolloverPolicy": { … },
    "minTransactionAmount": 0,
    "maxTransactionAmount": 0
  }
}