Update a card

PATCH/managed_cards/{id}

Update the details of the managed card identified by the id path parameter.

Request

Available on

SandboxProduction

Path parameters

Header parameters

Request body

application/json

{}

objectobject · 16 fields

Request example

Path

/managed_cards/123456789

Headers

{  "idempotency-ref": "transfer-2026-08-07-001"}

Body

{  "tag": "customer-123",  "friendlyName": "string",  "nameOnCard": "string",  "nameOnCardLine2": "string",  "billingAddress": {    "addressLine1": "1 High Street",    "addressLine2": "Flat 2",    "city": "London",    "postCode": "W1A 1AA",    "state": "Greater London",    "country": "GB"  },  "deliveryAddress": {    "name": "Alex",    "surname": "Smith",    "addressLine1": "1 High Street",    "addressLine2": "Flat 2",    "city": "London",    "postCode": "W1A 1AA",    "state": "Greater London",    "country": "GB",    "contactNumber": {}  },  "deliveryMethod": "STANDARD_DELIVERY",  "digitalWallets": {    "pushProvisioningEnabled": true,    "walletsEnabled": true,    "artworkReference": "ART_001"  },  "authForwardingDefaultTimeoutDecision": "APPROVE",  "externalData": [    {      "name": "Alex Smith",      "value": "INV-1042"    }  ],  "bulkDelivery": true,  "activationCode": {},  "productReference": "string",  "carrierType": "string",  "renewalType": "RENEW",  "userId": {}}

Responses

200OK

Success

Headers

Body

application/json

{}

ManagedCardManagedCard · object · 33 fields

Accepted shapes

Selected by mode

Prepaid Mode CardPREPAID_MODEobject

mode: enum
balances: object

Debit Mode CardDEBIT_MODEobject

mode: enum
currency: string
parentManagedAccountId*: string
userCurrency: enum
availableToSpend: array<AvailableToSpend · object>

Response example

{  "mode": "PREPAID_MODE",  "balances": {    "availableBalance": 120000,    "actualBalance": 125000  }}