Update a system card

PATCH/managed_cards/system/{id}

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

Request

Available on

SandboxProduction

Path parameters

Header parameters

Request body

application/json

{}

objectobject · 5 fields

Request example

Path

/managed_cards/system/123456789

Headers

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

Body

{  "tag": "customer-123",  "nameOnCard": "string",  "billingAddress": {    "addressLine1": "1 High Street",    "addressLine2": "Flat 2",    "city": "London",    "postCode": "W1A 1AA",    "state": "Greater London",    "country": "GB"  },  "authForwardingDefaultTimeoutDecision": "APPROVE",  "externalData": [    {      "name": "Alex Smith",      "value": "INV-1042"    }  ]}

Responses

200OK

Success

Headers

Body

application/json

{}

SystemManagedCardSystemManagedCard · object · 25 fields

Accepted shapes

Selected by mode

Prepaid Mode System Managed CardPREPAID_MODEobject

balances: object

Debit Mode System Managed CardDEBIT_MODEobject

parentManagedAccountId: integer · int64
availableToSpend: array<AvailableToSpend · object>
userCurrency: enum

Response example

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