Update account

Update account configuration such as state or spend limits. Can only be run on accounts that are part of the program managed by this API key.
Accounts that are in the PAUSED state will not be able to transact or create new cards.

Path Params
uuid
required

Globally unique identifier for account.

Body Params
integer
≥ 0

Amount (in cents) for the account's daily spend limit (e.g. 100000 would be a $1,000 limit). A spend limit of 0 means that no daily spend limit is enforced.
Clients onboarded on or after February 1, 2026 have no default account spend limits. For clients onboarded before that date that do not use Auth Stream Access, new accounts have a default daily spend limit of $1,250

integer
≥ 0
Defaults to 0

Amount (in cents) for the account's lifetime spend limit (e.g. 100000 would be a $1,000 limit). Once this limit is reached, no transactions will be accepted on any card created for this account until the limit is updated. A spend limit of 0 means that no lifetime spend limit is enforced

integer
≥ 0

Amount (in cents) for the account's monthly spend limit (e.g. 100000 would be a $1,000 limit). A spend limit of 0 means that no monthly spend limit is enforced.
Clients onboarded on or after February 1, 2026 have no default account spend limits. For clients onboarded before that date that do not use Auth Stream Access, new accounts have a default monthly spend limit of $5,000

string
enum

Account states.

Allowed:
string | null
enum

Account state substatus values:

  • FRAUD_IDENTIFIED - The account has been recognized as being created or used with stolen or fabricated identity information, encompassing both true identity theft and synthetic identities.
  • SUSPICIOUS_ACTIVITY - The account has exhibited suspicious behavior, such as unauthorized access or fraudulent transactions, necessitating further investigation.
  • RISK_VIOLATION - The account has been involved in deliberate misuse by the legitimate account holder. Examples include disputing valid transactions without cause, falsely claiming non-receipt of goods, or engaging in intentional bust-out schemes to exploit account services.
  • END_USER_REQUEST - The account holder has voluntarily requested the closure of the account for personal reasons. This encompasses situations such as bankruptcy, other financial considerations, or the account holder's death.
  • ISSUER_REQUEST - The issuer has initiated the closure of the account due to business strategy, risk management, inactivity, product changes, regulatory concerns, or violations of terms and conditions.
  • NOT_ACTIVE - The account has not had any transactions or payment activity within a specified period. This status applies to accounts that are paused or closed due to inactivity.
  • INTERNAL_REVIEW - The account is temporarily paused pending further internal review. In future implementations, this status may prevent clients from activating the account via APIs until the review is completed.
  • OTHER - The reason for the account's current status does not fall into any of the above categories. A comment should be provided to specify the particular reason.
string

Additional context or information related to the account.

verification_address
object
deprecated

Address used during Address Verification Service (AVS) checks during transactions if enabled via Auth Rules. This field is deprecated as AVS checks are no longer supported by Auth Rules. The field will be removed from the schema in a future release.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json