Developers
qashio.com

Create a card under a specific user

POST/public/v1/core/cards
Bearer token

Issue a new card for an existing user.

Creates a virtual or physical card under the user profile you name, optionally with an initial spend limit. The user profile must already exist: invite the user first with POST /public/v1/core/user_profiles/invite if they are not yet in Qashio.

The card currency defaults to the company's currency. Exactly which card product is issued depends on the card issuer configured for your company, so the returned card may carry issuer-specific attributes.

Request body

application/jsonrequired

FieldTypeDescription
user_profile_external_idstringThe user the card is issued to, e.g. UPxxxxxxxxxxxxxxxx. Required
card_typestringVIRTUAL or PHYSICAL. Required
nicknamestringCard name shown in Qashio
spend_limit_periodstringPeriod for the initial spend limit, e.g. MONTHLY
spend_limit_max_amountintegerMaximum spend within that period
JSON
{
  "user_profile_external_id": "UPxxxxxxxxxxxxxxxx",
  "card_type": "VIRTUAL",
  "nickname": "Marketing: Ads",
  "spend_limit_period": "MONTHLY",
  "spend_limit_max_amount": 250
}

Response

201 with message: "Resource created successfully." and data.card: the created card: { id, nickname, card_number, card_type, status, display_status, user_name, user_email, company_name, velocity_period, allow_atm, allow_replace_card, card_replaced, return_card }.

