Update a Card

Update a card's status, nickname, contact info, transaction limits, or authorization controls. Only pass the fields you want to change.
Request Parameters
idstring
required
Unique card identifier. Max 64 characters.
statusstring
Target card status. Pass only to change the card state.

Valid Values:

FROZEN — Freeze the card for risk or security reasons.
CANCELLED — Cancel the card. This is terminal and cannot be undone.
ACTIVE — Unfreeze the card and resume transactions.
cardNickNamestring
Card nickname. Max 120 characters.
notestring
Free-text note. Max 512 characters.
purposestring
Card purpose description. Max 64 characters.
emailstring
Email associated with the card. Max 256 characters.
mobilePhonestring
Mobile phone associated with the card, including the international dialing code. Max 32 characters.
billingAddressAddress
Billing address. See Data Types.
transactionLimitsarray of TransactionLimits
Transaction limit configuration, aggregated by currency. Maximum 5 entries. Replaced as a whole — pass the complete configuration. On update, each limit only needs interval and rangeAmount.
Show child parametersShow child parameters
authorizationControlAuthorizationControl
Authorization control rules. Replaced as a whole — pass the complete configuration.
Show child parametersShow child parameters
metadataobject
Merchant-defined metadata. Up to 50 keys.
Response Parameters
resultResult
See Result.
idstring
Unique card identifier. Max 64 characters.
statusstring
Current card status after the update (PENDING, ACTIVE, FROZEN, FAILED, or CANCELLED).
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSSuccess.Update succeeded.
CARD_NOT_FOUNDFCard {id} not found.Verify the `id` is correct.
CARD_STATUS_INVALIDFCard status does not allow this update.The current card status does not permit the requested change.
PARAM_ILLEGALFIllegal parameters exist.Verify request fields against this reference.
USER_NO_PERMISSIONFUser does not have permission.Retry with a user that has permission for this card.
AUTHORIZATION_NOT_EXISTFThe authorization does not exist.Verify the `account-id` / `access-token` authorization.
PROCESS_FAILFA general business failure occurred. Do not retry.Do not retry. Contact WorldFirst support.
Definition
POST /api/open/v1/issuing/cards/update
Request
{
"id": "2026061819027200120851600100****",
"status": "FROZEN"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"id": "2026061819027200120851600100****",
"status": "FROZEN"
}