Update Spend Control of a Card

Endpoint

PUT/api/v1/merchant/cards/{cardId}/spend-control/

Used for adjusting the spend control limits for a card.

Spend controls allow you to set how much users can spend within a given window of time.

📌 Note: Contact your account manager for more information on how to configure spend controls.

Path Parameters

Name	Type	Required	Description
cardId	string	✅	The unique identifier for the specific card on which you want to apply the spend limit.

Request Body

{
  "transactionLimit": 500.00,
  "dailyLimit": 5000.00,
  "weeklyLimit": 20000.00,
  "monthlyLimit": 80000.00,
  "yearlyLimit": 500000.00,
  "allTimeLimit": 1000000.00
}

Body Parameters

Name	Type	Required	Description
transactionLimit	float	✅	Maximum available transaction amount per transaction (≥ 0).
dailyLimit	float	✅	Maximum available transaction amount per day (≥ 0).
weeklyLimit	float	✅	Maximum available transaction amount per week (≥ 0).
monthlyLimit	float	✅	Maximum available transaction amount per month (≥ 0).
yearlyLimit	float	✅	Maximum available transaction amount per year (≥ 0).
allTimeLimit	float	✅	Maximum available transaction amount over the card’s lifetime (≥ 0).

Example Request

PUT /api/v1/merchant/cards/{cardId}/spend-control/
Content-Type: application/json

{
  "transactionLimit": 500.00,
  "dailyLimit": 5000.00,
  "weeklyLimit": 20000.00,
  "monthlyLimit": 80000.00,
  "yearlyLimit": 500000.00,
  "allTimeLimit": 1000000.00
}

Response

{
  "transactionLimit": "500.00",
  "dailyLimit": "5000.00",
  "weeklyLimit": "20000.00",
  "monthlyLimit": "80000.00",
  "yearlyLimit": "500000.00",
  "allTimeLimit": "1000000.00"
}

Response Codes

Status Code	Description
200 OK	Spend control limits updated successfully.
400 Bad Request	Invalid request parameters.
401 Unauthorized	Authentication failed.
404 Not Found	Card not found.
500 Internal Server Error	Server error.