The Card object
Attributes
id(string) Unique identifier for the object.object(string) String representing the object’s type. Objects of the same type share the same value.brand(string) The brand of the card.cancellation_reason(enum, nullable) The reason why the card was canceled. Possible enum values:design_rejectedThe design of this card was rejected by Stripe for violating our partner guidelines.fulfillment_errorThere was an error in fulfilling the card. This reason is only valid for cards of typephysical.lostThe card was lost.stolenThe card was stolen.
cardholder(object) The Cardholder object to which the card belongs.cardholder.id(string) Unique identifier for the object.cardholder.object(string) String representing the object’s type. Objects of the same type share the same value.cardholder.billing(object) The cardholder’s billing information.cardholder.billing.address(object) The cardholder’s billing address.cardholder.billing.address.city(string, nullable) City, district, suburb, town, or village.cardholder.billing.address.country(string, nullable) Two-letter country code (ISO 3166-1 alpha-2).cardholder.billing.address.line1(string, nullable) Address line 1, such as the street, PO Box, or company name.cardholder.billing.address.line2(string, nullable) Address line 2, such as the apartment, suite, unit, or building.cardholder.billing.address.postal_code(string, nullable) ZIP or postal code.cardholder.billing.address.state(string, nullable) State, county, province, or region (ISO 3166-2).
cardholder.company(object, nullable) Additional information about acompanycardholder.cardholder.company.tax_id_provided(boolean) Whether the company’s business ID number was provided.
cardholder.created(timestamp) Time at which the object was created. Measured in seconds since the Unix epoch.cardholder.email(string, nullable) The cardholder’s email address.cardholder.individual(object, nullable) Additional information about anindividualcardholder.cardholder.individual.card_issuing(object, nullable) Information related to the card_issuing program for this cardholder.cardholder.individual.card_issuing.user_terms_acceptance(object, nullable) Information about cardholder acceptance of Celtic Authorized User Terms. Required for cards backed by a Celtic program.cardholder.individual.card_issuing.user_terms_acceptance.date(timestamp, nullable) The Unix timestamp marking when the cardholder accepted the Authorized User Terms.cardholder.individual.card_issuing.user_terms_acceptance.ip(string, nullable) The IP address from which the cardholder accepted the Authorized User Terms.cardholder.individual.card_issuing.user_terms_acceptance.user_agent(string, nullable) The user agent of the browser from which the cardholder accepted the Authorized User Terms.
cardholder.individual.dob(object, nullable) The date of birth of this cardholder.cardholder.individual.dob.day(integer, nullable) The day of birth, between 1 and 31.cardholder.individual.dob.month(integer, nullable) The month of birth, between 1 and 12.cardholder.individual.dob.year(integer, nullable) The four-digit year of birth.
cardholder.individual.first_name(string, nullable) The first name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters.cardholder.individual.last_name(string, nullable) The last name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters.cardholder.individual.verification(object, nullable) Government-issued ID document for this cardholder.cardholder.individual.verification.document(object, nullable) An identifying document, either a passport or local ID card.cardholder.individual.verification.document.back(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) The back of a document returned by a file upload with apurposevalue ofidentity_document.cardholder.individual.verification.document.front(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) The front of a document returned by a file upload with apurposevalue ofidentity_document.
cardholder.livemode(boolean) If the object exists in live mode, the value istrue. If the object exists in test mode, the value isfalse.cardholder.metadata(object) Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.cardholder.name(string) The cardholder’s name. This will be printed on cards issued to them.cardholder.phone_number(string, nullable) The cardholder’s phone number. This is required for all cardholders who will be creating EU cards. See the 3D Secure documentation for more details.cardholder.preferred_locales(array of enums, nullable) The cardholder’s preferred locales (languages), ordered by preference. Locales can beda,de,en,es,fr,it,pl, orsv. This changes the language of the 3D Secure flow and one-time password messages sent to the cardholder.cardholder.requirements(object) Information about verification requirements for the cardholder.cardholder.requirements.disabled_reason(enum, nullable) Ifdisabled_reasonis present, all cards will decline authorizations withcardholder_verification_requiredreason. Possible enum values:listedAccount might be on a prohibited persons or companies list. Thepast_duefield contains information that you need to provide before the cardholder can approve authorizations.rejected.listedCardholder is rejected because they are on a third-party prohibited persons or companies list (such as financial services provider or government). Their status will beblocked.requirements.past_dueCardholder has outstanding requirements. Thepast_duefield contains information that you need to provide before the cardholder can activate cards.under_reviewThis cardholder has raised additional review. Stripe will make a decision and update thedisabled_reasonfield.
cardholder.requirements.past_due(array of enums, nullable) Array of fields that need to be collected in order to verify and re-enable the cardholder. Possible enum values:company.tax_idThe cardholder’s business number (Tax ID).individual.card_issuing.user_terms_acceptance.dateThe Unix timestamp marking when the Cardholder accepted their Authorized User Terms. Required for Celtic Spend Card users.individual.card_issuing.user_terms_acceptance.ipThe IP address from which the Cardholder accepted their Authorized User Terms. Required for Celtic Spend Card users.individual.dob.dayThe cardholder’s date of birth’s day.individual.dob.monthThe cardholder’s date of birth’s month.individual.dob.yearThe cardholder’s date of birth’s year.individual.first_nameThe cardholder’s legal first name.individual.last_nameThe cardholder’s legal last name.individual.verification.documentThe front and back of a government-issued form of identification.
cardholder.spending_controls(object, nullable) Rules that control spending across this cardholder’s cards. Refer to our documentation for more details.cardholder.spending_controls.allowed_card_presences(array of enums, nullable) Array of card presence statuses from which authorizations will be allowed. Possible options arepresent,not_present. All other statuses will be blocked. Cannot be set withblocked_card_presences. Provide an empty value to unset this control. Possible enum values:not_presentpresent
cardholder.spending_controls.allowed_categories(array of enums, nullable) Array of strings containing categories of authorizations to allow. All other categories will be blocked. Cannot be set withblocked_categories. Possible enum values:ac_refrigeration_repairaccounting_bookkeeping_servicesadvertising_servicesagricultural_cooperativeairlines_air_carriersairports_flying_fieldsambulance_servicesamusement_parks_carnivalsantique_reproductionsantique_shopsaquariumsarchitectural_surveying_servicesart_dealers_and_galleriesartists_supply_and_craft_shopsauto_and_home_supply_storesauto_body_repair_shopsauto_paint_shopsauto_service_shopsautomated_cash_disburseautomated_fuel_dispensersautomobile_associationsautomotive_parts_and_accessories_storesautomotive_tire_storesbail_and_bond_paymentsbakeriesbands_orchestrasbarber_and_beauty_shopsbetting_casino_gamblingbicycle_shopsbilliard_pool_establishmentsboat_dealersboat_rentals_and_leasesbook_storesbooks_periodicals_and_newspapersbowling_alleysbus_linesbusiness_secretarial_schoolsbuying_shopping_servicescable_satellite_and_other_pay_television_and_radiocamera_and_photographic_supply_storescandy_nut_and_confectionery_storescar_and_truck_dealers_new_usedcar_and_truck_dealers_used_onlycar_rental_agenciescar_washescarpentry_servicescarpet_upholstery_cleaningcatererscharitable_and_social_service_organizations_fundraisingchemicals_and_allied_productschild_care_serviceschildrens_and_infants_wear_storeschiropodists_podiatristschiropractorscigar_stores_and_standscivic_social_fraternal_associationscleaning_and_maintenanceclothing_rentalcolleges_universitiescommercial_equipmentcommercial_footwearcommercial_photography_art_and_graphicscommuter_transport_and_ferriescomputer_network_servicescomputer_programmingcomputer_repaircomputer_software_storescomputers_peripherals_and_softwareconcrete_work_servicesconstruction_materialsconsulting_public_relationscorrespondence_schoolscosmetic_storescounseling_servicescountry_clubscourier_servicescourt_costscredit_reporting_agenciescruise_linesdairy_products_storesdance_hall_studios_schoolsdating_escort_servicesdentists_orthodontistsdepartment_storesdetective_agenciesdigital_goods_applicationsdigital_goods_gamesdigital_goods_large_volumedigital_goods_mediadirect_marketing_catalog_merchantdirect_marketing_combination_catalog_and_retail_merchantdirect_marketing_inbound_telemarketingdirect_marketing_insurance_servicesdirect_marketing_otherdirect_marketing_outbound_telemarketingdirect_marketing_subscriptiondirect_marketing_traveldiscount_storesdoctorsdoor_to_door_salesdrapery_window_covering_and_upholstery_storesdrinking_placesdrug_stores_and_pharmaciesdrugs_drug_proprietaries_and_druggist_sundriesdry_cleanersdurable_goodsduty_free_storeseating_places_restaurantseducational_serviceselectric_razor_storeselectric_vehicle_chargingelectrical_parts_and_equipmentelectrical_serviceselectronics_repair_shopselectronics_storeselementary_secondary_schoolsemergency_services_gcas_visa_use_onlyemployment_temp_agenciesequipment_rentalexterminating_servicesfamily_clothing_storesfast_food_restaurantsfinancial_institutionsfines_government_administrative_entitiesfireplace_fireplace_screens_and_accessories_storesfloor_covering_storesfloristsflorists_supplies_nursery_stock_and_flowersfreezer_and_locker_meat_provisionersfuel_dealers_non_automotivefuneral_services_crematoriesfurniture_home_furnishings_and_equipment_stores_except_appliancesfurniture_repair_refinishingfurriers_and_fur_shopsgeneral_servicesgift_card_novelty_and_souvenir_shopsglass_paint_and_wallpaper_storesglassware_crystal_storesgolf_courses_publicgovernment_licensed_horse_dog_racing_us_region_onlygovernment_licensed_online_casions_online_gambling_us_region_onlygovernment_owned_lotteries_non_us_regiongovernment_owned_lotteries_us_region_onlygovernment_servicesgrocery_stores_supermarketshardware_equipment_and_supplieshardware_storeshealth_and_beauty_spashearing_aids_sales_and_suppliesheating_plumbing_a_chobby_toy_and_game_shopshome_supply_warehouse_storeshospitalshotels_motels_and_resortshousehold_appliance_storesindustrial_suppliesinformation_retrieval_servicesinsurance_defaultinsurance_underwriting_premiumsintra_company_purchasesjewelry_stores_watches_clocks_and_silverware_storeslandscaping_serviceslaundrieslaundry_cleaning_serviceslegal_services_attorneysluggage_and_leather_goods_storeslumber_building_materials_storesmanual_cash_disbursemarinas_service_and_suppliesmarketplacesmasonry_stonework_and_plastermassage_parlorsmedical_and_dental_labsmedical_dental_ophthalmic_and_hospital_equipment_and_suppliesmedical_servicesmembership_organizationsmens_and_boys_clothing_and_accessories_storesmens_womens_clothing_storesmetal_service_centersmiscellaneousmiscellaneous_apparel_and_accessory_shopsmiscellaneous_auto_dealersmiscellaneous_business_servicesmiscellaneous_food_storesmiscellaneous_general_merchandisemiscellaneous_general_servicesmiscellaneous_home_furnishing_specialty_storesmiscellaneous_publishing_and_printingmiscellaneous_recreation_servicesmiscellaneous_repair_shopsmiscellaneous_specialty_retailmobile_home_dealersmotion_picture_theatersmotor_freight_carriers_and_truckingmotor_homes_dealersmotor_vehicle_supplies_and_new_partsmotorcycle_shops_and_dealersmotorcycle_shops_dealersmusic_stores_musical_instruments_pianos_and_sheet_musicnews_dealers_and_newsstandsnon_fi_money_ordersnon_fi_stored_value_card_purchase_loadnondurable_goodsnurseries_lawn_and_garden_supply_storesnursing_personal_careoffice_and_commercial_furnitureopticians_eyeglassesoptometrists_ophthalmologistorthopedic_goods_prosthetic_devicesosteopathspackage_stores_beer_wine_and_liquorpaints_varnishes_and_suppliesparking_lots_garagespassenger_railwayspawn_shopspet_shops_pet_food_and_suppliespetroleum_and_petroleum_productsphoto_developingphotographic_photocopy_microfilm_equipment_and_suppliesphotographic_studiospicture_video_productionpiece_goods_notions_and_other_dry_goodsplumbing_heating_equipment_and_suppliespolitical_organizationspostal_services_government_onlyprecious_stones_and_metals_watches_and_jewelryprofessional_servicespublic_warehousing_and_storagequick_copy_repro_and_blueprintrailroadsreal_estate_agents_and_managers_rentalsrecord_storesrecreational_vehicle_rentalsreligious_goods_storesreligious_organizationsroofing_siding_sheet_metalsecretarial_support_servicessecurity_brokers_dealersservice_stationssewing_needlework_fabric_and_piece_goods_storesshoe_repair_hat_cleaningshoe_storessmall_appliance_repairsnowmobile_dealersspecial_trade_servicesspecialty_cleaningsporting_goods_storessporting_recreation_campssports_and_riding_apparel_storessports_clubs_fieldsstamp_and_coin_storesstationary_office_supplies_printing_and_writing_paperstationery_stores_office_and_school_supply_storesswimming_pools_salest_ui_travel_germanytailors_alterationstax_payments_government_agenciestax_preparation_servicestaxicabs_limousinestelecommunication_equipment_and_telephone_salestelecommunication_servicestelegraph_servicestent_and_awning_shopstesting_laboratoriestheatrical_ticket_agenciestimesharestire_retreading_and_repairtolls_bridge_feestourist_attractions_and_exhibitstowing_servicestrailer_parks_campgroundstransportation_servicestravel_agencies_tour_operatorstruck_stop_iterationtruck_utility_trailer_rentalstypesetting_plate_making_and_related_servicestypewriter_storesu_s_federal_government_agencies_or_departmentsuniforms_commercial_clothingused_merchandise_and_secondhand_storesutilitiesvariety_storesveterinary_servicesvideo_amusement_game_suppliesvideo_game_arcadesvideo_tape_rental_storesvocational_trade_schoolswatch_jewelry_repairwelding_repairwholesale_clubswig_and_toupee_storeswires_money_orderswomens_accessory_and_specialty_shopswomens_ready_to_wear_storeswrecking_and_salvage_yards
cardholder.spending_controls.allowed_merchant_countries(array of strings, nullable) Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g.US). Cannot be set withblocked_merchant_countries. Provide an empty value to unset this control.cardholder.spending_controls.blocked_card_presences(array of enums, nullable) Array of card presence statuses from which authorizations will be declined. Possible options arepresent,not_present. Cannot be set withallowed_card_presences. Provide an empty value to unset this control. Possible enum values:not_presentpresent
cardholder.spending_controls.blocked_categories(array of enums, nullable) Array of strings containing categories of authorizations to decline. All other categories will be allowed. Cannot be set withallowed_categories. Possible enum values:ac_refrigeration_repairaccounting_bookkeeping_servicesadvertising_servicesagricultural_cooperativeairlines_air_carriersairports_flying_fieldsambulance_servicesamusement_parks_carnivalsantique_reproductionsantique_shopsaquariumsarchitectural_surveying_servicesart_dealers_and_galleriesartists_supply_and_craft_shopsauto_and_home_supply_storesauto_body_repair_shopsauto_paint_shopsauto_service_shopsautomated_cash_disburseautomated_fuel_dispensersautomobile_associationsautomotive_parts_and_accessories_storesautomotive_tire_storesbail_and_bond_paymentsbakeriesbands_orchestrasbarber_and_beauty_shopsbetting_casino_gamblingbicycle_shopsbilliard_pool_establishmentsboat_dealersboat_rentals_and_leasesbook_storesbooks_periodicals_and_newspapersbowling_alleysbus_linesbusiness_secretarial_schoolsbuying_shopping_servicescable_satellite_and_other_pay_television_and_radiocamera_and_photographic_supply_storescandy_nut_and_confectionery_storescar_and_truck_dealers_new_usedcar_and_truck_dealers_used_onlycar_rental_agenciescar_washescarpentry_servicescarpet_upholstery_cleaningcatererscharitable_and_social_service_organizations_fundraisingchemicals_and_allied_productschild_care_serviceschildrens_and_infants_wear_storeschiropodists_podiatristschiropractorscigar_stores_and_standscivic_social_fraternal_associationscleaning_and_maintenanceclothing_rentalcolleges_universitiescommercial_equipmentcommercial_footwearcommercial_photography_art_and_graphicscommuter_transport_and_ferriescomputer_network_servicescomputer_programmingcomputer_repaircomputer_software_storescomputers_peripherals_and_softwareconcrete_work_servicesconstruction_materialsconsulting_public_relationscorrespondence_schoolscosmetic_storescounseling_servicescountry_clubscourier_servicescourt_costscredit_reporting_agenciescruise_linesdairy_products_storesdance_hall_studios_schoolsdating_escort_servicesdentists_orthodontistsdepartment_storesdetective_agenciesdigital_goods_applicationsdigital_goods_gamesdigital_goods_large_volumedigital_goods_mediadirect_marketing_catalog_merchantdirect_marketing_combination_catalog_and_retail_merchantdirect_marketing_inbound_telemarketingdirect_marketing_insurance_servicesdirect_marketing_otherdirect_marketing_outbound_telemarketingdirect_marketing_subscriptiondirect_marketing_traveldiscount_storesdoctorsdoor_to_door_salesdrapery_window_covering_and_upholstery_storesdrinking_placesdrug_stores_and_pharmaciesdrugs_drug_proprietaries_and_druggist_sundriesdry_cleanersdurable_goodsduty_free_storeseating_places_restaurantseducational_serviceselectric_razor_storeselectric_vehicle_chargingelectrical_parts_and_equipmentelectrical_serviceselectronics_repair_shopselectronics_storeselementary_secondary_schoolsemergency_services_gcas_visa_use_onlyemployment_temp_agenciesequipment_rentalexterminating_servicesfamily_clothing_storesfast_food_restaurantsfinancial_institutionsfines_government_administrative_entitiesfireplace_fireplace_screens_and_accessories_storesfloor_covering_storesfloristsflorists_supplies_nursery_stock_and_flowersfreezer_and_locker_meat_provisionersfuel_dealers_non_automotivefuneral_services_crematoriesfurniture_home_furnishings_and_equipment_stores_except_appliancesfurniture_repair_refinishingfurriers_and_fur_shopsgeneral_servicesgift_card_novelty_and_souvenir_shopsglass_paint_and_wallpaper_storesglassware_crystal_storesgolf_courses_publicgovernment_licensed_horse_dog_racing_us_region_onlygovernment_licensed_online_casions_online_gambling_us_region_onlygovernment_owned_lotteries_non_us_regiongovernment_owned_lotteries_us_region_onlygovernment_servicesgrocery_stores_supermarketshardware_equipment_and_supplieshardware_storeshealth_and_beauty_spashearing_aids_sales_and_suppliesheating_plumbing_a_chobby_toy_and_game_shopshome_supply_warehouse_storeshospitalshotels_motels_and_resortshousehold_appliance_storesindustrial_suppliesinformation_retrieval_servicesinsurance_defaultinsurance_underwriting_premiumsintra_company_purchasesjewelry_stores_watches_clocks_and_silverware_storeslandscaping_serviceslaundrieslaundry_cleaning_serviceslegal_services_attorneysluggage_and_leather_goods_storeslumber_building_materials_storesmanual_cash_disbursemarinas_service_and_suppliesmarketplacesmasonry_stonework_and_plastermassage_parlorsmedical_and_dental_labsmedical_dental_ophthalmic_and_hospital_equipment_and_suppliesmedical_servicesmembership_organizationsmens_and_boys_clothing_and_accessories_storesmens_womens_clothing_storesmetal_service_centersmiscellaneousmiscellaneous_apparel_and_accessory_shopsmiscellaneous_auto_dealersmiscellaneous_business_servicesmiscellaneous_food_storesmiscellaneous_general_merchandisemiscellaneous_general_servicesmiscellaneous_home_furnishing_specialty_storesmiscellaneous_publishing_and_printingmiscellaneous_recreation_servicesmiscellaneous_repair_shopsmiscellaneous_specialty_retailmobile_home_dealersmotion_picture_theatersmotor_freight_carriers_and_truckingmotor_homes_dealersmotor_vehicle_supplies_and_new_partsmotorcycle_shops_and_dealersmotorcycle_shops_dealersmusic_stores_musical_instruments_pianos_and_sheet_musicnews_dealers_and_newsstandsnon_fi_money_ordersnon_fi_stored_value_card_purchase_loadnondurable_goodsnurseries_lawn_and_garden_supply_storesnursing_personal_careoffice_and_commercial_furnitureopticians_eyeglassesoptometrists_ophthalmologistorthopedic_goods_prosthetic_devicesosteopathspackage_stores_beer_wine_and_liquorpaints_varnishes_and_suppliesparking_lots_garagespassenger_railwayspawn_shopspet_shops_pet_food_and_suppliespetroleum_and_petroleum_productsphoto_developingphotographic_photocopy_microfilm_equipment_and_suppliesphotographic_studiospicture_video_productionpiece_goods_notions_and_other_dry_goodsplumbing_heating_equipment_and_suppliespolitical_organizationspostal_services_government_onlyprecious_stones_and_metals_watches_and_jewelryprofessional_servicespublic_warehousing_and_storagequick_copy_repro_and_blueprintrailroadsreal_estate_agents_and_managers_rentalsrecord_storesrecreational_vehicle_rentalsreligious_goods_storesreligious_organizationsroofing_siding_sheet_metalsecretarial_support_servicessecurity_brokers_dealersservice_stationssewing_needlework_fabric_and_piece_goods_storesshoe_repair_hat_cleaningshoe_storessmall_appliance_repairsnowmobile_dealersspecial_trade_servicesspecialty_cleaningsporting_goods_storessporting_recreation_campssports_and_riding_apparel_storessports_clubs_fieldsstamp_and_coin_storesstationary_office_supplies_printing_and_writing_paperstationery_stores_office_and_school_supply_storesswimming_pools_salest_ui_travel_germanytailors_alterationstax_payments_government_agenciestax_preparation_servicestaxicabs_limousinestelecommunication_equipment_and_telephone_salestelecommunication_servicestelegraph_servicestent_and_awning_shopstesting_laboratoriestheatrical_ticket_agenciestimesharestire_retreading_and_repairtolls_bridge_feestourist_attractions_and_exhibitstowing_servicestrailer_parks_campgroundstransportation_servicestravel_agencies_tour_operatorstruck_stop_iterationtruck_utility_trailer_rentalstypesetting_plate_making_and_related_servicestypewriter_storesu_s_federal_government_agencies_or_departmentsuniforms_commercial_clothingused_merchandise_and_secondhand_storesutilitiesvariety_storesveterinary_servicesvideo_amusement_game_suppliesvideo_game_arcadesvideo_tape_rental_storesvocational_trade_schoolswatch_jewelry_repairwelding_repairwholesale_clubswig_and_toupee_storeswires_money_orderswomens_accessory_and_specialty_shopswomens_ready_to_wear_storeswrecking_and_salvage_yards
cardholder.spending_controls.blocked_merchant_countries(array of strings, nullable) Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g.US). Cannot be set withallowed_merchant_countries. Provide an empty value to unset this control.cardholder.spending_controls.spending_limits(array of objects, nullable) Limit spending with amount-based rules that apply across this cardholder’s cards.cardholder.spending_controls.spending_limits.amount(integer) Maximum amount allowed to spend per interval. This amount is in the card’s currency and in the smallest currency unit.cardholder.spending_controls.spending_limits.categories(array of enums, nullable) Array of strings containing categories this limit applies to. Omitting this field will apply the limit to all categories. Possible enum values:ac_refrigeration_repairaccounting_bookkeeping_servicesadvertising_servicesagricultural_cooperativeairlines_air_carriersairports_flying_fieldsambulance_servicesamusement_parks_carnivalsantique_reproductionsantique_shopsaquariumsarchitectural_surveying_servicesart_dealers_and_galleriesartists_supply_and_craft_shopsauto_and_home_supply_storesauto_body_repair_shopsauto_paint_shopsauto_service_shopsautomated_cash_disburseautomated_fuel_dispensersautomobile_associationsautomotive_parts_and_accessories_storesautomotive_tire_storesbail_and_bond_paymentsbakeriesbands_orchestrasbarber_and_beauty_shopsbetting_casino_gamblingbicycle_shopsbilliard_pool_establishmentsboat_dealersboat_rentals_and_leasesbook_storesbooks_periodicals_and_newspapersbowling_alleysbus_linesbusiness_secretarial_schoolsbuying_shopping_servicescable_satellite_and_other_pay_television_and_radiocamera_and_photographic_supply_storescandy_nut_and_confectionery_storescar_and_truck_dealers_new_usedcar_and_truck_dealers_used_onlycar_rental_agenciescar_washescarpentry_servicescarpet_upholstery_cleaningcatererscharitable_and_social_service_organizations_fundraisingchemicals_and_allied_productschild_care_serviceschildrens_and_infants_wear_storeschiropodists_podiatristschiropractorscigar_stores_and_standscivic_social_fraternal_associationscleaning_and_maintenanceclothing_rentalcolleges_universitiescommercial_equipmentcommercial_footwearcommercial_photography_art_and_graphicscommuter_transport_and_ferriescomputer_network_servicescomputer_programmingcomputer_repaircomputer_software_storescomputers_peripherals_and_softwareconcrete_work_servicesconstruction_materialsconsulting_public_relationscorrespondence_schoolscosmetic_storescounseling_servicescountry_clubscourier_servicescourt_costscredit_reporting_agenciescruise_linesdairy_products_storesdance_hall_studios_schoolsdating_escort_servicesdentists_orthodontistsdepartment_storesdetective_agenciesdigital_goods_applicationsdigital_goods_gamesdigital_goods_large_volumedigital_goods_mediadirect_marketing_catalog_merchantdirect_marketing_combination_catalog_and_retail_merchantdirect_marketing_inbound_telemarketingdirect_marketing_insurance_servicesdirect_marketing_otherdirect_marketing_outbound_telemarketingdirect_marketing_subscriptiondirect_marketing_traveldiscount_storesdoctorsdoor_to_door_salesdrapery_window_covering_and_upholstery_storesdrinking_placesdrug_stores_and_pharmaciesdrugs_drug_proprietaries_and_druggist_sundriesdry_cleanersdurable_goodsduty_free_storeseating_places_restaurantseducational_serviceselectric_razor_storeselectric_vehicle_chargingelectrical_parts_and_equipmentelectrical_serviceselectronics_repair_shopselectronics_storeselementary_secondary_schoolsemergency_services_gcas_visa_use_onlyemployment_temp_agenciesequipment_rentalexterminating_servicesfamily_clothing_storesfast_food_restaurantsfinancial_institutionsfines_government_administrative_entitiesfireplace_fireplace_screens_and_accessories_storesfloor_covering_storesfloristsflorists_supplies_nursery_stock_and_flowersfreezer_and_locker_meat_provisionersfuel_dealers_non_automotivefuneral_services_crematoriesfurniture_home_furnishings_and_equipment_stores_except_appliancesfurniture_repair_refinishingfurriers_and_fur_shopsgeneral_servicesgift_card_novelty_and_souvenir_shopsglass_paint_and_wallpaper_storesglassware_crystal_storesgolf_courses_publicgovernment_licensed_horse_dog_racing_us_region_onlygovernment_licensed_online_casions_online_gambling_us_region_onlygovernment_owned_lotteries_non_us_regiongovernment_owned_lotteries_us_region_onlygovernment_servicesgrocery_stores_supermarketshardware_equipment_and_supplieshardware_storeshealth_and_beauty_spashearing_aids_sales_and_suppliesheating_plumbing_a_chobby_toy_and_game_shopshome_supply_warehouse_storeshospitalshotels_motels_and_resortshousehold_appliance_storesindustrial_suppliesinformation_retrieval_servicesinsurance_defaultinsurance_underwriting_premiumsintra_company_purchasesjewelry_stores_watches_clocks_and_silverware_storeslandscaping_serviceslaundrieslaundry_cleaning_serviceslegal_services_attorneysluggage_and_leather_goods_storeslumber_building_materials_storesmanual_cash_disbursemarinas_service_and_suppliesmarketplacesmasonry_stonework_and_plastermassage_parlorsmedical_and_dental_labsmedical_dental_ophthalmic_and_hospital_equipment_and_suppliesmedical_servicesmembership_organizationsmens_and_boys_clothing_and_accessories_storesmens_womens_clothing_storesmetal_service_centersmiscellaneousmiscellaneous_apparel_and_accessory_shopsmiscellaneous_auto_dealersmiscellaneous_business_servicesmiscellaneous_food_storesmiscellaneous_general_merchandisemiscellaneous_general_servicesmiscellaneous_home_furnishing_specialty_storesmiscellaneous_publishing_and_printingmiscellaneous_recreation_servicesmiscellaneous_repair_shopsmiscellaneous_specialty_retailmobile_home_dealersmotion_picture_theatersmotor_freight_carriers_and_truckingmotor_homes_dealersmotor_vehicle_supplies_and_new_partsmotorcycle_shops_and_dealersmotorcycle_shops_dealersmusic_stores_musical_instruments_pianos_and_sheet_musicnews_dealers_and_newsstandsnon_fi_money_ordersnon_fi_stored_value_card_purchase_loadnondurable_goodsnurseries_lawn_and_garden_supply_storesnursing_personal_careoffice_and_commercial_furnitureopticians_eyeglassesoptometrists_ophthalmologistorthopedic_goods_prosthetic_devicesosteopathspackage_stores_beer_wine_and_liquorpaints_varnishes_and_suppliesparking_lots_garagespassenger_railwayspawn_shopspet_shops_pet_food_and_suppliespetroleum_and_petroleum_productsphoto_developingphotographic_photocopy_microfilm_equipment_and_suppliesphotographic_studiospicture_video_productionpiece_goods_notions_and_other_dry_goodsplumbing_heating_equipment_and_suppliespolitical_organizationspostal_services_government_onlyprecious_stones_and_metals_watches_and_jewelryprofessional_servicespublic_warehousing_and_storagequick_copy_repro_and_blueprintrailroadsreal_estate_agents_and_managers_rentalsrecord_storesrecreational_vehicle_rentalsreligious_goods_storesreligious_organizationsroofing_siding_sheet_metalsecretarial_support_servicessecurity_brokers_dealersservice_stationssewing_needlework_fabric_and_piece_goods_storesshoe_repair_hat_cleaningshoe_storessmall_appliance_repairsnowmobile_dealersspecial_trade_servicesspecialty_cleaningsporting_goods_storessporting_recreation_campssports_and_riding_apparel_storessports_clubs_fieldsstamp_and_coin_storesstationary_office_supplies_printing_and_writing_paperstationery_stores_office_and_school_supply_storesswimming_pools_salest_ui_travel_germanytailors_alterationstax_payments_government_agenciestax_preparation_servicestaxicabs_limousinestelecommunication_equipment_and_telephone_salestelecommunication_servicestelegraph_servicestent_and_awning_shopstesting_laboratoriestheatrical_ticket_agenciestimesharestire_retreading_and_repairtolls_bridge_feestourist_attractions_and_exhibitstowing_servicestrailer_parks_campgroundstransportation_servicestravel_agencies_tour_operatorstruck_stop_iterationtruck_utility_trailer_rentalstypesetting_plate_making_and_related_servicestypewriter_storesu_s_federal_government_agencies_or_departmentsuniforms_commercial_clothingused_merchandise_and_secondhand_storesutilitiesvariety_storesveterinary_servicesvideo_amusement_game_suppliesvideo_game_arcadesvideo_tape_rental_storesvocational_trade_schoolswatch_jewelry_repairwelding_repairwholesale_clubswig_and_toupee_storeswires_money_orderswomens_accessory_and_specialty_shopswomens_ready_to_wear_storeswrecking_and_salvage_yards
cardholder.spending_controls.spending_limits.interval(enum) Interval (or event) to which the amount applies. Possible enum values:all_timeLimit applies to all transactions.dailyLimit applies to a day, starting at midnight UTC.monthlyLimit applies to a month, starting on the 1st at midnight UTC.per_authorizationLimit applies to each authorization.weeklyLimit applies to a week, starting on Sunday at midnight UTC.yearlyLimit applies to a year, starting on January 1st at midnight UTC.
cardholder.spending_controls.spending_limits_currency(enum, nullable) Currency of the amounts withinspending_limits.
cardholder.status(enum) Specifies whether to permit authorizations on this cardholder’s cards. Possible enum values:activeA platform has enabled the cardholder to approve authorizations made with their attached cards. However, if Stripe hasn’t yet verified the cardholder’s identity information, authorizations might still be blocked.blockedCards attached to this cardholder will decline all authorizations with thecardholder_blockedreason. This status is non-reversible.inactiveCards attached to this cardholder will decline all authorizations with thecardholder_inactivereason.
cardholder.type(enum) One ofindividualorcompany. See Choose a cardholder type for more details. Possible enum values:companyThe cardholder is a company or business entity, and additional information includes their tax ID. This option may not be available if your use case only supports individual cardholders.individualThe cardholder is a person, and additional information includes first and last name, date of birth, etc. If you’re issuing Celtic Spend Cards, then Individual cardholders must accept Authorized User Terms prior to activating their card.
created(timestamp) Time at which the object was created. Measured in seconds since the Unix epoch.currency(enum) Three-letter ISO currency code, in lowercase. Supported currencies areusdin the US,eurin the EU, andgbpin the UK.cvc(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) The card’s CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with theexpandparameter. Additionally, it’s only available via the “Retrieve a card” endpoint, not via “List all cards” or any other endpoint.exp_month(integer) The expiration month of the card.exp_year(integer) The expiration year of the card.last4(string) The last 4 digits of the card number.latest_fraud_warning(object, nullable) Stripe’s assessment of whether this card’s details have been compromised. If this property isn’t null, cancel and reissue the card to prevent fraudulent activity risk.latest_fraud_warning.started_at(timestamp, nullable) Timestamp of the most recent fraud warning.latest_fraud_warning.type(enum, nullable) The type of fraud warning that most recently took place on this card. This field updates with every new fraud warning, so the value changes over time. If populated, cancel and reissue the card. Possible enum values:card_testing_exposureThe card’s credentials were used successfully in a card testing attempt. Requires Advanced Fraud Tools.fraud_dispute_filedThe cardholder filed a fraud dispute for a transactionthird_party_reportedThe card was reported compromised by a third partyuser_indicated_fraudThe cardholder indicated that a fraudulent transaction occurred. Requires Advanced Fraud Tools.
lifecycle_controls(object, nullable) Rules that control the lifecycle of this card, such as automatic cancellation. Refer to our documentation for more details.lifecycle_controls.cancel_after(object) Cancels the card after the specified conditions are met.lifecycle_controls.cancel_after.payment_count(integer) The card is automatically cancelled when it makes this number of non-zero payment authorizations and transactions. The count includes penny authorizations, but doesn’t include non-payment actions, such as authorization advice.
livemode(boolean) If the object exists in live mode, the value istrue. If the object exists in test mode, the value isfalse.metadata(object) Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.number(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with theexpandparameter. Additionally, it’s only available via the “Retrieve a card” endpoint, not via “List all cards” or any other endpoint.personalization_design(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) The personalization design object belonging to this card.replaced_by(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) The latest card that replaces this card, if any.replacement_for(string, nullable, expandable (can be expanded into an object with theexpandrequest parameter)) The card this card replaces, if any.replacement_reason(enum, nullable) The reason why the previous card needed to be replaced. Possible enum values:damagedThe physical card has been damaged and cannot be used at terminals. This reason is only valid for cards of typephysical.expiredThe expiration date has passed or is imminent.fulfillment_errorThere was an error in fulfilling the card. This reason is only valid for cards of typephysical.lostThe card was lost. This status is only valid if the card it replaces is marked as lost.stolenThe card was stolen. This status is only valid if the card it replaces is marked as stolen.
second_line(string, nullable) Text separate from cardholder name, printed on the card.shipping(object, nullable) Where and how the card will be shipped.shipping.address(object) Shipping address.shipping.address.city(string, nullable) City, district, suburb, town, or village.shipping.address.country(string, nullable) Two-letter country code (ISO 3166-1 alpha-2).shipping.address.line1(string, nullable) Address line 1, such as the street, PO Box, or company name.shipping.address.line2(string, nullable) Address line 2, such as the apartment, suite, unit, or building.shipping.address.postal_code(string, nullable) ZIP or postal code.shipping.address.state(string, nullable) State, county, province, or region (ISO 3166-2).
shipping.address_validation(object, nullable) Address validation details for the shipment.shipping.address_validation.mode(enum) The address validation capabilities to use. Possible enum values:disabledThe card will be shipped without validating or normalizing the shipping address.normalization_onlyThe card will be shipped with the normalized address without validation. Undeliverable addresses won’t be blocked.validation_and_normalizationThe card will be shipped with the normalized, validated address. Undeliverable addresses will be blocked.
shipping.address_validation.normalized_address(object, nullable) The normalized shipping address.shipping.address_validation.normalized_address.city(string, nullable) City, district, suburb, town, or village.shipping.address_validation.normalized_address.country(string, nullable) Two-letter country code (ISO 3166-1 alpha-2).shipping.address_validation.normalized_address.line1(string, nullable) Address line 1, such as the street, PO Box, or company name.shipping.address_validation.normalized_address.line2(string, nullable) Address line 2, such as the apartment, suite, unit, or building.shipping.address_validation.normalized_address.postal_code(string, nullable) ZIP or postal code.shipping.address_validation.normalized_address.state(string, nullable) State, county, province, or region (ISO 3166-2).
shipping.address_validation.result(enum, nullable) The validation result for the shipping address. Possible enum values:indeterminateThe deliverability of the card’s shipping address could not be determined.likely_deliverableThe card’s shipping address is likely deliverable.likely_undeliverableThe card’s shipping address is likely undeliverable as submitted.
shipping.carrier(enum, nullable) The delivery company that shipped a card. Possible enum values:dhlDHLfedexFedExroyal_mailRoyal MailuspsUSPS
shipping.customs(object, nullable) Additional information that may be required for clearing customs.shipping.customs.eori_number(string, nullable) A registration number used for customs in Europe. See https://www.gov.uk/eori for the UK and https://ec.europa.eu/taxation_customs/business/customs-procedures-import-and-export/customs-procedures/economic-operators-registration-and-identification-number-eori_en for the EU.
shipping.eta(timestamp, nullable) A unix timestamp representing a best estimate of when the card will be delivered.shipping.name(string) Recipient name.shipping.phone_number(string, nullable) The phone number of the receiver of the shipment. Our courier partners will use this number to contact you in the event of card delivery issues. For individual shipments to the EU/UK, if this field is empty, we will provide them with the phone number provided when the cardholder was initially created.shipping.require_signature(boolean, nullable) Whether a signature is required for card delivery. This feature is only supported for US users. Standard shipping service does not support signature on delivery. The default value for standard shipping service is false and for express and priority services is true.shipping.service(enum) Shipment service, such asstandardorexpress. Possible enum values:expressCards arrive in 4 business days.priorityCards arrive in 2-3 business days.standardCards arrive in 5-8 business days.
shipping.status(enum, nullable) The delivery status of the card. Possible enum values:canceledThe card was canceled before being shipped.deliveredThe card has been delivered to its destination.failureThe card failed to be delivered but was not returned.pendingThe card is being prepared and has not yet shipped.returnedThe card failed to be delivered and was returned to the sender.shippedThe card has been shipped. If the card’s shipping carrier does not support tracking, this will be the card’s final status.submittedThe card has been submitted to the printer for shipment.
shipping.tracking_number(string, nullable) A tracking number for a card shipment.shipping.tracking_url(string, nullable) A link to the shipping carrier’s site where you can view detailed information about a card shipment.shipping.type(enum) Packaging options. Possible enum values:bulkCards are grouped and mailed together.individualCards are sent individually in an envelope.
spending_controls(object) Rules that control spending for this card. Refer to our documentation for more details.spending_controls.allowed_card_presences(array of enums, nullable) Array of card presence statuses from which authorizations will be allowed. Possible options arepresent,not_present. All other statuses will be blocked. Cannot be set withblocked_card_presences. Provide an empty value to unset this control. Possible enum values:not_presentpresent
spending_controls.allowed_categories(array of enums, nullable) Array of strings containing categories of authorizations to allow. All other categories will be blocked. Cannot be set withblocked_categories. Possible enum values:ac_refrigeration_repairaccounting_bookkeeping_servicesadvertising_servicesagricultural_cooperativeairlines_air_carriersairports_flying_fieldsambulance_servicesamusement_parks_carnivalsantique_reproductionsantique_shopsaquariumsarchitectural_surveying_servicesart_dealers_and_galleriesartists_supply_and_craft_shopsauto_and_home_supply_storesauto_body_repair_shopsauto_paint_shopsauto_service_shopsautomated_cash_disburseautomated_fuel_dispensersautomobile_associationsautomotive_parts_and_accessories_storesautomotive_tire_storesbail_and_bond_paymentsbakeriesbands_orchestrasbarber_and_beauty_shopsbetting_casino_gamblingbicycle_shopsbilliard_pool_establishmentsboat_dealersboat_rentals_and_leasesbook_storesbooks_periodicals_and_newspapersbowling_alleysbus_linesbusiness_secretarial_schoolsbuying_shopping_servicescable_satellite_and_other_pay_television_and_radiocamera_and_photographic_supply_storescandy_nut_and_confectionery_storescar_and_truck_dealers_new_usedcar_and_truck_dealers_used_onlycar_rental_agenciescar_washescarpentry_servicescarpet_upholstery_cleaningcatererscharitable_and_social_service_organizations_fundraisingchemicals_and_allied_productschild_care_serviceschildrens_and_infants_wear_storeschiropodists_podiatristschiropractorscigar_stores_and_standscivic_social_fraternal_associationscleaning_and_maintenanceclothing_rentalcolleges_universitiescommercial_equipmentcommercial_footwearcommercial_photography_art_and_graphicscommuter_transport_and_ferriescomputer_network_servicescomputer_programmingcomputer_repaircomputer_software_storescomputers_peripherals_and_softwareconcrete_work_servicesconstruction_materialsconsulting_public_relationscorrespondence_schoolscosmetic_storescounseling_servicescountry_clubscourier_servicescourt_costscredit_reporting_agenciescruise_linesdairy_products_storesdance_hall_studios_schoolsdating_escort_servicesdentists_orthodontistsdepartment_storesdetective_agenciesdigital_goods_applicationsdigital_goods_gamesdigital_goods_large_volumedigital_goods_mediadirect_marketing_catalog_merchantdirect_marketing_combination_catalog_and_retail_merchantdirect_marketing_inbound_telemarketingdirect_marketing_insurance_servicesdirect_marketing_otherdirect_marketing_outbound_telemarketingdirect_marketing_subscriptiondirect_marketing_traveldiscount_storesdoctorsdoor_to_door_salesdrapery_window_covering_and_upholstery_storesdrinking_placesdrug_stores_and_pharmaciesdrugs_drug_proprietaries_and_druggist_sundriesdry_cleanersdurable_goodsduty_free_storeseating_places_restaurantseducational_serviceselectric_razor_storeselectric_vehicle_chargingelectrical_parts_and_equipmentelectrical_serviceselectronics_repair_shopselectronics_storeselementary_secondary_schoolsemergency_services_gcas_visa_use_onlyemployment_temp_agenciesequipment_rentalexterminating_servicesfamily_clothing_storesfast_food_restaurantsfinancial_institutionsfines_government_administrative_entitiesfireplace_fireplace_screens_and_accessories_storesfloor_covering_storesfloristsflorists_supplies_nursery_stock_and_flowersfreezer_and_locker_meat_provisionersfuel_dealers_non_automotivefuneral_services_crematoriesfurniture_home_furnishings_and_equipment_stores_except_appliancesfurniture_repair_refinishingfurriers_and_fur_shopsgeneral_servicesgift_card_novelty_and_souvenir_shopsglass_paint_and_wallpaper_storesglassware_crystal_storesgolf_courses_publicgovernment_licensed_horse_dog_racing_us_region_onlygovernment_licensed_online_casions_online_gambling_us_region_onlygovernment_owned_lotteries_non_us_regiongovernment_owned_lotteries_us_region_onlygovernment_servicesgrocery_stores_supermarketshardware_equipment_and_supplieshardware_storeshealth_and_beauty_spashearing_aids_sales_and_suppliesheating_plumbing_a_chobby_toy_and_game_shopshome_supply_warehouse_storeshospitalshotels_motels_and_resortshousehold_appliance_storesindustrial_suppliesinformation_retrieval_servicesinsurance_defaultinsurance_underwriting_premiumsintra_company_purchasesjewelry_stores_watches_clocks_and_silverware_storeslandscaping_serviceslaundrieslaundry_cleaning_serviceslegal_services_attorneysluggage_and_leather_goods_storeslumber_building_materials_storesmanual_cash_disbursemarinas_service_and_suppliesmarketplacesmasonry_stonework_and_plastermassage_parlorsmedical_and_dental_labsmedical_dental_ophthalmic_and_hospital_equipment_and_suppliesmedical_servicesmembership_organizationsmens_and_boys_clothing_and_accessories_storesmens_womens_clothing_storesmetal_service_centersmiscellaneousmiscellaneous_apparel_and_accessory_shopsmiscellaneous_auto_dealersmiscellaneous_business_servicesmiscellaneous_food_storesmiscellaneous_general_merchandisemiscellaneous_general_servicesmiscellaneous_home_furnishing_specialty_storesmiscellaneous_publishing_and_printingmiscellaneous_recreation_servicesmiscellaneous_repair_shopsmiscellaneous_specialty_retailmobile_home_dealersmotion_picture_theatersmotor_freight_carriers_and_truckingmotor_homes_dealersmotor_vehicle_supplies_and_new_partsmotorcycle_shops_and_dealersmotorcycle_shops_dealersmusic_stores_musical_instruments_pianos_and_sheet_musicnews_dealers_and_newsstandsnon_fi_money_ordersnon_fi_stored_value_card_purchase_loadnondurable_goodsnurseries_lawn_and_garden_supply_storesnursing_personal_careoffice_and_commercial_furnitureopticians_eyeglassesoptometrists_ophthalmologistorthopedic_goods_prosthetic_devicesosteopathspackage_stores_beer_wine_and_liquorpaints_varnishes_and_suppliesparking_lots_garagespassenger_railwayspawn_shopspet_shops_pet_food_and_suppliespetroleum_and_petroleum_productsphoto_developingphotographic_photocopy_microfilm_equipment_and_suppliesphotographic_studiospicture_video_productionpiece_goods_notions_and_other_dry_goodsplumbing_heating_equipment_and_suppliespolitical_organizationspostal_services_government_onlyprecious_stones_and_metals_watches_and_jewelryprofessional_servicespublic_warehousing_and_storagequick_copy_repro_and_blueprintrailroadsreal_estate_agents_and_managers_rentalsrecord_storesrecreational_vehicle_rentalsreligious_goods_storesreligious_organizationsroofing_siding_sheet_metalsecretarial_support_servicessecurity_brokers_dealersservice_stationssewing_needlework_fabric_and_piece_goods_storesshoe_repair_hat_cleaningshoe_storessmall_appliance_repairsnowmobile_dealersspecial_trade_servicesspecialty_cleaningsporting_goods_storessporting_recreation_campssports_and_riding_apparel_storessports_clubs_fieldsstamp_and_coin_storesstationary_office_supplies_printing_and_writing_paperstationery_stores_office_and_school_supply_storesswimming_pools_salest_ui_travel_germanytailors_alterationstax_payments_government_agenciestax_preparation_servicestaxicabs_limousinestelecommunication_equipment_and_telephone_salestelecommunication_servicestelegraph_servicestent_and_awning_shopstesting_laboratoriestheatrical_ticket_agenciestimesharestire_retreading_and_repairtolls_bridge_feestourist_attractions_and_exhibitstowing_servicestrailer_parks_campgroundstransportation_servicestravel_agencies_tour_operatorstruck_stop_iterationtruck_utility_trailer_rentalstypesetting_plate_making_and_related_servicestypewriter_storesu_s_federal_government_agencies_or_departmentsuniforms_commercial_clothingused_merchandise_and_secondhand_storesutilitiesvariety_storesveterinary_servicesvideo_amusement_game_suppliesvideo_game_arcadesvideo_tape_rental_storesvocational_trade_schoolswatch_jewelry_repairwelding_repairwholesale_clubswig_and_toupee_storeswires_money_orderswomens_accessory_and_specialty_shopswomens_ready_to_wear_storeswrecking_and_salvage_yards
spending_controls.allowed_merchant_countries(array of strings, nullable) Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g.US). Cannot be set withblocked_merchant_countries. Provide an empty value to unset this control.spending_controls.blocked_card_presences(array of enums, nullable) Array of card presence statuses from which authorizations will be declined. Possible options arepresent,not_present. Cannot be set withallowed_card_presences. Provide an empty value to unset this control. Possible enum values:not_presentpresent
spending_controls.blocked_categories(array of enums, nullable) Array of strings containing categories of authorizations to decline. All other categories will be allowed. Cannot be set withallowed_categories. Possible enum values:ac_refrigeration_repairaccounting_bookkeeping_servicesadvertising_servicesagricultural_cooperativeairlines_air_carriersairports_flying_fieldsambulance_servicesamusement_parks_carnivalsantique_reproductionsantique_shopsaquariumsarchitectural_surveying_servicesart_dealers_and_galleriesartists_supply_and_craft_shopsauto_and_home_supply_storesauto_body_repair_shopsauto_paint_shopsauto_service_shopsautomated_cash_disburseautomated_fuel_dispensersautomobile_associationsautomotive_parts_and_accessories_storesautomotive_tire_storesbail_and_bond_paymentsbakeriesbands_orchestrasbarber_and_beauty_shopsbetting_casino_gamblingbicycle_shopsbilliard_pool_establishmentsboat_dealersboat_rentals_and_leasesbook_storesbooks_periodicals_and_newspapersbowling_alleysbus_linesbusiness_secretarial_schoolsbuying_shopping_servicescable_satellite_and_other_pay_television_and_radiocamera_and_photographic_supply_storescandy_nut_and_confectionery_storescar_and_truck_dealers_new_usedcar_and_truck_dealers_used_onlycar_rental_agenciescar_washescarpentry_servicescarpet_upholstery_cleaningcatererscharitable_and_social_service_organizations_fundraisingchemicals_and_allied_productschild_care_serviceschildrens_and_infants_wear_storeschiropodists_podiatristschiropractorscigar_stores_and_standscivic_social_fraternal_associationscleaning_and_maintenanceclothing_rentalcolleges_universitiescommercial_equipmentcommercial_footwearcommercial_photography_art_and_graphicscommuter_transport_and_ferriescomputer_network_servicescomputer_programmingcomputer_repaircomputer_software_storescomputers_peripherals_and_softwareconcrete_work_servicesconstruction_materialsconsulting_public_relationscorrespondence_schoolscosmetic_storescounseling_servicescountry_clubscourier_servicescourt_costscredit_reporting_agenciescruise_linesdairy_products_storesdance_hall_studios_schoolsdating_escort_servicesdentists_orthodontistsdepartment_storesdetective_agenciesdigital_goods_applicationsdigital_goods_gamesdigital_goods_large_volumedigital_goods_mediadirect_marketing_catalog_merchantdirect_marketing_combination_catalog_and_retail_merchantdirect_marketing_inbound_telemarketingdirect_marketing_insurance_servicesdirect_marketing_otherdirect_marketing_outbound_telemarketingdirect_marketing_subscriptiondirect_marketing_traveldiscount_storesdoctorsdoor_to_door_salesdrapery_window_covering_and_upholstery_storesdrinking_placesdrug_stores_and_pharmaciesdrugs_drug_proprietaries_and_druggist_sundriesdry_cleanersdurable_goodsduty_free_storeseating_places_restaurantseducational_serviceselectric_razor_storeselectric_vehicle_chargingelectrical_parts_and_equipmentelectrical_serviceselectronics_repair_shopselectronics_storeselementary_secondary_schoolsemergency_services_gcas_visa_use_onlyemployment_temp_agenciesequipment_rentalexterminating_servicesfamily_clothing_storesfast_food_restaurantsfinancial_institutionsfines_government_administrative_entitiesfireplace_fireplace_screens_and_accessories_storesfloor_covering_storesfloristsflorists_supplies_nursery_stock_and_flowersfreezer_and_locker_meat_provisionersfuel_dealers_non_automotivefuneral_services_crematoriesfurniture_home_furnishings_and_equipment_stores_except_appliancesfurniture_repair_refinishingfurriers_and_fur_shopsgeneral_servicesgift_card_novelty_and_souvenir_shopsglass_paint_and_wallpaper_storesglassware_crystal_storesgolf_courses_publicgovernment_licensed_horse_dog_racing_us_region_onlygovernment_licensed_online_casions_online_gambling_us_region_onlygovernment_owned_lotteries_non_us_regiongovernment_owned_lotteries_us_region_onlygovernment_servicesgrocery_stores_supermarketshardware_equipment_and_supplieshardware_storeshealth_and_beauty_spashearing_aids_sales_and_suppliesheating_plumbing_a_chobby_toy_and_game_shopshome_supply_warehouse_storeshospitalshotels_motels_and_resortshousehold_appliance_storesindustrial_suppliesinformation_retrieval_servicesinsurance_defaultinsurance_underwriting_premiumsintra_company_purchasesjewelry_stores_watches_clocks_and_silverware_storeslandscaping_serviceslaundrieslaundry_cleaning_serviceslegal_services_attorneysluggage_and_leather_goods_storeslumber_building_materials_storesmanual_cash_disbursemarinas_service_and_suppliesmarketplacesmasonry_stonework_and_plastermassage_parlorsmedical_and_dental_labsmedical_dental_ophthalmic_and_hospital_equipment_and_suppliesmedical_servicesmembership_organizationsmens_and_boys_clothing_and_accessories_storesmens_womens_clothing_storesmetal_service_centersmiscellaneousmiscellaneous_apparel_and_accessory_shopsmiscellaneous_auto_dealersmiscellaneous_business_servicesmiscellaneous_food_storesmiscellaneous_general_merchandisemiscellaneous_general_servicesmiscellaneous_home_furnishing_specialty_storesmiscellaneous_publishing_and_printingmiscellaneous_recreation_servicesmiscellaneous_repair_shopsmiscellaneous_specialty_retailmobile_home_dealersmotion_picture_theatersmotor_freight_carriers_and_truckingmotor_homes_dealersmotor_vehicle_supplies_and_new_partsmotorcycle_shops_and_dealersmotorcycle_shops_dealersmusic_stores_musical_instruments_pianos_and_sheet_musicnews_dealers_and_newsstandsnon_fi_money_ordersnon_fi_stored_value_card_purchase_loadnondurable_goodsnurseries_lawn_and_garden_supply_storesnursing_personal_careoffice_and_commercial_furnitureopticians_eyeglassesoptometrists_ophthalmologistorthopedic_goods_prosthetic_devicesosteopathspackage_stores_beer_wine_and_liquorpaints_varnishes_and_suppliesparking_lots_garagespassenger_railwayspawn_shopspet_shops_pet_food_and_suppliespetroleum_and_petroleum_productsphoto_developingphotographic_photocopy_microfilm_equipment_and_suppliesphotographic_studiospicture_video_productionpiece_goods_notions_and_other_dry_goodsplumbing_heating_equipment_and_suppliespolitical_organizationspostal_services_government_onlyprecious_stones_and_metals_watches_and_jewelryprofessional_servicespublic_warehousing_and_storagequick_copy_repro_and_blueprintrailroadsreal_estate_agents_and_managers_rentalsrecord_storesrecreational_vehicle_rentalsreligious_goods_storesreligious_organizationsroofing_siding_sheet_metalsecretarial_support_servicessecurity_brokers_dealersservice_stationssewing_needlework_fabric_and_piece_goods_storesshoe_repair_hat_cleaningshoe_storessmall_appliance_repairsnowmobile_dealersspecial_trade_servicesspecialty_cleaningsporting_goods_storessporting_recreation_campssports_and_riding_apparel_storessports_clubs_fieldsstamp_and_coin_storesstationary_office_supplies_printing_and_writing_paperstationery_stores_office_and_school_supply_storesswimming_pools_salest_ui_travel_germanytailors_alterationstax_payments_government_agenciestax_preparation_servicestaxicabs_limousinestelecommunication_equipment_and_telephone_salestelecommunication_servicestelegraph_servicestent_and_awning_shopstesting_laboratoriestheatrical_ticket_agenciestimesharestire_retreading_and_repairtolls_bridge_feestourist_attractions_and_exhibitstowing_servicestrailer_parks_campgroundstransportation_servicestravel_agencies_tour_operatorstruck_stop_iterationtruck_utility_trailer_rentalstypesetting_plate_making_and_related_servicestypewriter_storesu_s_federal_government_agencies_or_departmentsuniforms_commercial_clothingused_merchandise_and_secondhand_storesutilitiesvariety_storesveterinary_servicesvideo_amusement_game_suppliesvideo_game_arcadesvideo_tape_rental_storesvocational_trade_schoolswatch_jewelry_repairwelding_repairwholesale_clubswig_and_toupee_storeswires_money_orderswomens_accessory_and_specialty_shopswomens_ready_to_wear_storeswrecking_and_salvage_yards
spending_controls.blocked_merchant_countries(array of strings, nullable) Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g.US). Cannot be set withallowed_merchant_countries. Provide an empty value to unset this control.spending_controls.spending_limits(array of objects, nullable) Limit spending with amount-based rules that apply across any cards this card replaced (i.e., itsreplacement_forcard and that card’sreplacement_forcard, up the chain).spending_controls.spending_limits.amount(integer) Maximum amount allowed to spend per interval. This amount is in the card’s currency and in the smallest currency unit.spending_controls.spending_limits.categories(array of enums, nullable) Array of strings containing categories this limit applies to. Omitting this field will apply the limit to all categories. Possible enum values:ac_refrigeration_repairaccounting_bookkeeping_servicesadvertising_servicesagricultural_cooperativeairlines_air_carriersairports_flying_fieldsambulance_servicesamusement_parks_carnivalsantique_reproductionsantique_shopsaquariumsarchitectural_surveying_servicesart_dealers_and_galleriesartists_supply_and_craft_shopsauto_and_home_supply_storesauto_body_repair_shopsauto_paint_shopsauto_service_shopsautomated_cash_disburseautomated_fuel_dispensersautomobile_associationsautomotive_parts_and_accessories_storesautomotive_tire_storesbail_and_bond_paymentsbakeriesbands_orchestrasbarber_and_beauty_shopsbetting_casino_gamblingbicycle_shopsbilliard_pool_establishmentsboat_dealersboat_rentals_and_leasesbook_storesbooks_periodicals_and_newspapersbowling_alleysbus_linesbusiness_secretarial_schoolsbuying_shopping_servicescable_satellite_and_other_pay_television_and_radiocamera_and_photographic_supply_storescandy_nut_and_confectionery_storescar_and_truck_dealers_new_usedcar_and_truck_dealers_used_onlycar_rental_agenciescar_washescarpentry_servicescarpet_upholstery_cleaningcatererscharitable_and_social_service_organizations_fundraisingchemicals_and_allied_productschild_care_serviceschildrens_and_infants_wear_storeschiropodists_podiatristschiropractorscigar_stores_and_standscivic_social_fraternal_associationscleaning_and_maintenanceclothing_rentalcolleges_universitiescommercial_equipmentcommercial_footwearcommercial_photography_art_and_graphicscommuter_transport_and_ferriescomputer_network_servicescomputer_programmingcomputer_repaircomputer_software_storescomputers_peripherals_and_softwareconcrete_work_servicesconstruction_materialsconsulting_public_relationscorrespondence_schoolscosmetic_storescounseling_servicescountry_clubscourier_servicescourt_costscredit_reporting_agenciescruise_linesdairy_products_storesdance_hall_studios_schoolsdating_escort_servicesdentists_orthodontistsdepartment_storesdetective_agenciesdigital_goods_applicationsdigital_goods_gamesdigital_goods_large_volumedigital_goods_mediadirect_marketing_catalog_merchantdirect_marketing_combination_catalog_and_retail_merchantdirect_marketing_inbound_telemarketingdirect_marketing_insurance_servicesdirect_marketing_otherdirect_marketing_outbound_telemarketingdirect_marketing_subscriptiondirect_marketing_traveldiscount_storesdoctorsdoor_to_door_salesdrapery_window_covering_and_upholstery_storesdrinking_placesdrug_stores_and_pharmaciesdrugs_drug_proprietaries_and_druggist_sundriesdry_cleanersdurable_goodsduty_free_storeseating_places_restaurantseducational_serviceselectric_razor_storeselectric_vehicle_chargingelectrical_parts_and_equipmentelectrical_serviceselectronics_repair_shopselectronics_storeselementary_secondary_schoolsemergency_services_gcas_visa_use_onlyemployment_temp_agenciesequipment_rentalexterminating_servicesfamily_clothing_storesfast_food_restaurantsfinancial_institutionsfines_government_administrative_entitiesfireplace_fireplace_screens_and_accessories_storesfloor_covering_storesfloristsflorists_supplies_nursery_stock_and_flowersfreezer_and_locker_meat_provisionersfuel_dealers_non_automotivefuneral_services_crematoriesfurniture_home_furnishings_and_equipment_stores_except_appliancesfurniture_repair_refinishingfurriers_and_fur_shopsgeneral_servicesgift_card_novelty_and_souvenir_shopsglass_paint_and_wallpaper_storesglassware_crystal_storesgolf_courses_publicgovernment_licensed_horse_dog_racing_us_region_onlygovernment_licensed_online_casions_online_gambling_us_region_onlygovernment_owned_lotteries_non_us_regiongovernment_owned_lotteries_us_region_onlygovernment_servicesgrocery_stores_supermarketshardware_equipment_and_supplieshardware_storeshealth_and_beauty_spashearing_aids_sales_and_suppliesheating_plumbing_a_chobby_toy_and_game_shopshome_supply_warehouse_storeshospitalshotels_motels_and_resortshousehold_appliance_storesindustrial_suppliesinformation_retrieval_servicesinsurance_defaultinsurance_underwriting_premiumsintra_company_purchasesjewelry_stores_watches_clocks_and_silverware_storeslandscaping_serviceslaundrieslaundry_cleaning_serviceslegal_services_attorneysluggage_and_leather_goods_storeslumber_building_materials_storesmanual_cash_disbursemarinas_service_and_suppliesmarketplacesmasonry_stonework_and_plastermassage_parlorsmedical_and_dental_labsmedical_dental_ophthalmic_and_hospital_equipment_and_suppliesmedical_servicesmembership_organizationsmens_and_boys_clothing_and_accessories_storesmens_womens_clothing_storesmetal_service_centersmiscellaneousmiscellaneous_apparel_and_accessory_shopsmiscellaneous_auto_dealersmiscellaneous_business_servicesmiscellaneous_food_storesmiscellaneous_general_merchandisemiscellaneous_general_servicesmiscellaneous_home_furnishing_specialty_storesmiscellaneous_publishing_and_printingmiscellaneous_recreation_servicesmiscellaneous_repair_shopsmiscellaneous_specialty_retailmobile_home_dealersmotion_picture_theatersmotor_freight_carriers_and_truckingmotor_homes_dealersmotor_vehicle_supplies_and_new_partsmotorcycle_shops_and_dealersmotorcycle_shops_dealersmusic_stores_musical_instruments_pianos_and_sheet_musicnews_dealers_and_newsstandsnon_fi_money_ordersnon_fi_stored_value_card_purchase_loadnondurable_goodsnurseries_lawn_and_garden_supply_storesnursing_personal_careoffice_and_commercial_furnitureopticians_eyeglassesoptometrists_ophthalmologistorthopedic_goods_prosthetic_devicesosteopathspackage_stores_beer_wine_and_liquorpaints_varnishes_and_suppliesparking_lots_garagespassenger_railwayspawn_shopspet_shops_pet_food_and_suppliespetroleum_and_petroleum_productsphoto_developingphotographic_photocopy_microfilm_equipment_and_suppliesphotographic_studiospicture_video_productionpiece_goods_notions_and_other_dry_goodsplumbing_heating_equipment_and_suppliespolitical_organizationspostal_services_government_onlyprecious_stones_and_metals_watches_and_jewelryprofessional_servicespublic_warehousing_and_storagequick_copy_repro_and_blueprintrailroadsreal_estate_agents_and_managers_rentalsrecord_storesrecreational_vehicle_rentalsreligious_goods_storesreligious_organizationsroofing_siding_sheet_metalsecretarial_support_servicessecurity_brokers_dealersservice_stationssewing_needlework_fabric_and_piece_goods_storesshoe_repair_hat_cleaningshoe_storessmall_appliance_repairsnowmobile_dealersspecial_trade_servicesspecialty_cleaningsporting_goods_storessporting_recreation_campssports_and_riding_apparel_storessports_clubs_fieldsstamp_and_coin_storesstationary_office_supplies_printing_and_writing_paperstationery_stores_office_and_school_supply_storesswimming_pools_salest_ui_travel_germanytailors_alterationstax_payments_government_agenciestax_preparation_servicestaxicabs_limousinestelecommunication_equipment_and_telephone_salestelecommunication_servicestelegraph_servicestent_and_awning_shopstesting_laboratoriestheatrical_ticket_agenciestimesharestire_retreading_and_repairtolls_bridge_feestourist_attractions_and_exhibitstowing_servicestrailer_parks_campgroundstransportation_servicestravel_agencies_tour_operatorstruck_stop_iterationtruck_utility_trailer_rentalstypesetting_plate_making_and_related_servicestypewriter_storesu_s_federal_government_agencies_or_departmentsuniforms_commercial_clothingused_merchandise_and_secondhand_storesutilitiesvariety_storesveterinary_servicesvideo_amusement_game_suppliesvideo_game_arcadesvideo_tape_rental_storesvocational_trade_schoolswatch_jewelry_repairwelding_repairwholesale_clubswig_and_toupee_storeswires_money_orderswomens_accessory_and_specialty_shopswomens_ready_to_wear_storeswrecking_and_salvage_yards
spending_controls.spending_limits.interval(enum) Interval (or event) to which the amount applies. Possible enum values:all_timeLimit applies to all transactions.dailyLimit applies to a day, starting at midnight UTC.monthlyLimit applies to a month, starting on the 1st at midnight UTC.per_authorizationLimit applies to each authorization.weeklyLimit applies to a week, starting on Sunday at midnight UTC.yearlyLimit applies to a year, starting on January 1st at midnight UTC.
spending_controls.spending_limits_currency(enum, nullable) Currency of the amounts withinspending_limits. Always the same as the currency of the card.
status(enum) Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults toinactive. Possible enum values:activeThe card can approve authorizations. If the card is linked to a cardholder with past-due requirements, you may be unable to change the card’s status to ‘active’.canceledThe card will decline authorizations with thecard_canceledreason. This status is permanent.inactiveThe card will decline authorizations with thecard_inactivereason.
type(enum) The type of the card. Possible enum values:physicalA physical card will be printed and shipped. It can be used at physical terminals.virtualNo physical card will be printed. The card can be used online and can be added to digital wallets.
wallets(object, nullable) Information relating to digital wallets (like Apple Pay and Google Pay).wallets.apple_pay(object) Apple Pay Detailswallets.apple_pay.eligible(boolean) Apple Pay Eligibilitywallets.apple_pay.ineligible_reason(enum, nullable) Reason the card is ineligible for Apple Pay Possible enum values:missing_agreementApple Pay is not enabled for your account.missing_cardholder_contactCardholder phone number or email required.unsupported_regionApple Pay is not supported in the cardholder’s country.
wallets.google_pay(object) Google Pay Detailswallets.google_pay.eligible(boolean) Google Pay Eligibilitywallets.google_pay.ineligible_reason(enum, nullable) Reason the card is ineligible for Google Pay Possible enum values:missing_agreementGoogle Pay is not enabled for your account.missing_cardholder_contactCardholder phone number or email required.unsupported_regionGoogle Pay is not supported in the cardholder’s country.
wallets.primary_account_identifier(string, nullable) Unique identifier for a card used with digital wallets
Virtual
Virtual
The Card object
json
{
"id": "ic_1MvSieLkdIwHu7ixn6uuO0Xu",
"object": "issuing.card",
"brand": "Visa",
"cancellation_reason": null,
"cardholder": {
"id": "ich_1MsKAB2eZvKYlo2C3eZ2BdvK",
"object": "issuing.cardholder",
"billing": {
"address": {
"city": "Anytown",
"country": "US",
"line1": "123 Main Street",
"line2": null,
"postal_code": "12345",
"state": "CA"
}
},
"company": null,
"created": 1680415995,
"email": null,
"individual": null,
"livemode": false,
"metadata": {},
"name": "John Doe",
"phone_number": null,
"requirements": {
"disabled_reason": "requirements.past_due",
"past_due": [
"individual.card_issuing.user_terms_acceptance.ip",
"individual.card_issuing.user_terms_acceptance.date",
"individual.first_name",
"individual.last_name"
]
},
"spending_controls": {
"allowed_categories": [],
"blocked_categories": [],
"spending_limits": [],
"spending_limits_currency": null
},
"status": "active",
"type": "individual"
},
"created": 1681163868,
"currency": "usd",
"exp_month": 8,
"exp_year": 2024,
"last4": "4242",
"livemode": false,
"metadata": {},
"replaced_by": null,
"replacement_for": null,
"replacement_reason": null,
"shipping": null,
"spending_controls": {
"allowed_categories": null,
"blocked_categories": null,
"spending_limits": [],
"spending_limits_currency": null
},
"status": "active",
"type": "virtual",
"wallets": {
"apple_pay": {
"eligible": false,
"ineligible_reason": "missing_cardholder_contact"
},
"google_pay": {
"eligible": false,
"ineligible_reason": "missing_cardholder_contact"
},
"primary_account_identifier": null
}
}Physical
Physical
The Card object
json
{
"id": "ic_1MvSieLkdIwHu7ixn6uuO0Xu",
"object": "issuing.card",
"brand": "Visa",
"cancellation_reason": null,
"cardholder": {
"id": "ich_1MsKAB2eZvKYlo2C3eZ2BdvK",
"object": "issuing.cardholder",
"billing": {
"address": {
"city": "Anytown",
"country": "US",
"line1": "123 Main Street",
"line2": null,
"postal_code": "12345",
"state": "CA"
}
},
"company": null,
"created": 1680415995,
"email": null,
"individual": null,
"livemode": false,
"metadata": {},
"name": "John Doe",
"phone_number": null,
"requirements": {
"disabled_reason": "requirements.past_due",
"past_due": [
"individual.card_issuing.user_terms_acceptance.ip",
"individual.card_issuing.user_terms_acceptance.date",
"individual.first_name",
"individual.last_name"
]
},
"spending_controls": {
"allowed_categories": [],
"blocked_categories": [],
"spending_limits": [],
"spending_limits_currency": null
},
"status": "active",
"type": "individual"
},
"created": 1681163868,
"currency": "usd",
"exp_month": 8,
"exp_year": 2024,
"last4": "4242",
"livemode": false,
"personalization_design": "ipcd_1QhT4vRkL7wZcM8bJqF3gN2Y",
"metadata": {},
"replaced_by": null,
"replacement_for": null,
"replacement_reason": null,
"shipping": {
"address": {
"city": "Anytown",
"country": "US",
"line1": "123 Main Street",
"line2": null,
"postal_code": "12345",
"state": "CA"
},
"address_validation": {
"mode": "validation_and_normalization",
"normalized_address": {
"city": "ANYTOWN",
"country": "US",
"line1": "123 MAIN ST",
"line2": null,
"postal_code": "12345",
"state": "CA"
},
"result": "likely_deliverable"
},
"carrier": "usps",
"customs": {
"eori_number": null
},
"eta": 1680415995,
"name": "John Doe",
"phone": null,
"phone_number": "+12345678910",
"require_signature": false,
"service": "standard",
"status": "pending",
"tracking_number": null,
"tracking_url": null,
"type": "individual"
},
"spending_controls": {
"allowed_categories": null,
"blocked_categories": null,
"spending_limits": [],
"spending_limits_currency": null
},
"status": "active",
"type": "physical",
"wallets": {
"apple_pay": {
"eligible": false,
"ineligible_reason": "missing_cardholder_contact"
},
"google_pay": {
"eligible": false,
"ineligible_reason": "missing_cardholder_contact"
},
"primary_account_identifier": null
}
}