Response schema from the OpenAPI document
FieldTypeDescription
status_codeinteger
successboolean
messagestring
dataobject
cardobject
idinteger
user_namestring
company_namestring
user_emailstring
statusstring
display_statusstring
card_typestring
nicknamestring
card_numberstring
allow_replace_cardboolean
card_replacedboolean
velocity_periodstring
allow_atmboolean
return_cardstring
shipping_cardstring
terminated_atstring
spend_restriction_typestring
last_fourstring
limit_amount_notificationstring
card_balance_running_low_notificationboolean
allowed_countries_liststring
allowed_countries_list_activeboolean
foreign_entityboolean
atm_restricted_atstring
issuerstring
allowed_mccs_activestring
spend_limit_activeboolean
atm_limit_activeboolean
auto_top_up_amountstring
auto_load_on_transaction_approvalboolean
tokenization_statusstring
account_typestring
account_idinteger
currencystring
show_pool_balance_to_cardholderboolean
is_managerstring
is_account_managerboolean
is_dept_managerstring
can_edit_all_time_limitboolean
can_reset_limitboolean
reset_summarystring
issued_atstring
first_activated_atstring
external_idstring
replaced_by_card_external_idstring
replaced_by_card_idstring
card_usage_typestring
card_usage_type_amountstring
account_balancestring
shipment_trackingstring
atm_transactions_limit_activestring
transactions_limit_activeboolean
transactions_limitstring
atm_limitstring
departmentstring
locationstring
divisionstring
projectstring
card_productstring
shipping_addressstring
return_addressstring
card_templatestring
erp_bank_accountstring
step_up_auth_delegated_user_profilestring
created_atstring
shipping_detailsobject
wallets_statusobject
spend_limitobject
atm_transactions_limitobject
expense_categoriesobject[]
merchantsobject[]
user_profileobject
merchant_groupsobject[]
advanced_velocity_limitsobject[]
custom_segmentsobject[]
balance_controls_check_timestring
balance_controls_tierobject
balance_controlobject
metaobject
request_idstring
timestampstring
119 nested fields
data.card.card_product.idinteger
data.card.card_product.namestring
data.card.card_product.statusstring
data.card.card_product.descriptionstring
data.card.card_product.pan_format_tokenstring
data.card.card_product.track_format_tokenstring
data.card.card_product.proxy_format_tokenstring
data.card.card_product.remote_idstring
data.card.card_product.external_idstring
data.card.card_product.notification_template_remote_idstring
data.card.card_product.auth_settings_allowed_list_status_activeboolean
data.card.card_product.currency_settingsobject
data.card.card_product.currency_settings.supported_currencystring
data.card.card_product.currency_settings.settlement_currencystring
data.card.card_product.currency_settings.priorityinteger
data.card.card_product.currency_settings.statusstring
data.card.card_product.currency_settings.allow_loadsboolean
data.card.card_product.currency_settings.allow_unloadsboolean
data.card.card_product.currency_settings.allow_scheme_debit_txnboolean
data.card.card_product.currency_settings.allow_scheme_credit_txnboolean
data.card.card_product.currency_settings.allow_incoming_transferboolean
data.card.card_product.currency_settings.allow_outgoing_transferboolean
data.card.card_product.currency_settings.allow_incoming_sweepsboolean
data.card.card_product.currency_settings.allow_outgoing_sweepsboolean
data.card.card_product.currency_settings.allow_initial_loadboolean
data.card.card_product.pin_settingsobject
data.card.card_product.pin_settings.pin_typestring
data.card.card_product.pin_settings.pin_lengthinteger
data.card.card_product.pin_settings.pin_retriesinteger
data.card.shipping_details.methodstring
data.card.shipping_details.return_addressobject
data.card.shipping_details.shipping_addressobject
data.card.wallets_status.apple_payboolean
data.card.wallets_status.google_payboolean
data.card.wallets_status.samsung_payboolean
data.card.spend_limit.idinteger
data.card.spend_limit.namestring
data.card.spend_limit.activeboolean
data.card.spend_limit.descriptionstring
data.card.spend_limit.min_amountinteger
data.card.spend_limit.max_amountinteger
data.card.spend_limit.currencystring
data.card.spend_limit.periodstring
data.card.spend_limit.limit_typestring
data.card.spend_limit.frequencystring
data.card.spend_limit.num_of_daysstring
data.card.spend_limit.remote_idstring
data.card.spend_limit.transaction_scopestring
data.card.spend_limit.external_idstring
data.card.spend_limit.remaining_balancestring
data.card.spend_limit.remaining_frequencystring
data.card.spend_limit.remote_syncstring
data.card.spend_limit.consumed_limitinteger
data.card.spend_limit.consumed_frequencyinteger
data.card.spend_limit.remote_dataobject
data.card.atm_transactions_limit.max_amountstring
data.card.expense_categories[].idstring
data.card.expense_categories[].namestring
data.card.expense_categories[].labelstring
data.card.expense_categories[].codestring
data.card.expense_categories[].erp_internal_idstring
data.card.expense_categories[].erp_codestring
data.card.merchants[].idstring
data.card.merchants[].namestring
data.card.merchants[].labelstring
data.card.merchants[].codestring
data.card.merchants[].erp_internal_idstring
data.card.merchants[].erp_codestring
data.card.user_profile.department_namestring
data.card.user_profile.first_namestring
data.card.user_profile.last_namestring
data.card.user_profile.company_namestring
data.card.user_profile.user_namestring
data.card.user_profile.system_role_namestring
data.card.user_profile.emailstring
data.card.user_profile.user_emailstring
data.card.user_profile.external_idstring
data.card.user_profile.user_idinteger
data.card.user_profile.statusstring
data.card.user_profile.fullnamestring
data.card.user_profile.employee_idstring
data.card.user_profile.department_idinteger
data.card.user_profile.managing_departmentsobject[]
data.card.user_profile.managing_departments[].idinteger
data.card.user_profile.managing_departments[].namestring
data.card.merchant_groups[].idstring
data.card.merchant_groups[].namestring
data.card.merchant_groups[].labelstring
data.card.merchant_groups[].codestring
data.card.merchant_groups[].erp_internal_idstring
data.card.merchant_groups[].erp_codestring
data.card.advanced_velocity_limits[].idstring
data.card.advanced_velocity_limits[].namestring
data.card.advanced_velocity_limits[].labelstring
data.card.advanced_velocity_limits[].codestring
data.card.advanced_velocity_limits[].erp_internal_idstring
data.card.advanced_velocity_limits[].erp_codestring
data.card.custom_segments[].idstring
data.card.custom_segments[].namestring
data.card.custom_segments[].labelstring
data.card.custom_segments[].codestring
data.card.custom_segments[].erp_internal_idstring
data.card.custom_segments[].erp_codestring
data.card.balance_controls_tier.tierstring
data.card.balance_controls_tier.allows_one_timeboolean
data.card.balance_controls_tier.max_one_time_schedulesinteger
data.card.balance_controls_tier.max_one_time_per_dateinteger
data.card.balance_controls_tier.allows_multiple_daysboolean
data.card.balance_controls_tier.max_recurring_daysstring
data.card.balance_controls_tier.max_weekly_daysinteger
data.card.balance_controls_tier.max_monthly_daysinteger
data.card.balance_controls_tier.allows_per_day_amountsboolean
data.card.balance_control.smart_topup_enabledboolean
data.card.balance_control.max_balancestring
data.card.balance_control.effective_max_balancestring
data.card.balance_control.recurring_enabledboolean
data.card.balance_control.one_time_enabledboolean
data.card.balance_control.recurring_schedulesobject[]
data.card.balance_control.one_time_schedulesobject[]

Errors

400 (card could not be created; the reason is in errors[].message), 401, 404 (user profile not found).

  • 401Unauthorized - missing or invalid Bearer token
  • 404Not Found

Every error carries an errors[] array and a meta.request_id. See Errors for the full envelope.

This request takes no parameters.

Response

Send the request to see the response.

Esc

Start here

IntroductionIntegration walkthroughAuthenticationConventions

Popular endpoints

POSTExchange code for tokens/oauth2/tokenGETGet company summary/public/v1/erp/company/summaryGETList bank accounts/public/v1/erp/bank_accountsGETList cards/public/v1/erp/cardsGETList chart of accounts/public/v1/erp/chart_of_accounts