Activate a physical card

POST/managed_cards/{id}/physical/activate

Use this when the cardholder has received their physical card and wants to start using it.

It activates the physical card identified by the id path parameter. A card that has been printed and delivered is inactive until this call succeeds. It can't be used in person or at an ATM, and its PIN can't be read.

Fields

activationCode is the code set when the card was upgraded to physical. If you supply it, it is checked against the code recorded at upgrade, and a mismatch fails with ACTIVATION_CODE_INVALID. If you leave it out, no check is carried out and the card is activated regardless.

Conflicts

Activation applies once, to a physical card that is still usable. Repeating it fails with INSTRUMENT_ALREADY_ACTIVATED, and a card that is blocked or destroyed fails with INSTRUMENT_BLOCKED or INSTRUMENT_DESTROYED. A virtual card that was never upgraded fails with INSTRUMENT_NOT_PHYSICAL.

Next steps

Once activated, the cardholder can retrieve their PIN with Get PIN for a physical card.

Request

Available on

SandboxProduction

Path parameters

Header parameters

Request body

application/json

{}

objectobject · 1 field

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  }}