Activate a card
POST/v1/cards/:card_id/activate
Makes an inactive card spendable. It is a server-to-server call: there is
no hosted page and no URL to open, and the response is the card.
The same call activates a virtual card and a physical one. Call it when
you receive card.issued and you are ready for the card to be used.
- A
pendingcard is refused withcard_invalid_state. Wait forcard.issued; the card is never issued by calling this endpoint. - A card that is already
activeis refused withcard_already_activated. - The cardholder must still be verified. A cardholder who is no longer
approvedis refused withkyc_not_approved.
Activation takes effect at once. A card that fails to activate stays
inactive and can be activated again.
Requires the cards:write scope.
Request
Responses
- 200
- 403
- 404
- 422
The card, now active.
Credentials are valid but not permitted. Do not retry.
The resource does not exist, or belongs to another organization. The two are deliberately indistinguishable.
Well-formed but fails a business rule.