View Source Stripe.Issuing.Cardholder (Striped v0.4.0)
An Issuing Cardholder
object represents an individual or business entity who is issued cards.
Related guide: How to create a Cardholder
Link to this section Summary
Types
The cardholder’s billing address.
The cardholder's billing address.
Additional information about a company
cardholder.
The date of birth of this cardholder.
An identifying document, either a passport or local ID card.
Additional information about an individual
cardholder.
Rules that control spending across this cardholder's cards. Refer to our documentation for more details.
The issuing.cardholder
type.
Government-issued ID document for this cardholder.
Functions
Creates a new Issuing Cardholder
object that can be issued cards.
Returns a list of Issuing Cardholder
objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
Retrieves an Issuing Cardholder
object.
Updates the specified Issuing Cardholder
object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
Link to this section Types
@type address() :: %{ optional(:city) => binary(), optional(:country) => binary(), optional(:line1) => binary(), optional(:line2) => binary(), optional(:postal_code) => binary(), optional(:state) => binary() }
The cardholder’s billing address.
@type billing() :: %{optional(:address) => address()}
The cardholder's billing address.
@type company() :: %{optional(:tax_id) => binary()}
Additional information about a company
cardholder.
@type dob() :: %{ optional(:day) => integer(), optional(:month) => integer(), optional(:year) => integer() }
The date of birth of this cardholder.
An identifying document, either a passport or local ID card.
@type individual() :: %{ optional(:dob) => dob(), optional(:first_name) => binary(), optional(:last_name) => binary(), optional(:verification) => verification() }
Additional information about an individual
cardholder.
@type spending_controls() :: %{ optional(:allowed_categories) => [ :ac_refrigeration_repair | :accounting_bookkeeping_services | :advertising_services | :agricultural_cooperative | :airlines_air_carriers | :airports_flying_fields | :ambulance_services | :amusement_parks_carnivals | :antique_reproductions | :antique_shops | :aquariums | :architectural_surveying_services | :art_dealers_and_galleries | :artists_supply_and_craft_shops | :auto_and_home_supply_stores | :auto_body_repair_shops | :auto_paint_shops | :auto_service_shops | :automated_cash_disburse | :automated_fuel_dispensers | :automobile_associations | :automotive_parts_and_accessories_stores | :automotive_tire_stores | :bail_and_bond_payments | :bakeries | :bands_orchestras | :barber_and_beauty_shops | :betting_casino_gambling | :bicycle_shops | :billiard_pool_establishments | :boat_dealers | :boat_rentals_and_leases | :book_stores | :books_periodicals_and_newspapers | :bowling_alleys | :bus_lines | :business_secretarial_schools | :buying_shopping_services | :cable_satellite_and_other_pay_television_and_radio | :camera_and_photographic_supply_stores | :candy_nut_and_confectionery_stores | :car_and_truck_dealers_new_used | :car_and_truck_dealers_used_only | :car_rental_agencies | :car_washes | :carpentry_services | :carpet_upholstery_cleaning | :caterers | :charitable_and_social_service_organizations_fundraising | :chemicals_and_allied_products | :child_care_services | :childrens_and_infants_wear_stores | :chiropodists_podiatrists | :chiropractors | :cigar_stores_and_stands | :civic_social_fraternal_associations | :cleaning_and_maintenance | :clothing_rental | :colleges_universities | :commercial_equipment | :commercial_footwear | :commercial_photography_art_and_graphics | :commuter_transport_and_ferries | :computer_network_services | :computer_programming | :computer_repair | :computer_software_stores | :computers_peripherals_and_software | :concrete_work_services | :construction_materials | :consulting_public_relations | :correspondence_schools | :cosmetic_stores | :counseling_services | :country_clubs | :courier_services | :court_costs | :credit_reporting_agencies | :cruise_lines | :dairy_products_stores | :dance_hall_studios_schools | :dating_escort_services | :dentists_orthodontists | :department_stores | :detective_agencies | :digital_goods_applications | :digital_goods_games | :digital_goods_large_volume | :digital_goods_media | :direct_marketing_catalog_merchant | :direct_marketing_combination_catalog_and_retail_merchant | :direct_marketing_inbound_telemarketing | :direct_marketing_insurance_services | :direct_marketing_other | :direct_marketing_outbound_telemarketing | :direct_marketing_subscription | :direct_marketing_travel | :discount_stores | :doctors | :door_to_door_sales | :drapery_window_covering_and_upholstery_stores | :drinking_places | :drug_stores_and_pharmacies | :drugs_drug_proprietaries_and_druggist_sundries | :dry_cleaners | :durable_goods | :duty_free_stores | :eating_places_restaurants | :educational_services | :electric_razor_stores | :electrical_parts_and_equipment | :electrical_services | :electronics_repair_shops | :electronics_stores | :elementary_secondary_schools | :employment_temp_agencies | :equipment_rental | :exterminating_services | :family_clothing_stores | :fast_food_restaurants | :financial_institutions | :fines_government_administrative_entities | :fireplace_fireplace_screens_and_accessories_stores | :floor_covering_stores | :florists | :florists_supplies_nursery_stock_and_flowers | :freezer_and_locker_meat_provisioners | :fuel_dealers_non_automotive | :funeral_services_crematories | :furniture_home_furnishings_and_equipment_stores_except_appliances | :furniture_repair_refinishing | :furriers_and_fur_shops | :general_services | :gift_card_novelty_and_souvenir_shops | :glass_paint_and_wallpaper_stores | :glassware_crystal_stores | :golf_courses_public | :government_services | :grocery_stores_supermarkets | :hardware_equipment_and_supplies | :hardware_stores | :health_and_beauty_spas | :hearing_aids_sales_and_supplies | :heating_plumbing_a_c | :hobby_toy_and_game_shops | :home_supply_warehouse_stores | :hospitals | :hotels_motels_and_resorts | :household_appliance_stores | :industrial_supplies | :information_retrieval_services | :insurance_default | :insurance_underwriting_premiums | :intra_company_purchases | :jewelry_stores_watches_clocks_and_silverware_stores | :landscaping_services | :laundries | :laundry_cleaning_services | :legal_services_attorneys | :luggage_and_leather_goods_stores | :lumber_building_materials_stores | :manual_cash_disburse | :marinas_service_and_supplies | :masonry_stonework_and_plaster | :massage_parlors | :medical_and_dental_labs | :medical_dental_ophthalmic_and_hospital_equipment_and_supplies | :medical_services | :membership_organizations | :mens_and_boys_clothing_and_accessories_stores | :mens_womens_clothing_stores | :metal_service_centers | :miscellaneous | :miscellaneous_apparel_and_accessory_shops | :miscellaneous_auto_dealers | :miscellaneous_business_services | :miscellaneous_food_stores | :miscellaneous_general_merchandise | :miscellaneous_general_services | :miscellaneous_home_furnishing_specialty_stores | :miscellaneous_publishing_and_printing | :miscellaneous_recreation_services | :miscellaneous_repair_shops | :miscellaneous_specialty_retail | :mobile_home_dealers | :motion_picture_theaters | :motor_freight_carriers_and_trucking | :motor_homes_dealers | :motor_vehicle_supplies_and_new_parts | :motorcycle_shops_and_dealers | :motorcycle_shops_dealers | :music_stores_musical_instruments_pianos_and_sheet_music | :news_dealers_and_newsstands | :non_fi_money_orders | :non_fi_stored_value_card_purchase_load | :nondurable_goods | :nurseries_lawn_and_garden_supply_stores | :nursing_personal_care | :office_and_commercial_furniture | :opticians_eyeglasses | :optometrists_ophthalmologist | :orthopedic_goods_prosthetic_devices | :osteopaths | :package_stores_beer_wine_and_liquor | :paints_varnishes_and_supplies | :parking_lots_garages | :passenger_railways | :pawn_shops | :pet_shops_pet_food_and_supplies | :petroleum_and_petroleum_products | :photo_developing | :photographic_photocopy_microfilm_equipment_and_supplies | :photographic_studios | :picture_video_production | :piece_goods_notions_and_other_dry_goods | :plumbing_heating_equipment_and_supplies | :political_organizations | :postal_services_government_only | :precious_stones_and_metals_watches_and_jewelry | :professional_services | :public_warehousing_and_storage | :quick_copy_repro_and_blueprint | :railroads | :real_estate_agents_and_managers_rentals | :record_stores | :recreational_vehicle_rentals | :religious_goods_stores | :religious_organizations | :roofing_siding_sheet_metal | :secretarial_support_services | :security_brokers_dealers | :service_stations | :sewing_needlework_fabric_and_piece_goods_stores | :shoe_repair_hat_cleaning | :shoe_stores | :small_appliance_repair | :snowmobile_dealers | :special_trade_services | :specialty_cleaning | :sporting_goods_stores | :sporting_recreation_camps | :sports_and_riding_apparel_stores | :sports_clubs_fields | :stamp_and_coin_stores | :stationary_office_supplies_printing_and_writing_paper | :stationery_stores_office_and_school_supply_stores | :swimming_pools_sales | :t_ui_travel_germany | :tailors_alterations | :tax_payments_government_agencies | :tax_preparation_services | :taxicabs_limousines | :telecommunication_equipment_and_telephone_sales | :telecommunication_services | :telegraph_services | :tent_and_awning_shops | :testing_laboratories | :theatrical_ticket_agencies | :timeshares | :tire_retreading_and_repair | :tolls_bridge_fees | :tourist_attractions_and_exhibits | :towing_services | :trailer_parks_campgrounds | :transportation_services | :travel_agencies_tour_operators | :truck_stop_iteration | :truck_utility_trailer_rentals | :typesetting_plate_making_and_related_services | :typewriter_stores | :u_s_federal_government_agencies_or_departments | :uniforms_commercial_clothing | :used_merchandise_and_secondhand_stores | :utilities | :variety_stores | :veterinary_services | :video_amusement_game_supplies | :video_game_arcades | :video_tape_rental_stores | :vocational_trade_schools | :watch_jewelry_repair | :welding_repair | :wholesale_clubs | :wig_and_toupee_stores | :wires_money_orders | :womens_accessory_and_specialty_shops | :womens_ready_to_wear_stores | :wrecking_and_salvage_yards ], optional(:blocked_categories) => [ :ac_refrigeration_repair | :accounting_bookkeeping_services | :advertising_services | :agricultural_cooperative | :airlines_air_carriers | :airports_flying_fields | :ambulance_services | :amusement_parks_carnivals | :antique_reproductions | :antique_shops | :aquariums | :architectural_surveying_services | :art_dealers_and_galleries | :artists_supply_and_craft_shops | :auto_and_home_supply_stores | :auto_body_repair_shops | :auto_paint_shops | :auto_service_shops | :automated_cash_disburse | :automated_fuel_dispensers | :automobile_associations | :automotive_parts_and_accessories_stores | :automotive_tire_stores | :bail_and_bond_payments | :bakeries | :bands_orchestras | :barber_and_beauty_shops | :betting_casino_gambling | :bicycle_shops | :billiard_pool_establishments | :boat_dealers | :boat_rentals_and_leases | :book_stores | :books_periodicals_and_newspapers | :bowling_alleys | :bus_lines | :business_secretarial_schools | :buying_shopping_services | :cable_satellite_and_other_pay_television_and_radio | :camera_and_photographic_supply_stores | :candy_nut_and_confectionery_stores | :car_and_truck_dealers_new_used | :car_and_truck_dealers_used_only | :car_rental_agencies | :car_washes | :carpentry_services | :carpet_upholstery_cleaning | :caterers | :charitable_and_social_service_organizations_fundraising | :chemicals_and_allied_products | :child_care_services | :childrens_and_infants_wear_stores | :chiropodists_podiatrists | :chiropractors | :cigar_stores_and_stands | :civic_social_fraternal_associations | :cleaning_and_maintenance | :clothing_rental | :colleges_universities | :commercial_equipment | :commercial_footwear | :commercial_photography_art_and_graphics | :commuter_transport_and_ferries | :computer_network_services | :computer_programming | :computer_repair | :computer_software_stores | :computers_peripherals_and_software | :concrete_work_services | :construction_materials | :consulting_public_relations | :correspondence_schools | :cosmetic_stores | :counseling_services | :country_clubs | :courier_services | :court_costs | :credit_reporting_agencies | :cruise_lines | :dairy_products_stores | :dance_hall_studios_schools | :dating_escort_services | :dentists_orthodontists | :department_stores | :detective_agencies | :digital_goods_applications | :digital_goods_games | :digital_goods_large_volume | :digital_goods_media | :direct_marketing_catalog_merchant | :direct_marketing_combination_catalog_and_retail_merchant | :direct_marketing_inbound_telemarketing | :direct_marketing_insurance_services | :direct_marketing_other | :direct_marketing_outbound_telemarketing | :direct_marketing_subscription | :direct_marketing_travel | :discount_stores | :doctors | :door_to_door_sales | :drapery_window_covering_and_upholstery_stores | :drinking_places | :drug_stores_and_pharmacies | :drugs_drug_proprietaries_and_druggist_sundries | :dry_cleaners | :durable_goods | :duty_free_stores | :eating_places_restaurants | :educational_services | :electric_razor_stores | :electrical_parts_and_equipment | :electrical_services | :electronics_repair_shops | :electronics_stores | :elementary_secondary_schools | :employment_temp_agencies | :equipment_rental | :exterminating_services | :family_clothing_stores | :fast_food_restaurants | :financial_institutions | :fines_government_administrative_entities | :fireplace_fireplace_screens_and_accessories_stores | :floor_covering_stores | :florists | :florists_supplies_nursery_stock_and_flowers | :freezer_and_locker_meat_provisioners | :fuel_dealers_non_automotive | :funeral_services_crematories | :furniture_home_furnishings_and_equipment_stores_except_appliances | :furniture_repair_refinishing | :furriers_and_fur_shops | :general_services | :gift_card_novelty_and_souvenir_shops | :glass_paint_and_wallpaper_stores | :glassware_crystal_stores | :golf_courses_public | :government_services | :grocery_stores_supermarkets | :hardware_equipment_and_supplies | :hardware_stores | :health_and_beauty_spas | :hearing_aids_sales_and_supplies | :heating_plumbing_a_c | :hobby_toy_and_game_shops | :home_supply_warehouse_stores | :hospitals | :hotels_motels_and_resorts | :household_appliance_stores | :industrial_supplies | :information_retrieval_services | :insurance_default | :insurance_underwriting_premiums | :intra_company_purchases | :jewelry_stores_watches_clocks_and_silverware_stores | :landscaping_services | :laundries | :laundry_cleaning_services | :legal_services_attorneys | :luggage_and_leather_goods_stores | :lumber_building_materials_stores | :manual_cash_disburse | :marinas_service_and_supplies | :masonry_stonework_and_plaster | :massage_parlors | :medical_and_dental_labs | :medical_dental_ophthalmic_and_hospital_equipment_and_supplies | :medical_services | :membership_organizations | :mens_and_boys_clothing_and_accessories_stores | :mens_womens_clothing_stores | :metal_service_centers | :miscellaneous | :miscellaneous_apparel_and_accessory_shops | :miscellaneous_auto_dealers | :miscellaneous_business_services | :miscellaneous_food_stores | :miscellaneous_general_merchandise | :miscellaneous_general_services | :miscellaneous_home_furnishing_specialty_stores | :miscellaneous_publishing_and_printing | :miscellaneous_recreation_services | :miscellaneous_repair_shops | :miscellaneous_specialty_retail | :mobile_home_dealers | :motion_picture_theaters | :motor_freight_carriers_and_trucking | :motor_homes_dealers | :motor_vehicle_supplies_and_new_parts | :motorcycle_shops_and_dealers | :motorcycle_shops_dealers | :music_stores_musical_instruments_pianos_and_sheet_music | :news_dealers_and_newsstands | :non_fi_money_orders | :non_fi_stored_value_card_purchase_load | :nondurable_goods | :nurseries_lawn_and_garden_supply_stores | :nursing_personal_care | :office_and_commercial_furniture | :opticians_eyeglasses | :optometrists_ophthalmologist | :orthopedic_goods_prosthetic_devices | :osteopaths | :package_stores_beer_wine_and_liquor | :paints_varnishes_and_supplies | :parking_lots_garages | :passenger_railways | :pawn_shops | :pet_shops_pet_food_and_supplies | :petroleum_and_petroleum_products | :photo_developing | :photographic_photocopy_microfilm_equipment_and_supplies | :photographic_studios | :picture_video_production | :piece_goods_notions_and_other_dry_goods | :plumbing_heating_equipment_and_supplies | :political_organizations | :postal_services_government_only | :precious_stones_and_metals_watches_and_jewelry | :professional_services | :public_warehousing_and_storage | :quick_copy_repro_and_blueprint | :railroads | :real_estate_agents_and_managers_rentals | :record_stores | :recreational_vehicle_rentals | :religious_goods_stores | :religious_organizations | :roofing_siding_sheet_metal | :secretarial_support_services | :security_brokers_dealers | :service_stations | :sewing_needlework_fabric_and_piece_goods_stores | :shoe_repair_hat_cleaning | :shoe_stores | :small_appliance_repair | :snowmobile_dealers | :special_trade_services | :specialty_cleaning | :sporting_goods_stores | :sporting_recreation_camps | :sports_and_riding_apparel_stores | :sports_clubs_fields | :stamp_and_coin_stores | :stationary_office_supplies_printing_and_writing_paper | :stationery_stores_office_and_school_supply_stores | :swimming_pools_sales | :t_ui_travel_germany | :tailors_alterations | :tax_payments_government_agencies | :tax_preparation_services | :taxicabs_limousines | :telecommunication_equipment_and_telephone_sales | :telecommunication_services | :telegraph_services | :tent_and_awning_shops | :testing_laboratories | :theatrical_ticket_agencies | :timeshares | :tire_retreading_and_repair | :tolls_bridge_fees | :tourist_attractions_and_exhibits | :towing_services | :trailer_parks_campgrounds | :transportation_services | :travel_agencies_tour_operators | :truck_stop_iteration | :truck_utility_trailer_rentals | :typesetting_plate_making_and_related_services | :typewriter_stores | :u_s_federal_government_agencies_or_departments | :uniforms_commercial_clothing | :used_merchandise_and_secondhand_stores | :utilities | :variety_stores | :veterinary_services | :video_amusement_game_supplies | :video_game_arcades | :video_tape_rental_stores | :vocational_trade_schools | :watch_jewelry_repair | :welding_repair | :wholesale_clubs | :wig_and_toupee_stores | :wires_money_orders | :womens_accessory_and_specialty_shops | :womens_ready_to_wear_stores | :wrecking_and_salvage_yards ], optional(:spending_limits) => [spending_limits()], optional(:spending_limits_currency) => binary() }
Rules that control spending across this cardholder's cards. Refer to our documentation for more details.
@type spending_limits() :: %{ optional(:amount) => integer(), optional(:categories) => [ :ac_refrigeration_repair | :accounting_bookkeeping_services | :advertising_services | :agricultural_cooperative | :airlines_air_carriers | :airports_flying_fields | :ambulance_services | :amusement_parks_carnivals | :antique_reproductions | :antique_shops | :aquariums | :architectural_surveying_services | :art_dealers_and_galleries | :artists_supply_and_craft_shops | :auto_and_home_supply_stores | :auto_body_repair_shops | :auto_paint_shops | :auto_service_shops | :automated_cash_disburse | :automated_fuel_dispensers | :automobile_associations | :automotive_parts_and_accessories_stores | :automotive_tire_stores | :bail_and_bond_payments | :bakeries | :bands_orchestras | :barber_and_beauty_shops | :betting_casino_gambling | :bicycle_shops | :billiard_pool_establishments | :boat_dealers | :boat_rentals_and_leases | :book_stores | :books_periodicals_and_newspapers | :bowling_alleys | :bus_lines | :business_secretarial_schools | :buying_shopping_services | :cable_satellite_and_other_pay_television_and_radio | :camera_and_photographic_supply_stores | :candy_nut_and_confectionery_stores | :car_and_truck_dealers_new_used | :car_and_truck_dealers_used_only | :car_rental_agencies | :car_washes | :carpentry_services | :carpet_upholstery_cleaning | :caterers | :charitable_and_social_service_organizations_fundraising | :chemicals_and_allied_products | :child_care_services | :childrens_and_infants_wear_stores | :chiropodists_podiatrists | :chiropractors | :cigar_stores_and_stands | :civic_social_fraternal_associations | :cleaning_and_maintenance | :clothing_rental | :colleges_universities | :commercial_equipment | :commercial_footwear | :commercial_photography_art_and_graphics | :commuter_transport_and_ferries | :computer_network_services | :computer_programming | :computer_repair | :computer_software_stores | :computers_peripherals_and_software | :concrete_work_services | :construction_materials | :consulting_public_relations | :correspondence_schools | :cosmetic_stores | :counseling_services | :country_clubs | :courier_services | :court_costs | :credit_reporting_agencies | :cruise_lines | :dairy_products_stores | :dance_hall_studios_schools | :dating_escort_services | :dentists_orthodontists | :department_stores | :detective_agencies | :digital_goods_applications | :digital_goods_games | :digital_goods_large_volume | :digital_goods_media | :direct_marketing_catalog_merchant | :direct_marketing_combination_catalog_and_retail_merchant | :direct_marketing_inbound_telemarketing | :direct_marketing_insurance_services | :direct_marketing_other | :direct_marketing_outbound_telemarketing | :direct_marketing_subscription | :direct_marketing_travel | :discount_stores | :doctors | :door_to_door_sales | :drapery_window_covering_and_upholstery_stores | :drinking_places | :drug_stores_and_pharmacies | :drugs_drug_proprietaries_and_druggist_sundries | :dry_cleaners | :durable_goods | :duty_free_stores | :eating_places_restaurants | :educational_services | :electric_razor_stores | :electrical_parts_and_equipment | :electrical_services | :electronics_repair_shops | :electronics_stores | :elementary_secondary_schools | :employment_temp_agencies | :equipment_rental | :exterminating_services | :family_clothing_stores | :fast_food_restaurants | :financial_institutions | :fines_government_administrative_entities | :fireplace_fireplace_screens_and_accessories_stores | :floor_covering_stores | :florists | :florists_supplies_nursery_stock_and_flowers | :freezer_and_locker_meat_provisioners | :fuel_dealers_non_automotive | :funeral_services_crematories | :furniture_home_furnishings_and_equipment_stores_except_appliances | :furniture_repair_refinishing | :furriers_and_fur_shops | :general_services | :gift_card_novelty_and_souvenir_shops | :glass_paint_and_wallpaper_stores | :glassware_crystal_stores | :golf_courses_public | :government_services | :grocery_stores_supermarkets | :hardware_equipment_and_supplies | :hardware_stores | :health_and_beauty_spas | :hearing_aids_sales_and_supplies | :heating_plumbing_a_c | :hobby_toy_and_game_shops | :home_supply_warehouse_stores | :hospitals | :hotels_motels_and_resorts | :household_appliance_stores | :industrial_supplies | :information_retrieval_services | :insurance_default | :insurance_underwriting_premiums | :intra_company_purchases | :jewelry_stores_watches_clocks_and_silverware_stores | :landscaping_services | :laundries | :laundry_cleaning_services | :legal_services_attorneys | :luggage_and_leather_goods_stores | :lumber_building_materials_stores | :manual_cash_disburse | :marinas_service_and_supplies | :masonry_stonework_and_plaster | :massage_parlors | :medical_and_dental_labs | :medical_dental_ophthalmic_and_hospital_equipment_and_supplies | :medical_services | :membership_organizations | :mens_and_boys_clothing_and_accessories_stores | :mens_womens_clothing_stores | :metal_service_centers | :miscellaneous | :miscellaneous_apparel_and_accessory_shops | :miscellaneous_auto_dealers | :miscellaneous_business_services | :miscellaneous_food_stores | :miscellaneous_general_merchandise | :miscellaneous_general_services | :miscellaneous_home_furnishing_specialty_stores | :miscellaneous_publishing_and_printing | :miscellaneous_recreation_services | :miscellaneous_repair_shops | :miscellaneous_specialty_retail | :mobile_home_dealers | :motion_picture_theaters | :motor_freight_carriers_and_trucking | :motor_homes_dealers | :motor_vehicle_supplies_and_new_parts | :motorcycle_shops_and_dealers | :motorcycle_shops_dealers | :music_stores_musical_instruments_pianos_and_sheet_music | :news_dealers_and_newsstands | :non_fi_money_orders | :non_fi_stored_value_card_purchase_load | :nondurable_goods | :nurseries_lawn_and_garden_supply_stores | :nursing_personal_care | :office_and_commercial_furniture | :opticians_eyeglasses | :optometrists_ophthalmologist | :orthopedic_goods_prosthetic_devices | :osteopaths | :package_stores_beer_wine_and_liquor | :paints_varnishes_and_supplies | :parking_lots_garages | :passenger_railways | :pawn_shops | :pet_shops_pet_food_and_supplies | :petroleum_and_petroleum_products | :photo_developing | :photographic_photocopy_microfilm_equipment_and_supplies | :photographic_studios | :picture_video_production | :piece_goods_notions_and_other_dry_goods | :plumbing_heating_equipment_and_supplies | :political_organizations | :postal_services_government_only | :precious_stones_and_metals_watches_and_jewelry | :professional_services | :public_warehousing_and_storage | :quick_copy_repro_and_blueprint | :railroads | :real_estate_agents_and_managers_rentals | :record_stores | :recreational_vehicle_rentals | :religious_goods_stores | :religious_organizations | :roofing_siding_sheet_metal | :secretarial_support_services | :security_brokers_dealers | :service_stations | :sewing_needlework_fabric_and_piece_goods_stores | :shoe_repair_hat_cleaning | :shoe_stores | :small_appliance_repair | :snowmobile_dealers | :special_trade_services | :specialty_cleaning | :sporting_goods_stores | :sporting_recreation_camps | :sports_and_riding_apparel_stores | :sports_clubs_fields | :stamp_and_coin_stores | :stationary_office_supplies_printing_and_writing_paper | :stationery_stores_office_and_school_supply_stores | :swimming_pools_sales | :t_ui_travel_germany | :tailors_alterations | :tax_payments_government_agencies | :tax_preparation_services | :taxicabs_limousines | :telecommunication_equipment_and_telephone_sales | :telecommunication_services | :telegraph_services | :tent_and_awning_shops | :testing_laboratories | :theatrical_ticket_agencies | :timeshares | :tire_retreading_and_repair | :tolls_bridge_fees | :tourist_attractions_and_exhibits | :towing_services | :trailer_parks_campgrounds | :transportation_services | :travel_agencies_tour_operators | :truck_stop_iteration | :truck_utility_trailer_rentals | :typesetting_plate_making_and_related_services | :typewriter_stores | :u_s_federal_government_agencies_or_departments | :uniforms_commercial_clothing | :used_merchandise_and_secondhand_stores | :utilities | :variety_stores | :veterinary_services | :video_amusement_game_supplies | :video_game_arcades | :video_tape_rental_stores | :vocational_trade_schools | :watch_jewelry_repair | :welding_repair | :wholesale_clubs | :wig_and_toupee_stores | :wires_money_orders | :womens_accessory_and_specialty_shops | :womens_ready_to_wear_stores | :wrecking_and_salvage_yards ], optional(:interval) => :all_time | :daily | :monthly | :per_authorization | :weekly | :yearly }
@type t() :: %Stripe.Issuing.Cardholder{ billing: term(), company: term() | nil, created: integer(), email: binary() | nil, id: binary(), individual: term() | nil, livemode: boolean(), metadata: term(), name: binary(), object: binary(), phone_number: binary() | nil, requirements: term(), spending_controls: term() | nil, status: binary(), type: binary() }
The issuing.cardholder
type.
billing
company
Additional information about acompany
cardholder.created
Time at which the object was created. Measured in seconds since the Unix epoch.email
The cardholder's email address.id
Unique identifier for the object.individual
Additional information about anindividual
cardholder.livemode
Has the valuetrue
if the object exists in live mode or the valuefalse
if the object exists in test mode.metadata
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.name
The cardholder's name. This will be printed on cards issued to them.object
String representing the object's type. Objects of the same type share the same value.phone_number
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.requirements
spending_controls
Rules that control spending across this cardholder's cards. Refer to our documentation for more details.status
Specifies whether to permit authorizations on this cardholder's cards.type
One ofindividual
orcompany
.
@type verification() :: %{optional(:document) => document()}
Government-issued ID document for this cardholder.
Link to this section Functions
@spec create( client :: Stripe.t(), params :: %{ optional(:billing) => billing(), optional(:company) => company(), optional(:email) => binary(), optional(:expand) => [binary()], optional(:individual) => individual(), optional(:metadata) => %{optional(binary()) => binary()}, optional(:name) => binary(), optional(:phone_number) => binary(), optional(:spending_controls) => spending_controls(), optional(:status) => :active | :inactive, optional(:type) => :company | :individual }, opts :: Keyword.t() ) :: {:ok, t()} | {:error, Stripe.ApiErrors.t()} | {:error, term()}
Creates a new Issuing Cardholder
object that can be issued cards.
Details
- Method:
post
- Path:
/v1/issuing/cardholders
@spec list( client :: Stripe.t(), params :: %{ optional(:created) => created() | integer(), optional(:email) => binary(), optional(:ending_before) => binary(), optional(:expand) => [binary()], optional(:limit) => integer(), optional(:phone_number) => binary(), optional(:starting_after) => binary(), optional(:status) => :active | :blocked | :inactive, optional(:type) => :company | :individual }, opts :: Keyword.t() ) :: {:ok, Stripe.List.t(t())} | {:error, Stripe.ApiErrors.t()} | {:error, term()}
Returns a list of Issuing Cardholder
objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
Details
- Method:
get
- Path:
/v1/issuing/cardholders
@spec retrieve( client :: Stripe.t(), cardholder :: binary(), params :: %{optional(:expand) => [binary()]}, opts :: Keyword.t() ) :: {:ok, t()} | {:error, Stripe.ApiErrors.t()} | {:error, term()}
Retrieves an Issuing Cardholder
object.
Details
- Method:
get
- Path:
/v1/issuing/cardholders/{cardholder}
@spec update( client :: Stripe.t(), cardholder :: binary(), params :: %{ optional(:billing) => billing(), optional(:company) => company(), optional(:email) => binary(), optional(:expand) => [binary()], optional(:individual) => individual(), optional(:metadata) => %{optional(binary()) => binary()}, optional(:phone_number) => binary(), optional(:spending_controls) => spending_controls(), optional(:status) => :active | :inactive }, opts :: Keyword.t() ) :: {:ok, t()} | {:error, Stripe.ApiErrors.t()} | {:error, term()}
Updates the specified Issuing Cardholder
object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
Details
- Method:
post
- Path:
/v1/issuing/cardholders/{cardholder}