Set Card Daily Spending Limit

Sets the daily spending limit for a card. amount is in the currency’s smallest unit — for USD that means cents, so to set a $10.00 limit send `1000`, and the maximum allowed value `1000000` corresponds to$10,000.00. Must be in (0, 1,000,000]. Only USD is currently accepted. The card must belong to the authenticated user. The response returns the new limit immediately with syncStatus: pending and transitions to synced once the change has been applied downstream.

PUT /cards/{cardId}/limit

Set Card Daily Spending Limit

JavaScript

const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({amount: 500000, currency: '<string>'})
};

fetch('https://gp-auth-module.prod.gnosispay.com/cards/{cardId}/limit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "amount": 123,
  "currency": "<string>",
  "decimals": 123,
  "updatedAt": "2023-11-07T05:31:56Z"
}

Path Parameters

cardId · string<uuid> · required

Body

application/json

amount · integer · required

Daily limit in the currency's smallest unit (e.g. cents for USD). For USD: send 1000 to set a $10.00 limit, send 1000000 to set the $10,000.00 cap. Must be in (0, 1,000,000].

Required range: 1 <= x <= 1000000

currency · string · required

ISO-4217 currency code. Only USD is currently accepted; other values return 400.

Response

200

application/json

Card limit updated successfully

amount · integer · required

Daily limit in the currency's smallest unit (e.g. cents for USD). Divide by 10^decimals to get the major-unit value. For USD (decimals=2): amount=1000 means $10.00, amount=1000000 means $10,000.00.

currency · string · required

ISO-4217 currency code, e.g. USD.

decimals · integer · required

Number of decimal places for this currency (e.g. 2 for USD).

syncStatus · enum<string> · required

Replication state of the limit. 'pending' immediately after an update, 'synced' once the change has been applied downstream, 'failed' if the change could not be applied after retries.

Available options: pending, synced, failed

updatedAt · string<date-time> · required

Last time this limit was modified.