Cards
Create a new card
Note: this API is still in beta. Please get in touch with our team to know more: https://getqonto.atlassian.net/servicedesk/customer/portal/5
OAuth scope: card.write
This endpoint allows you to create a new card.
post/v2/cards
Headers
X-Qonto-Idempotency-Keystring required
This parameter is required. The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. The idempotency key must be a unique string. We recommend using a UUID.
X-Qonto-Staging-Tokenstring
Required only for Sandbox API requests; to get one, please submit the following form: https://getqonto.atlassian.net/servicedesk/customer/portal/5/group/47/create/143.
Request body
Example request
{
"card": {
"atm_option": true,
"nfc_option": true,
"foreign_option": true,
"online_option": true,
"atm_monthly_limit": 1000,
"atm_daily_limit_option": true,
"atm_daily_limit": 1000,
"payment_monthly_limit": 1000,
"payment_daily_limit_option": true,
"payment_daily_limit": 1000,
"payment_transaction_limit_option": true,
"payment_transaction_limit": 1000,
"active_days": [
1,
3,
5
],
"address": {
"contact_name": null,
"first_line": "751 Metz Falls",
"second_line": "835",
"third_line": "Apt. 734",
"zipcode": "13563-3709",
"city": "Reinholdchester",
"country": "KI"
},
"categories": [
"transport",
"restaurant_and_bar",
"food_and_grocery"
],
"card_design": "plus.black.2023",
"type_of_print": "embossed"
}
}Response
OK
Example response
{
"card": {
"nickname": "💳 for 🍗",
"embossed_name": "DOLORES KOULECHOV",
"status": "pending",
"pin_set": true,
"mask_pan": "511768******7662",
"exp_month": "3",
"exp_year": "2024",
"last_digits": "7662",
"atm_option": true,
"nfc_option": true,
"online_option": true,
"foreign_option": true,
"atm_monthly_limit": 1000,
"atm_monthly_spent": 1000,
"atm_daily_limit": 1000,
"atm_daily_limit_option": true,
"payment_monthly_limit": 1000,
"payment_monthly_spent": 1000,
"payment_daily_limit": 1000,
"payment_daily_spent": 1000,
"payment_daily_limit_option": true,
"payment_transaction_limit": 1000,
"payment_transaction_limit_option": true,
"active_days": [
1,
3,
5
],
"card_type": "debit",
"card_level": "standard",
"payment_lifespan_spent": 42,
"categories": [
"transport",
"restaurant_and_bar",
"food_and_grocery"
],
"parent_card_summary": {
"last_digits": "7662"
},
"card_design": "plus.black.2023",
"type_of_print": "embossed",
"discard_on": "2022-11-31"
}
}