Spend controls

Update spend rules for a card

Updates the card-level spend rules of the managed card identified by the id path parameter. Use this once the card has rules; to set them for the first time, use Create spend rules.

The same fields are accepted as on create: merchant, MCC, and country allow and block lists, the allow* transaction-type switches, transaction size bounds, and spendLimit.

Updating spend limits

updateSpendLimitMethod controls how the spendLimit you send is applied:

MethodEffect
OVERWRITEReplaces the existing limits with the ones supplied. This is the default.
INCREMENTAdds the supplied value to the existing limit for that interval.

INCREMENT combined with an ALWAYS interval is how you top a card up on your own schedule. Incrementing a lifetime limit monthly, for instance, leaves any unused allowance from earlier periods available to spend, which a fixed MONTHLY limit would not.

Rollover

Set rolloverPolicy.rolloverNegative to true on a spend limit to carry overspend into subsequent intervals. This applies per card; to change it across many cards at once, use Update spend rules in bulk.

patch/managed_cards/{id}/spend_rules

Request

  • Base URL: https://sandbox.weavr.io/multi
  • URL: https://sandbox.weavr.io/multi/managed_cards/{id}/spend_rules
  • Auth: HTTP bearer and API key in header api-key

Path parameters

idstring required
Example:123456789

The unique identifier of the managed card.

Headers

idempotency-refstring
Example:transfer-2026-08-07-001

A unique call reference generated by the caller that, taking into consideration the payload as well as the operation itself, helps avoid duplicate operations. Idempotency reference uniqueness is maintained for at least 24 hours.

Request body

allowedMerchantCategoriesstring[]

Allowlist 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.

blockedMerchantCategoriesstring[]

Blocklist 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.

allowedMerchantIdsstring[]

Allowlist 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.

blockedMerchantIdsstring[]

Blocklist 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.

allowedMerchantCountriesstring[]

Allowlist 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.

blockedMerchantCountriesstring[]

Blocklist 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.

allowContactlessboolean

Indicates if a contactless transaction is allowed on the card.

allowAtmboolean

Indicates if an ATM Withdrawal transaction is allowed on the card.

allowECommerceboolean

Indicates if an online transaction is allowed on the card.

allowCashbackboolean

Indicates if a cashback transaction at a physical terminal is allowed on the card.

allowCreditAuthorisationsboolean

Indicates if a the card can receive a credit transaction.

minTransactionAmountinteger

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.

maxTransactionAmountinteger

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.

updateSpendLimitMethod'OVERWRITE' | 'INCREMENT'

The spend limit update method to apply. Currently supported:

  • OVERWRITE: (default option if nothing selected). Overwrites the previous values for the spendLimit object i.e. sets new limits
  • INCREMENT : This will increase the existing value of the spend limit by the amount input the value field. If used in conjunction with an ALWAYS interval, this can be used to increment a spend limit on a periodic basis (controlled by you, e.g. monthly), and means that any 'unused' balance from the previous period will still available to spend. See examples in our documentation

Example request

{
  "allowContactless": true,
  "allowAtm": true,
  "allowECommerce": true,
  "allowCashback": true,
  "allowCreditAuthorisations": true,
  "spendLimit": [
    {
      "startTimestamp": 1767225600000,
      "value": {
        "currency": "GBP",
        "amount": 1250
      }
    }
  ],
  "minTransactionAmount": 100,
  "maxTransactionAmount": 50000
}

Response

Success - No Content.

Changes

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