Cards - Qonto

List the organization’s cards, create new ones, and manage their lifecycle, limits, options, and restrictions.

Command	What it does	OAuth scope
`qonto cards appearances`	List card appearances	`card.read`
`qonto cards bulk-create`	Bulk create cards	`card.write`
`qonto cards create`	Create a card	`card.write`
`qonto cards data-view <id>`	Retrieve a card iframe url	`card.read`
`qonto cards discard <id>`	Discard a card	`card.write`
`qonto cards list`	List cards	`card.read`
`qonto cards lock <id>`	Lock a card	`card.write`
`qonto cards report-lost <id>`	Report a physical card as lost	`card.write`
`qonto cards report-stolen <id>`	Report a physical card as stolen	`card.write`
`qonto cards unlock <id>`	Unlock a card	`card.write`
`qonto cards update-limits <id>`	Update a card’s limits	`card.write`
`qonto cards update-nickname <id>`	Update a card’s nickname	`card.write`
`qonto cards update-options <id>`	Update a card’s options	`card.write`
`qonto cards update-restrictions <id>`	Update a card’s restrictions	`card.write`

cards create, cards bulk-create, cards update-limits, and cards update-restrictions take their request as a JSON document with --body, because its shape depends on the card level. The fields are described on each command’s API reference page.

Creating a physical card, and some changes to an existing card, require Strong Customer Authentication: the command waits until you approve in the Qonto app. Reporting a card as lost or stolen, and discarding it, cannot be undone.

Try it

# Active virtual cards
qonto cards list --card-levels virtual --statuses live --fields id,nickname,last_digits

# Lock a card, then unlock it
qonto cards lock <card-id>
qonto cards unlock <card-id>

# Online payments only
qonto cards update-options <card-id> --online-option \
  --atm-option=false --nfc-option=false --foreign-option=false

# Create a card from a JSON document
qonto cards create --body @card.json

qonto cards data-view returns a short-lived link that shows the card number, expiry date, and CVV. Treat it like a password.