stripe / stripe-python / 8238269632

coverage: 97.371% (-0.06%) from 97.433%
8238269632

Pull #1269

github

web-flow 
Merge 7f0ffdf54 into da0de819d
Pull Request #1269: Update generated code

889 of 1340 branches covered (66.34%)

Branch coverage included in aggregate %.

428 of 470 new or added lines in 14 files covered. (91.06%)

1 existing line in 1 file now uncovered.

55068 of 56128 relevant lines covered (98.11%)

0.98 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

95.15
/stripe/issuing/_card.py
1 
# -*- coding: utf-8 -*-
2 
# File generated from our OpenAPI spec
3 
from stripe._createable_api_resource import CreateableAPIResource
1✔
4 
from stripe._expandable_field import ExpandableField
1✔
5 
from stripe._list_object import ListObject
1✔
6 
from stripe._listable_api_resource import ListableAPIResource
1✔
7 
from stripe._request_options import RequestOptions
1✔
8 
from stripe._stripe_object import StripeObject
1✔
9 
from stripe._test_helpers import APIResourceTestHelpers
1✔
10 
from stripe._updateable_api_resource import UpdateableAPIResource
1✔
11 
from stripe._util import class_method_variant, sanitize_id
1✔
12 
from typing import ClassVar, Dict, List, Optional, cast, overload
1✔
13 
from typing_extensions import (
1✔
14 
    Literal,
15 
    NotRequired,
16 
    Type,
17 
    TypedDict,
18 
    Unpack,
19 
    TYPE_CHECKING,
20 
)
21 









22



if TYPE_CHECKING:





1!





23



    from stripe.issuing._cardholder import Cardholder




×








NEW


24



    from stripe.issuing._personalization_design import PersonalizationDesign




×







25












26












27



class Card(




1✔





28



    CreateableAPIResource["Card"],










29



    ListableAPIResource["Card"],










30



    UpdateableAPIResource["Card"],










31



):










32



    """










33



    You can [create physical or virtual cards](https://stripe.com/docs/issuing/cards) that are issued to cardholders.










34



    """










35












36



    OBJECT_NAME: ClassVar[Literal["issuing.card"]] = "issuing.card"




1✔





37












38



    class Shipping(StripeObject):




1✔





39



        class Address(StripeObject):




1✔





40



            city: Optional[str]




1✔





41



            """




1✔





42



            City, district, suburb, town, or village.










43



            """










44



            country: Optional[str]




1✔





45



            """




1✔





46



            Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).










47



            """










48



            line1: Optional[str]




1✔





49



            """




1✔





50



            Address line 1 (e.g., street, PO Box, or company name).










51



            """










52



            line2: Optional[str]




1✔





53



            """




1✔





54



            Address line 2 (e.g., apartment, suite, unit, or building).










55



            """










56



            postal_code: Optional[str]




1✔





57



            """




1✔





58



            ZIP or postal code.










59



            """










60



            state: Optional[str]




1✔





61



            """




1✔





62



            State, county, province, or region.










63



            """










64












65



        class Customs(StripeObject):




1✔





66



            eori_number: Optional[str]




1✔





67



            """




1✔





68



            A registration number used for customs in Europe. See [https://www.gov.uk/eori](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](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.










69



            """










70












71



        address: Address




1✔





72



        carrier: Optional[Literal["dhl", "fedex", "royal_mail", "usps"]]




1✔





73



        """




1✔





74



        The delivery company that shipped a card.










75



        """










76



        customs: Optional[Customs]




1✔





77



        """




1✔





78



        Additional information that may be required for clearing customs.










79



        """










80



        eta: Optional[int]




1✔





81



        """




1✔





82



        A unix timestamp representing a best estimate of when the card will be delivered.










83



        """










84



        name: str




1✔





85



        """




1✔





86



        Recipient name.










87



        """










88



        phone_number: Optional[str]




1✔





89



        """




1✔





90



        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.










91



        """










92



        require_signature: Optional[bool]




1✔





93



        """




1✔





94



        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.










95



        """










96



        service: Literal["express", "priority", "standard"]




1✔





97



        """




1✔





98



        Shipment service, such as `standard` or `express`.










99



        """










100



        status: Optional[




1✔





101



            Literal[










102



                "canceled",










103



                "delivered",










104



                "failure",










105



                "pending",










106



                "returned",










107



                "shipped",










108



            ]










109



        ]










110



        """




1✔





111



        The delivery status of the card.










112



        """










113



        tracking_number: Optional[str]




1✔





114



        """




1✔





115



        A tracking number for a card shipment.










116



        """










117



        tracking_url: Optional[str]




1✔





118



        """




1✔





119



        A link to the shipping carrier's site where you can view detailed information about a card shipment.










120



        """










121



        type: Literal["bulk", "individual"]




1✔





122



        """




1✔





123



        Packaging options.










124



        """










125



        _inner_class_types = {"address": Address, "customs": Customs}




1✔





126












127



    class SpendingControls(StripeObject):




1✔





128



        class SpendingLimit(StripeObject):




1✔





129



            amount: int




1✔





130



            """




1✔





131



            Maximum amount allowed to spend per interval. This amount is in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).










132



            """










133



            categories: Optional[




1✔





134



                List[










135



                    Literal[










136



                        "ac_refrigeration_repair",










137



                        "accounting_bookkeeping_services",










138



                        "advertising_services",










139



                        "agricultural_cooperative",










140



                        "airlines_air_carriers",










141



                        "airports_flying_fields",










142



                        "ambulance_services",










143



                        "amusement_parks_carnivals",










144



                        "antique_reproductions",










145



                        "antique_shops",










146



                        "aquariums",










147



                        "architectural_surveying_services",










148



                        "art_dealers_and_galleries",










149



                        "artists_supply_and_craft_shops",










150



                        "auto_and_home_supply_stores",










151



                        "auto_body_repair_shops",










152



                        "auto_paint_shops",










153



                        "auto_service_shops",










154



                        "automated_cash_disburse",










155



                        "automated_fuel_dispensers",










156



                        "automobile_associations",










157



                        "automotive_parts_and_accessories_stores",










158



                        "automotive_tire_stores",










159



                        "bail_and_bond_payments",










160



                        "bakeries",










161



                        "bands_orchestras",










162



                        "barber_and_beauty_shops",










163



                        "betting_casino_gambling",










164



                        "bicycle_shops",










165



                        "billiard_pool_establishments",










166



                        "boat_dealers",










167



                        "boat_rentals_and_leases",










168



                        "book_stores",










169



                        "books_periodicals_and_newspapers",










170



                        "bowling_alleys",










171



                        "bus_lines",










172



                        "business_secretarial_schools",










173



                        "buying_shopping_services",










174



                        "cable_satellite_and_other_pay_television_and_radio",










175



                        "camera_and_photographic_supply_stores",










176



                        "candy_nut_and_confectionery_stores",










177



                        "car_and_truck_dealers_new_used",










178



                        "car_and_truck_dealers_used_only",










179



                        "car_rental_agencies",










180



                        "car_washes",










181



                        "carpentry_services",










182



                        "carpet_upholstery_cleaning",










183



                        "caterers",










184



                        "charitable_and_social_service_organizations_fundraising",










185



                        "chemicals_and_allied_products",










186



                        "child_care_services",










187



                        "childrens_and_infants_wear_stores",










188



                        "chiropodists_podiatrists",










189



                        "chiropractors",










190



                        "cigar_stores_and_stands",










191



                        "civic_social_fraternal_associations",










192



                        "cleaning_and_maintenance",










193



                        "clothing_rental",










194



                        "colleges_universities",










195



                        "commercial_equipment",










196



                        "commercial_footwear",










197



                        "commercial_photography_art_and_graphics",










198



                        "commuter_transport_and_ferries",










199



                        "computer_network_services",










200



                        "computer_programming",










201



                        "computer_repair",










202



                        "computer_software_stores",










203



                        "computers_peripherals_and_software",










204



                        "concrete_work_services",










205



                        "construction_materials",










206



                        "consulting_public_relations",










207



                        "correspondence_schools",










208



                        "cosmetic_stores",










209



                        "counseling_services",










210



                        "country_clubs",










211



                        "courier_services",










212



                        "court_costs",










213



                        "credit_reporting_agencies",










214



                        "cruise_lines",










215



                        "dairy_products_stores",










216



                        "dance_hall_studios_schools",










217



                        "dating_escort_services",










218



                        "dentists_orthodontists",










219



                        "department_stores",










220



                        "detective_agencies",










221



                        "digital_goods_applications",










222



                        "digital_goods_games",










223



                        "digital_goods_large_volume",










224



                        "digital_goods_media",










225



                        "direct_marketing_catalog_merchant",










226



                        "direct_marketing_combination_catalog_and_retail_merchant",










227



                        "direct_marketing_inbound_telemarketing",










228



                        "direct_marketing_insurance_services",










229



                        "direct_marketing_other",










230



                        "direct_marketing_outbound_telemarketing",










231



                        "direct_marketing_subscription",










232



                        "direct_marketing_travel",










233



                        "discount_stores",










234



                        "doctors",










235



                        "door_to_door_sales",










236



                        "drapery_window_covering_and_upholstery_stores",










237



                        "drinking_places",










238



                        "drug_stores_and_pharmacies",










239



                        "drugs_drug_proprietaries_and_druggist_sundries",










240



                        "dry_cleaners",










241



                        "durable_goods",










242



                        "duty_free_stores",










243



                        "eating_places_restaurants",










244



                        "educational_services",










245



                        "electric_razor_stores",










246



                        "electric_vehicle_charging",










247



                        "electrical_parts_and_equipment",










248



                        "electrical_services",










249



                        "electronics_repair_shops",










250



                        "electronics_stores",










251



                        "elementary_secondary_schools",










252



                        "emergency_services_gcas_visa_use_only",










253



                        "employment_temp_agencies",










254



                        "equipment_rental",










255



                        "exterminating_services",










256



                        "family_clothing_stores",










257



                        "fast_food_restaurants",










258



                        "financial_institutions",










259



                        "fines_government_administrative_entities",










260



                        "fireplace_fireplace_screens_and_accessories_stores",










261



                        "floor_covering_stores",










262



                        "florists",










263



                        "florists_supplies_nursery_stock_and_flowers",










264



                        "freezer_and_locker_meat_provisioners",










265



                        "fuel_dealers_non_automotive",










266



                        "funeral_services_crematories",










267



                        "furniture_home_furnishings_and_equipment_stores_except_appliances",










268



                        "furniture_repair_refinishing",










269



                        "furriers_and_fur_shops",










270



                        "general_services",










271



                        "gift_card_novelty_and_souvenir_shops",










272



                        "glass_paint_and_wallpaper_stores",










273



                        "glassware_crystal_stores",










274



                        "golf_courses_public",










275



                        "government_licensed_horse_dog_racing_us_region_only",










276



                        "government_licensed_online_casions_online_gambling_us_region_only",










277



                        "government_owned_lotteries_non_us_region",










278



                        "government_owned_lotteries_us_region_only",










279



                        "government_services",










280



                        "grocery_stores_supermarkets",










281



                        "hardware_equipment_and_supplies",










282



                        "hardware_stores",










283



                        "health_and_beauty_spas",










284



                        "hearing_aids_sales_and_supplies",










285



                        "heating_plumbing_a_c",










286



                        "hobby_toy_and_game_shops",










287



                        "home_supply_warehouse_stores",










288



                        "hospitals",










289



                        "hotels_motels_and_resorts",










290



                        "household_appliance_stores",










291



                        "industrial_supplies",










292



                        "information_retrieval_services",










293



                        "insurance_default",










294



                        "insurance_underwriting_premiums",










295



                        "intra_company_purchases",










296



                        "jewelry_stores_watches_clocks_and_silverware_stores",










297



                        "landscaping_services",










298



                        "laundries",










299



                        "laundry_cleaning_services",










300



                        "legal_services_attorneys",










301



                        "luggage_and_leather_goods_stores",










302



                        "lumber_building_materials_stores",










303



                        "manual_cash_disburse",










304



                        "marinas_service_and_supplies",










305



                        "marketplaces",










306



                        "masonry_stonework_and_plaster",










307



                        "massage_parlors",










308



                        "medical_and_dental_labs",










309



                        "medical_dental_ophthalmic_and_hospital_equipment_and_supplies",










310



                        "medical_services",










311



                        "membership_organizations",










312



                        "mens_and_boys_clothing_and_accessories_stores",










313



                        "mens_womens_clothing_stores",










314



                        "metal_service_centers",










315



                        "miscellaneous",










316



                        "miscellaneous_apparel_and_accessory_shops",










317



                        "miscellaneous_auto_dealers",










318



                        "miscellaneous_business_services",










319



                        "miscellaneous_food_stores",










320



                        "miscellaneous_general_merchandise",










321



                        "miscellaneous_general_services",










322



                        "miscellaneous_home_furnishing_specialty_stores",










323



                        "miscellaneous_publishing_and_printing",










324



                        "miscellaneous_recreation_services",










325



                        "miscellaneous_repair_shops",










326



                        "miscellaneous_specialty_retail",










327



                        "mobile_home_dealers",










328



                        "motion_picture_theaters",










329



                        "motor_freight_carriers_and_trucking",










330



                        "motor_homes_dealers",










331



                        "motor_vehicle_supplies_and_new_parts",










332



                        "motorcycle_shops_and_dealers",










333



                        "motorcycle_shops_dealers",










334



                        "music_stores_musical_instruments_pianos_and_sheet_music",










335



                        "news_dealers_and_newsstands",










336



                        "non_fi_money_orders",










337



                        "non_fi_stored_value_card_purchase_load",










338



                        "nondurable_goods",










339



                        "nurseries_lawn_and_garden_supply_stores",










340



                        "nursing_personal_care",










341



                        "office_and_commercial_furniture",










342



                        "opticians_eyeglasses",










343



                        "optometrists_ophthalmologist",










344



                        "orthopedic_goods_prosthetic_devices",










345



                        "osteopaths",










346



                        "package_stores_beer_wine_and_liquor",










347



                        "paints_varnishes_and_supplies",










348



                        "parking_lots_garages",










349



                        "passenger_railways",










350



                        "pawn_shops",










351



                        "pet_shops_pet_food_and_supplies",










352



                        "petroleum_and_petroleum_products",










353



                        "photo_developing",










354



                        "photographic_photocopy_microfilm_equipment_and_supplies",










355



                        "photographic_studios",










356



                        "picture_video_production",










357



                        "piece_goods_notions_and_other_dry_goods",










358



                        "plumbing_heating_equipment_and_supplies",










359



                        "political_organizations",










360



                        "postal_services_government_only",










361



                        "precious_stones_and_metals_watches_and_jewelry",










362



                        "professional_services",










363



                        "public_warehousing_and_storage",










364



                        "quick_copy_repro_and_blueprint",










365



                        "railroads",










366



                        "real_estate_agents_and_managers_rentals",










367



                        "record_stores",










368



                        "recreational_vehicle_rentals",










369



                        "religious_goods_stores",










370



                        "religious_organizations",










371



                        "roofing_siding_sheet_metal",










372



                        "secretarial_support_services",










373



                        "security_brokers_dealers",










374



                        "service_stations",










375



                        "sewing_needlework_fabric_and_piece_goods_stores",










376



                        "shoe_repair_hat_cleaning",










377



                        "shoe_stores",










378



                        "small_appliance_repair",










379



                        "snowmobile_dealers",










380



                        "special_trade_services",










381



                        "specialty_cleaning",










382



                        "sporting_goods_stores",










383



                        "sporting_recreation_camps",










384



                        "sports_and_riding_apparel_stores",










385



                        "sports_clubs_fields",










386



                        "stamp_and_coin_stores",










387



                        "stationary_office_supplies_printing_and_writing_paper",










388



                        "stationery_stores_office_and_school_supply_stores",










389



                        "swimming_pools_sales",










390



                        "t_ui_travel_germany",










391



                        "tailors_alterations",










392



                        "tax_payments_government_agencies",










393



                        "tax_preparation_services",










394



                        "taxicabs_limousines",










395



                        "telecommunication_equipment_and_telephone_sales",










396



                        "telecommunication_services",










397



                        "telegraph_services",










398



                        "tent_and_awning_shops",










399



                        "testing_laboratories",










400



                        "theatrical_ticket_agencies",










401



                        "timeshares",










402



                        "tire_retreading_and_repair",










403



                        "tolls_bridge_fees",










404



                        "tourist_attractions_and_exhibits",










405



                        "towing_services",










406



                        "trailer_parks_campgrounds",










407



                        "transportation_services",










408



                        "travel_agencies_tour_operators",










409



                        "truck_stop_iteration",










410



                        "truck_utility_trailer_rentals",










411



                        "typesetting_plate_making_and_related_services",










412



                        "typewriter_stores",










413



                        "u_s_federal_government_agencies_or_departments",










414



                        "uniforms_commercial_clothing",










415



                        "used_merchandise_and_secondhand_stores",










416



                        "utilities",










417



                        "variety_stores",










418



                        "veterinary_services",










419



                        "video_amusement_game_supplies",










420



                        "video_game_arcades",










421



                        "video_tape_rental_stores",










422



                        "vocational_trade_schools",










423



                        "watch_jewelry_repair",










424



                        "welding_repair",










425



                        "wholesale_clubs",










426



                        "wig_and_toupee_stores",










427



                        "wires_money_orders",










428



                        "womens_accessory_and_specialty_shops",










429



                        "womens_ready_to_wear_stores",










430



                        "wrecking_and_salvage_yards",










431



                    ]










432



                ]










433



            ]










434



            """




1✔





435



            Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.










436



            """










437



            interval: Literal[




1✔





438



                "all_time",










439



                "daily",










440



                "monthly",










441



                "per_authorization",










442



                "weekly",










443



                "yearly",










444



            ]










445



            """




1✔





446



            Interval (or event) to which the amount applies.










447



            """










448












449



        allowed_categories: Optional[




1✔





450



            List[










451



                Literal[










452



                    "ac_refrigeration_repair",










453



                    "accounting_bookkeeping_services",










454



                    "advertising_services",










455



                    "agricultural_cooperative",










456



                    "airlines_air_carriers",










457



                    "airports_flying_fields",










458



                    "ambulance_services",










459



                    "amusement_parks_carnivals",










460



                    "antique_reproductions",










461



                    "antique_shops",










462



                    "aquariums",










463



                    "architectural_surveying_services",










464



                    "art_dealers_and_galleries",










465



                    "artists_supply_and_craft_shops",










466



                    "auto_and_home_supply_stores",










467



                    "auto_body_repair_shops",










468



                    "auto_paint_shops",










469



                    "auto_service_shops",










470



                    "automated_cash_disburse",










471



                    "automated_fuel_dispensers",










472



                    "automobile_associations",










473



                    "automotive_parts_and_accessories_stores",










474



                    "automotive_tire_stores",










475



                    "bail_and_bond_payments",










476



                    "bakeries",










477



                    "bands_orchestras",










478



                    "barber_and_beauty_shops",










479



                    "betting_casino_gambling",










480



                    "bicycle_shops",










481



                    "billiard_pool_establishments",










482



                    "boat_dealers",










483



                    "boat_rentals_and_leases",










484



                    "book_stores",










485



                    "books_periodicals_and_newspapers",










486



                    "bowling_alleys",










487



                    "bus_lines",










488



                    "business_secretarial_schools",










489



                    "buying_shopping_services",










490



                    "cable_satellite_and_other_pay_television_and_radio",










491



                    "camera_and_photographic_supply_stores",










492



                    "candy_nut_and_confectionery_stores",










493



                    "car_and_truck_dealers_new_used",










494



                    "car_and_truck_dealers_used_only",










495



                    "car_rental_agencies",










496



                    "car_washes",










497



                    "carpentry_services",










498



                    "carpet_upholstery_cleaning",










499



                    "caterers",










500



                    "charitable_and_social_service_organizations_fundraising",










501



                    "chemicals_and_allied_products",










502



                    "child_care_services",










503



                    "childrens_and_infants_wear_stores",










504



                    "chiropodists_podiatrists",










505



                    "chiropractors",










506



                    "cigar_stores_and_stands",










507



                    "civic_social_fraternal_associations",










508



                    "cleaning_and_maintenance",










509



                    "clothing_rental",










510



                    "colleges_universities",










511



                    "commercial_equipment",










512



                    "commercial_footwear",










513



                    "commercial_photography_art_and_graphics",










514



                    "commuter_transport_and_ferries",










515



                    "computer_network_services",










516



                    "computer_programming",










517



                    "computer_repair",










518



                    "computer_software_stores",










519



                    "computers_peripherals_and_software",










520



                    "concrete_work_services",










521



                    "construction_materials",










522



                    "consulting_public_relations",










523



                    "correspondence_schools",










524



                    "cosmetic_stores",










525



                    "counseling_services",










526



                    "country_clubs",










527



                    "courier_services",










528



                    "court_costs",










529



                    "credit_reporting_agencies",










530



                    "cruise_lines",










531



                    "dairy_products_stores",










532



                    "dance_hall_studios_schools",










533



                    "dating_escort_services",










534



                    "dentists_orthodontists",










535



                    "department_stores",










536



                    "detective_agencies",










537



                    "digital_goods_applications",










538



                    "digital_goods_games",










539



                    "digital_goods_large_volume",










540



                    "digital_goods_media",










541



                    "direct_marketing_catalog_merchant",










542



                    "direct_marketing_combination_catalog_and_retail_merchant",










543



                    "direct_marketing_inbound_telemarketing",










544



                    "direct_marketing_insurance_services",










545



                    "direct_marketing_other",










546



                    "direct_marketing_outbound_telemarketing",










547



                    "direct_marketing_subscription",










548



                    "direct_marketing_travel",










549



                    "discount_stores",










550



                    "doctors",










551



                    "door_to_door_sales",










552



                    "drapery_window_covering_and_upholstery_stores",










553



                    "drinking_places",










554



                    "drug_stores_and_pharmacies",










555



                    "drugs_drug_proprietaries_and_druggist_sundries",










556



                    "dry_cleaners",










557



                    "durable_goods",










558



                    "duty_free_stores",










559



                    "eating_places_restaurants",










560



                    "educational_services",










561



                    "electric_razor_stores",










562



                    "electric_vehicle_charging",










563



                    "electrical_parts_and_equipment",










564



                    "electrical_services",










565



                    "electronics_repair_shops",










566



                    "electronics_stores",










567



                    "elementary_secondary_schools",










568



                    "emergency_services_gcas_visa_use_only",










569



                    "employment_temp_agencies",










570



                    "equipment_rental",










571



                    "exterminating_services",










572



                    "family_clothing_stores",










573



                    "fast_food_restaurants",










574



                    "financial_institutions",










575



                    "fines_government_administrative_entities",










576



                    "fireplace_fireplace_screens_and_accessories_stores",










577



                    "floor_covering_stores",










578



                    "florists",










579



                    "florists_supplies_nursery_stock_and_flowers",










580



                    "freezer_and_locker_meat_provisioners",










581



                    "fuel_dealers_non_automotive",










582



                    "funeral_services_crematories",










583



                    "furniture_home_furnishings_and_equipment_stores_except_appliances",










584



                    "furniture_repair_refinishing",










585



                    "furriers_and_fur_shops",










586



                    "general_services",










587



                    "gift_card_novelty_and_souvenir_shops",










588



                    "glass_paint_and_wallpaper_stores",










589



                    "glassware_crystal_stores",










590



                    "golf_courses_public",










591



                    "government_licensed_horse_dog_racing_us_region_only",










592



                    "government_licensed_online_casions_online_gambling_us_region_only",










593



                    "government_owned_lotteries_non_us_region",










594



                    "government_owned_lotteries_us_region_only",










595



                    "government_services",










596



                    "grocery_stores_supermarkets",










597



                    "hardware_equipment_and_supplies",










598



                    "hardware_stores",










599



                    "health_and_beauty_spas",










600



                    "hearing_aids_sales_and_supplies",










601



                    "heating_plumbing_a_c",










602



                    "hobby_toy_and_game_shops",










603



                    "home_supply_warehouse_stores",










604



                    "hospitals",










605



                    "hotels_motels_and_resorts",










606



                    "household_appliance_stores",










607



                    "industrial_supplies",










608



                    "information_retrieval_services",










609



                    "insurance_default",










610



                    "insurance_underwriting_premiums",










611



                    "intra_company_purchases",










612



                    "jewelry_stores_watches_clocks_and_silverware_stores",










613



                    "landscaping_services",










614



                    "laundries",










615



                    "laundry_cleaning_services",










616



                    "legal_services_attorneys",










617



                    "luggage_and_leather_goods_stores",










618



                    "lumber_building_materials_stores",










619



                    "manual_cash_disburse",










620



                    "marinas_service_and_supplies",










621



                    "marketplaces",










622



                    "masonry_stonework_and_plaster",










623



                    "massage_parlors",










624



                    "medical_and_dental_labs",










625



                    "medical_dental_ophthalmic_and_hospital_equipment_and_supplies",










626



                    "medical_services",










627



                    "membership_organizations",










628



                    "mens_and_boys_clothing_and_accessories_stores",










629



                    "mens_womens_clothing_stores",










630



                    "metal_service_centers",










631



                    "miscellaneous",










632



                    "miscellaneous_apparel_and_accessory_shops",










633



                    "miscellaneous_auto_dealers",










634



                    "miscellaneous_business_services",










635



                    "miscellaneous_food_stores",










636



                    "miscellaneous_general_merchandise",










637



                    "miscellaneous_general_services",










638



                    "miscellaneous_home_furnishing_specialty_stores",










639



                    "miscellaneous_publishing_and_printing",










640



                    "miscellaneous_recreation_services",










641



                    "miscellaneous_repair_shops",










642



                    "miscellaneous_specialty_retail",










643



                    "mobile_home_dealers",










644



                    "motion_picture_theaters",










645



                    "motor_freight_carriers_and_trucking",










646



                    "motor_homes_dealers",










647



                    "motor_vehicle_supplies_and_new_parts",










648



                    "motorcycle_shops_and_dealers",










649



                    "motorcycle_shops_dealers",










650



                    "music_stores_musical_instruments_pianos_and_sheet_music",










651



                    "news_dealers_and_newsstands",










652



                    "non_fi_money_orders",










653



                    "non_fi_stored_value_card_purchase_load",










654



                    "nondurable_goods",










655



                    "nurseries_lawn_and_garden_supply_stores",










656



                    "nursing_personal_care",










657



                    "office_and_commercial_furniture",










658



                    "opticians_eyeglasses",










659



                    "optometrists_ophthalmologist",










660



                    "orthopedic_goods_prosthetic_devices",










661



                    "osteopaths",










662



                    "package_stores_beer_wine_and_liquor",










663



                    "paints_varnishes_and_supplies",










664



                    "parking_lots_garages",










665



                    "passenger_railways",










666



                    "pawn_shops",










667



                    "pet_shops_pet_food_and_supplies",










668



                    "petroleum_and_petroleum_products",










669



                    "photo_developing",










670



                    "photographic_photocopy_microfilm_equipment_and_supplies",










671



                    "photographic_studios",










672



                    "picture_video_production",










673



                    "piece_goods_notions_and_other_dry_goods",










674



                    "plumbing_heating_equipment_and_supplies",










675



                    "political_organizations",










676



                    "postal_services_government_only",










677



                    "precious_stones_and_metals_watches_and_jewelry",










678



                    "professional_services",










679



                    "public_warehousing_and_storage",










680



                    "quick_copy_repro_and_blueprint",










681



                    "railroads",










682



                    "real_estate_agents_and_managers_rentals",










683



                    "record_stores",










684



                    "recreational_vehicle_rentals",










685



                    "religious_goods_stores",










686



                    "religious_organizations",










687



                    "roofing_siding_sheet_metal",










688



                    "secretarial_support_services",










689



                    "security_brokers_dealers",










690



                    "service_stations",










691



                    "sewing_needlework_fabric_and_piece_goods_stores",










692



                    "shoe_repair_hat_cleaning",










693



                    "shoe_stores",










694



                    "small_appliance_repair",










695



                    "snowmobile_dealers",










696



                    "special_trade_services",










697



                    "specialty_cleaning",










698



                    "sporting_goods_stores",










699



                    "sporting_recreation_camps",










700



                    "sports_and_riding_apparel_stores",










701



                    "sports_clubs_fields",










702



                    "stamp_and_coin_stores",










703



                    "stationary_office_supplies_printing_and_writing_paper",










704



                    "stationery_stores_office_and_school_supply_stores",










705



                    "swimming_pools_sales",










706



                    "t_ui_travel_germany",










707



                    "tailors_alterations",










708



                    "tax_payments_government_agencies",










709



                    "tax_preparation_services",










710



                    "taxicabs_limousines",










711



                    "telecommunication_equipment_and_telephone_sales",










712



                    "telecommunication_services",










713



                    "telegraph_services",










714



                    "tent_and_awning_shops",










715



                    "testing_laboratories",










716



                    "theatrical_ticket_agencies",










717



                    "timeshares",










718



                    "tire_retreading_and_repair",










719



                    "tolls_bridge_fees",










720



                    "tourist_attractions_and_exhibits",










721



                    "towing_services",










722



                    "trailer_parks_campgrounds",










723



                    "transportation_services",










724



                    "travel_agencies_tour_operators",










725



                    "truck_stop_iteration",










726



                    "truck_utility_trailer_rentals",










727



                    "typesetting_plate_making_and_related_services",










728



                    "typewriter_stores",










729



                    "u_s_federal_government_agencies_or_departments",










730



                    "uniforms_commercial_clothing",










731



                    "used_merchandise_and_secondhand_stores",










732



                    "utilities",










733



                    "variety_stores",










734



                    "veterinary_services",










735



                    "video_amusement_game_supplies",










736



                    "video_game_arcades",










737



                    "video_tape_rental_stores",










738



                    "vocational_trade_schools",










739



                    "watch_jewelry_repair",










740



                    "welding_repair",










741



                    "wholesale_clubs",










742



                    "wig_and_toupee_stores",










743



                    "wires_money_orders",










744



                    "womens_accessory_and_specialty_shops",










745



                    "womens_ready_to_wear_stores",










746



                    "wrecking_and_salvage_yards",










747



                ]










748



            ]










749



        ]










750



        """




1✔





751



        Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.










752



        """










753



        blocked_categories: Optional[




1✔





754



            List[










755



                Literal[










756



                    "ac_refrigeration_repair",










757



                    "accounting_bookkeeping_services",










758



                    "advertising_services",










759



                    "agricultural_cooperative",










760



                    "airlines_air_carriers",










761



                    "airports_flying_fields",










762



                    "ambulance_services",










763



                    "amusement_parks_carnivals",










764



                    "antique_reproductions",










765



                    "antique_shops",










766



                    "aquariums",










767



                    "architectural_surveying_services",










768



                    "art_dealers_and_galleries",










769



                    "artists_supply_and_craft_shops",










770



                    "auto_and_home_supply_stores",










771



                    "auto_body_repair_shops",










772



                    "auto_paint_shops",










773



                    "auto_service_shops",










774



                    "automated_cash_disburse",










775



                    "automated_fuel_dispensers",










776



                    "automobile_associations",










777



                    "automotive_parts_and_accessories_stores",










778



                    "automotive_tire_stores",










779



                    "bail_and_bond_payments",










780



                    "bakeries",










781



                    "bands_orchestras",










782



                    "barber_and_beauty_shops",










783



                    "betting_casino_gambling",










784



                    "bicycle_shops",










785



                    "billiard_pool_establishments",










786



                    "boat_dealers",










787



                    "boat_rentals_and_leases",










788



                    "book_stores",










789



                    "books_periodicals_and_newspapers",










790



                    "bowling_alleys",










791



                    "bus_lines",










792



                    "business_secretarial_schools",










793



                    "buying_shopping_services",










794



                    "cable_satellite_and_other_pay_television_and_radio",










795



                    "camera_and_photographic_supply_stores",










796



                    "candy_nut_and_confectionery_stores",










797



                    "car_and_truck_dealers_new_used",










798



                    "car_and_truck_dealers_used_only",










799



                    "car_rental_agencies",










800



                    "car_washes",










801



                    "carpentry_services",










802



                    "carpet_upholstery_cleaning",










803



                    "caterers",










804



                    "charitable_and_social_service_organizations_fundraising",










805



                    "chemicals_and_allied_products",










806



                    "child_care_services",










807



                    "childrens_and_infants_wear_stores",










808



                    "chiropodists_podiatrists",










809



                    "chiropractors",










810



                    "cigar_stores_and_stands",










811



                    "civic_social_fraternal_associations",










812



                    "cleaning_and_maintenance",










813



                    "clothing_rental",










814



                    "colleges_universities",










815



                    "commercial_equipment",










816



                    "commercial_footwear",










817



                    "commercial_photography_art_and_graphics",










818



                    "commuter_transport_and_ferries",










819



                    "computer_network_services",










820



                    "computer_programming",










821



                    "computer_repair",










822



                    "computer_software_stores",










823



                    "computers_peripherals_and_software",










824



                    "concrete_work_services",










825



                    "construction_materials",










826



                    "consulting_public_relations",










827



                    "correspondence_schools",










828



                    "cosmetic_stores",










829



                    "counseling_services",










830



                    "country_clubs",










831



                    "courier_services",










832



                    "court_costs",










833



                    "credit_reporting_agencies",










834



                    "cruise_lines",










835



                    "dairy_products_stores",










836



                    "dance_hall_studios_schools",










837



                    "dating_escort_services",










838



                    "dentists_orthodontists",










839



                    "department_stores",










840



                    "detective_agencies",










841



                    "digital_goods_applications",










842



                    "digital_goods_games",










843



                    "digital_goods_large_volume",










844



                    "digital_goods_media",










845



                    "direct_marketing_catalog_merchant",










846



                    "direct_marketing_combination_catalog_and_retail_merchant",










847



                    "direct_marketing_inbound_telemarketing",










848



                    "direct_marketing_insurance_services",










849



                    "direct_marketing_other",










850



                    "direct_marketing_outbound_telemarketing",










851



                    "direct_marketing_subscription",










852



                    "direct_marketing_travel",










853



                    "discount_stores",










854



                    "doctors",










855



                    "door_to_door_sales",










856



                    "drapery_window_covering_and_upholstery_stores",










857



                    "drinking_places",










858



                    "drug_stores_and_pharmacies",










859



                    "drugs_drug_proprietaries_and_druggist_sundries",










860



                    "dry_cleaners",










861



                    "durable_goods",










862



                    "duty_free_stores",










863



                    "eating_places_restaurants",










864



                    "educational_services",










865



                    "electric_razor_stores",










866



                    "electric_vehicle_charging",










867



                    "electrical_parts_and_equipment",










868



                    "electrical_services",










869



                    "electronics_repair_shops",










870



                    "electronics_stores",










871



                    "elementary_secondary_schools",










872



                    "emergency_services_gcas_visa_use_only",










873



                    "employment_temp_agencies",










874



                    "equipment_rental",










875



                    "exterminating_services",










876



                    "family_clothing_stores",










877



                    "fast_food_restaurants",










878



                    "financial_institutions",










879



                    "fines_government_administrative_entities",










880



                    "fireplace_fireplace_screens_and_accessories_stores",










881



                    "floor_covering_stores",










882



                    "florists",










883



                    "florists_supplies_nursery_stock_and_flowers",










884



                    "freezer_and_locker_meat_provisioners",










885



                    "fuel_dealers_non_automotive",










886



                    "funeral_services_crematories",










887



                    "furniture_home_furnishings_and_equipment_stores_except_appliances",










888



                    "furniture_repair_refinishing",










889



                    "furriers_and_fur_shops",










890



                    "general_services",










891



                    "gift_card_novelty_and_souvenir_shops",










892



                    "glass_paint_and_wallpaper_stores",










893



                    "glassware_crystal_stores",










894



                    "golf_courses_public",










895



                    "government_licensed_horse_dog_racing_us_region_only",










896



                    "government_licensed_online_casions_online_gambling_us_region_only",










897



                    "government_owned_lotteries_non_us_region",










898



                    "government_owned_lotteries_us_region_only",










899



                    "government_services",










900



                    "grocery_stores_supermarkets",










901



                    "hardware_equipment_and_supplies",










902



                    "hardware_stores",










903



                    "health_and_beauty_spas",










904



                    "hearing_aids_sales_and_supplies",










905



                    "heating_plumbing_a_c",










906



                    "hobby_toy_and_game_shops",










907



                    "home_supply_warehouse_stores",










908



                    "hospitals",










909



                    "hotels_motels_and_resorts",










910



                    "household_appliance_stores",










911



                    "industrial_supplies",










912



                    "information_retrieval_services",










913



                    "insurance_default",










914



                    "insurance_underwriting_premiums",










915



                    "intra_company_purchases",










916



                    "jewelry_stores_watches_clocks_and_silverware_stores",










917



                    "landscaping_services",










918



                    "laundries",










919



                    "laundry_cleaning_services",










920



                    "legal_services_attorneys",










921



                    "luggage_and_leather_goods_stores",










922



                    "lumber_building_materials_stores",










923



                    "manual_cash_disburse",










924



                    "marinas_service_and_supplies",










925



                    "marketplaces",










926



                    "masonry_stonework_and_plaster",










927



                    "massage_parlors",










928



                    "medical_and_dental_labs",










929



                    "medical_dental_ophthalmic_and_hospital_equipment_and_supplies",










930



                    "medical_services",










931



                    "membership_organizations",










932



                    "mens_and_boys_clothing_and_accessories_stores",










933



                    "mens_womens_clothing_stores",










934



                    "metal_service_centers",










935



                    "miscellaneous",










936



                    "miscellaneous_apparel_and_accessory_shops",










937



                    "miscellaneous_auto_dealers",










938



                    "miscellaneous_business_services",










939



                    "miscellaneous_food_stores",










940



                    "miscellaneous_general_merchandise",










941



                    "miscellaneous_general_services",










942



                    "miscellaneous_home_furnishing_specialty_stores",










943



                    "miscellaneous_publishing_and_printing",










944



                    "miscellaneous_recreation_services",










945



                    "miscellaneous_repair_shops",










946



                    "miscellaneous_specialty_retail",










947



                    "mobile_home_dealers",










948



                    "motion_picture_theaters",










949



                    "motor_freight_carriers_and_trucking",










950



                    "motor_homes_dealers",










951



                    "motor_vehicle_supplies_and_new_parts",










952



                    "motorcycle_shops_and_dealers",










953



                    "motorcycle_shops_dealers",










954



                    "music_stores_musical_instruments_pianos_and_sheet_music",










955



                    "news_dealers_and_newsstands",










956



                    "non_fi_money_orders",










957



                    "non_fi_stored_value_card_purchase_load",










958



                    "nondurable_goods",










959



                    "nurseries_lawn_and_garden_supply_stores",










960



                    "nursing_personal_care",










961



                    "office_and_commercial_furniture",










962



                    "opticians_eyeglasses",










963



                    "optometrists_ophthalmologist",










964



                    "orthopedic_goods_prosthetic_devices",










965



                    "osteopaths",










966



                    "package_stores_beer_wine_and_liquor",










967



                    "paints_varnishes_and_supplies",










968



                    "parking_lots_garages",










969



                    "passenger_railways",










970



                    "pawn_shops",










971



                    "pet_shops_pet_food_and_supplies",










972



                    "petroleum_and_petroleum_products",










973



                    "photo_developing",










974



                    "photographic_photocopy_microfilm_equipment_and_supplies",










975



                    "photographic_studios",










976



                    "picture_video_production",










977



                    "piece_goods_notions_and_other_dry_goods",










978



                    "plumbing_heating_equipment_and_supplies",










979



                    "political_organizations",










980



                    "postal_services_government_only",










981



                    "precious_stones_and_metals_watches_and_jewelry",










982



                    "professional_services",










983



                    "public_warehousing_and_storage",










984



                    "quick_copy_repro_and_blueprint",










985



                    "railroads",










986



                    "real_estate_agents_and_managers_rentals",










987



                    "record_stores",










988



                    "recreational_vehicle_rentals",










989



                    "religious_goods_stores",










990



                    "religious_organizations",










991



                    "roofing_siding_sheet_metal",










992



                    "secretarial_support_services",










993



                    "security_brokers_dealers",










994



                    "service_stations",










995



                    "sewing_needlework_fabric_and_piece_goods_stores",










996



                    "shoe_repair_hat_cleaning",










997



                    "shoe_stores",










998



                    "small_appliance_repair",










999



                    "snowmobile_dealers",










1000



                    "special_trade_services",










1001



                    "specialty_cleaning",










1002



                    "sporting_goods_stores",










1003



                    "sporting_recreation_camps",










1004



                    "sports_and_riding_apparel_stores",










1005



                    "sports_clubs_fields",










1006



                    "stamp_and_coin_stores",










1007



                    "stationary_office_supplies_printing_and_writing_paper",










1008



                    "stationery_stores_office_and_school_supply_stores",










1009



                    "swimming_pools_sales",










1010



                    "t_ui_travel_germany",










1011



                    "tailors_alterations",










1012



                    "tax_payments_government_agencies",










1013



                    "tax_preparation_services",










1014



                    "taxicabs_limousines",










1015



                    "telecommunication_equipment_and_telephone_sales",










1016



                    "telecommunication_services",










1017



                    "telegraph_services",










1018



                    "tent_and_awning_shops",










1019



                    "testing_laboratories",










1020



                    "theatrical_ticket_agencies",










1021



                    "timeshares",










1022



                    "tire_retreading_and_repair",










1023



                    "tolls_bridge_fees",










1024



                    "tourist_attractions_and_exhibits",










1025



                    "towing_services",










1026



                    "trailer_parks_campgrounds",










1027



                    "transportation_services",










1028



                    "travel_agencies_tour_operators",










1029



                    "truck_stop_iteration",










1030



                    "truck_utility_trailer_rentals",










1031



                    "typesetting_plate_making_and_related_services",










1032



                    "typewriter_stores",










1033



                    "u_s_federal_government_agencies_or_departments",










1034



                    "uniforms_commercial_clothing",










1035



                    "used_merchandise_and_secondhand_stores",










1036



                    "utilities",










1037



                    "variety_stores",










1038



                    "veterinary_services",










1039



                    "video_amusement_game_supplies",










1040



                    "video_game_arcades",










1041



                    "video_tape_rental_stores",










1042



                    "vocational_trade_schools",










1043



                    "watch_jewelry_repair",










1044



                    "welding_repair",










1045



                    "wholesale_clubs",










1046



                    "wig_and_toupee_stores",










1047



                    "wires_money_orders",










1048



                    "womens_accessory_and_specialty_shops",










1049



                    "womens_ready_to_wear_stores",










1050



                    "wrecking_and_salvage_yards",










1051



                ]










1052



            ]










1053



        ]










1054



        """




1✔





1055



        Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.










1056



        """










1057



        spending_limits: Optional[List[SpendingLimit]]




1✔





1058



        """




1✔





1059



        Limit spending with amount-based rules that apply across any cards this card replaced (i.e., its `replacement_for` card and _that_ card's `replacement_for` card, up the chain).










1060



        """










1061



        spending_limits_currency: Optional[str]




1✔





1062



        """




1✔





1063



        Currency of the amounts within `spending_limits`. Always the same as the currency of the card.










1064



        """










1065



        _inner_class_types = {"spending_limits": SpendingLimit}




1✔





1066












1067



    class Wallets(StripeObject):




1✔





1068



        class ApplePay(StripeObject):




1✔





1069



            eligible: bool




1✔





1070



            """




1✔





1071



            Apple Pay Eligibility










1072



            """










1073



            ineligible_reason: Optional[




1✔





1074



                Literal[










1075



                    "missing_agreement",










1076



                    "missing_cardholder_contact",










1077



                    "unsupported_region",










1078



                ]










1079



            ]










1080



            """




1✔





1081



            Reason the card is ineligible for Apple Pay










1082



            """










1083












1084



        class GooglePay(StripeObject):




1✔





1085



            eligible: bool




1✔





1086



            """




1✔





1087



            Google Pay Eligibility










1088



            """










1089



            ineligible_reason: Optional[




1✔





1090



                Literal[










1091



                    "missing_agreement",










1092



                    "missing_cardholder_contact",










1093



                    "unsupported_region",










1094



                ]










1095



            ]










1096



            """




1✔





1097



            Reason the card is ineligible for Google Pay










1098



            """










1099












1100



        apple_pay: ApplePay




1✔





1101



        google_pay: GooglePay




1✔





1102



        primary_account_identifier: Optional[str]




1✔





1103



        """




1✔





1104



        Unique identifier for a card used with digital wallets










1105



        """










1106



        _inner_class_types = {"apple_pay": ApplePay, "google_pay": GooglePay}




1✔





1107












1108



    class CreateParams(RequestOptions):




1✔





1109



        cardholder: NotRequired["str"]




1✔





1110



        """




1✔





1111



        The [Cardholder](https://stripe.com/docs/api#issuing_cardholder_object) object with which the card will be associated.










1112



        """










1113



        currency: str




1✔





1114



        """




1✔





1115



        The currency for the card.










1116



        """










1117



        expand: NotRequired["List[str]"]




1✔





1118



        """




1✔





1119



        Specifies which fields in the response should be expanded.










1120



        """










1121



        financial_account: NotRequired["str"]




1✔





1122



        metadata: NotRequired["Dict[str, str]"]




1✔





1123



        """




1✔





1124



        Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.










1125



        """











1126



        personalization_design: NotRequired["str"]




1✔






1127



        """




1✔





1128



        The personalization design object belonging to this card.










1129



        """










1130



        pin: NotRequired["Card.CreateParamsPin"]




1✔





1131



        """




1✔





1132



        The desired PIN for this card.










1133



        """










1134



        replacement_for: NotRequired["str"]




1✔





1135



        """




1✔





1136



        The card this is meant to be a replacement for (if any).










1137



        """










1138



        replacement_reason: NotRequired[




1✔





1139



            "Literal['damaged', 'expired', 'lost', 'stolen']"










1140



        ]










1141



        """




1✔





1142



        If `replacement_for` is specified, this should indicate why that card is being replaced.










1143



        """










1144



        shipping: NotRequired["Card.CreateParamsShipping"]




1✔





1145



        """




1✔





1146



        The address where the card will be shipped.










1147



        """










1148



        spending_controls: NotRequired["Card.CreateParamsSpendingControls"]




1✔





1149



        """




1✔





1150



        Rules that control spending for this card. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.










1151



        """










1152



        status: NotRequired["Literal['active', 'inactive']"]




1✔





1153



        """




1✔





1154



        Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to `inactive`.










1155



        """










1156



        type: Literal["physical", "virtual"]




1✔





1157



        """




1✔





1158



        The type of card to issue. Possible values are `physical` or `virtual`.










1159



        """










1160












1161



    class CreateParamsPin(TypedDict):




1✔





1162



        encrypted_number: NotRequired["str"]




1✔





1163



        """




1✔





1164



        The card's desired new PIN, encrypted under Stripe's public key.










1165



        """










1166












1167



    class CreateParamsShipping(TypedDict):




1✔





1168



        address: "Card.CreateParamsShippingAddress"




1✔





1169



        """




1✔





1170



        The address that the card is shipped to.










1171



        """










1172



        customs: NotRequired["Card.CreateParamsShippingCustoms"]




1✔





1173



        """




1✔





1174



        Customs information for the shipment.










1175



        """










1176



        name: str




1✔





1177



        """




1✔





1178



        The name printed on the shipping label when shipping the card.










1179



        """










1180



        phone_number: NotRequired["str"]




1✔





1181



        """




1✔





1182



        Phone number of the recipient of the shipment.










1183



        """










1184



        require_signature: NotRequired["bool"]




1✔





1185



        """




1✔





1186



        Whether a signature is required for card delivery.










1187



        """










1188



        service: NotRequired["Literal['express', 'priority', 'standard']"]




1✔





1189



        """




1✔





1190



        Shipment service.










1191



        """










1192



        type: NotRequired["Literal['bulk', 'individual']"]




1✔





1193



        """




1✔





1194



        Packaging options.










1195



        """










1196












1197



    class CreateParamsShippingAddress(TypedDict):




1✔





1198



        city: str




1✔





1199



        """




1✔





1200



        City, district, suburb, town, or village.










1201



        """










1202



        country: str




1✔





1203



        """




1✔





1204



        Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).










1205



        """










1206



        line1: str




1✔





1207



        """




1✔





1208



        Address line 1 (e.g., street, PO Box, or company name).










1209



        """










1210



        line2: NotRequired["str"]




1✔





1211



        """




1✔





1212



        Address line 2 (e.g., apartment, suite, unit, or building).










1213



        """










1214



        postal_code: str




1✔





1215



        """




1✔





1216



        ZIP or postal code.










1217



        """










1218



        state: NotRequired["str"]




1✔





1219



        """




1✔





1220



        State, county, province, or region.










1221



        """










1222












1223



    class CreateParamsShippingCustoms(TypedDict):




1✔





1224



        eori_number: NotRequired["str"]




1✔





1225



        """




1✔





1226



        The Economic Operators Registration and Identification (EORI) number to use for Customs. Required for bulk shipments to Europe.










1227



        """










1228












1229



    class CreateParamsSpendingControls(TypedDict):




1✔





1230



        allowed_categories: NotRequired[




1✔





1231



            "List[Literal['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', 'electric_vehicle_charging', 'electrical_parts_and_equipment', 'electrical_services', 'electronics_repair_shops', 'electronics_stores', 'elementary_secondary_schools', 'emergency_services_gcas_visa_use_only', '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_licensed_horse_dog_racing_us_region_only', 'government_licensed_online_casions_online_gambling_us_region_only', 'government_owned_lotteries_non_us_region', 'government_owned_lotteries_us_region_only', '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', 'marketplaces', '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']]"










1232



        ]










1233



        """




1✔





1234



        Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.










1235



        """










1236



        blocked_categories: NotRequired[




1✔





1237



            "List[Literal['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', 'electric_vehicle_charging', 'electrical_parts_and_equipment', 'electrical_services', 'electronics_repair_shops', 'electronics_stores', 'elementary_secondary_schools', 'emergency_services_gcas_visa_use_only', '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_licensed_horse_dog_racing_us_region_only', 'government_licensed_online_casions_online_gambling_us_region_only', 'government_owned_lotteries_non_us_region', 'government_owned_lotteries_us_region_only', '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', 'marketplaces', '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']]"










1238



        ]










1239



        """




1✔





1240



        Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.










1241



        """










1242



        spending_limits: NotRequired[




1✔





1243



            "List[Card.CreateParamsSpendingControlsSpendingLimit]"










1244



        ]










1245



        """




1✔





1246



        Limit spending with amount-based rules that apply across any cards this card replaced (i.e., its `replacement_for` card and _that_ card's `replacement_for` card, up the chain).










1247



        """










1248












1249



    class CreateParamsSpendingControlsSpendingLimit(TypedDict):




1✔





1250



        amount: int




1✔





1251



        """




1✔





1252



        Maximum amount allowed to spend per interval.










1253



        """










1254



        categories: NotRequired[




1✔





1255



            "List[Literal['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', 'electric_vehicle_charging', 'electrical_parts_and_equipment', 'electrical_services', 'electronics_repair_shops', 'electronics_stores', 'elementary_secondary_schools', 'emergency_services_gcas_visa_use_only', '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_licensed_horse_dog_racing_us_region_only', 'government_licensed_online_casions_online_gambling_us_region_only', 'government_owned_lotteries_non_us_region', 'government_owned_lotteries_us_region_only', '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', 'marketplaces', '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']]"










1256



        ]










1257



        """




1✔





1258



        Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.










1259



        """










1260



        interval: Literal[




1✔





1261



            "all_time",










1262



            "daily",










1263



            "monthly",










1264



            "per_authorization",










1265



            "weekly",










1266



            "yearly",










1267



        ]










1268



        """




1✔





1269



        Interval (or event) to which the amount applies.










1270



        """










1271












1272



    class DeliverCardParams(RequestOptions):




1✔





1273



        expand: NotRequired["List[str]"]




1✔





1274



        """




1✔





1275



        Specifies which fields in the response should be expanded.










1276



        """










1277












1278



    class FailCardParams(RequestOptions):




1✔





1279



        expand: NotRequired["List[str]"]




1✔





1280



        """




1✔





1281



        Specifies which fields in the response should be expanded.










1282



        """










1283












1284



    class ListParams(RequestOptions):




1✔





1285



        cardholder: NotRequired["str"]




1✔





1286



        """




1✔





1287



        Only return cards belonging to the Cardholder with the provided ID.










1288



        """










1289



        created: NotRequired["Card.ListParamsCreated|int"]




1✔





1290



        """




1✔





1291



        Only return cards that were issued during the given date interval.










1292



        """










1293



        ending_before: NotRequired["str"]




1✔





1294



        """




1✔





1295



        A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.










1296



        """










1297



        exp_month: NotRequired["int"]




1✔





1298



        """




1✔





1299



        Only return cards that have the given expiration month.










1300



        """










1301



        exp_year: NotRequired["int"]




1✔





1302



        """




1✔





1303



        Only return cards that have the given expiration year.










1304



        """










1305



        expand: NotRequired["List[str]"]




1✔





1306



        """




1✔





1307



        Specifies which fields in the response should be expanded.










1308



        """










1309



        last4: NotRequired["str"]




1✔





1310



        """




1✔





1311



        Only return cards that have the given last four digits.










1312



        """










1313



        limit: NotRequired["int"]




1✔





1314



        """




1✔





1315



        A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.










1316



        """











1317



        personalization_design: NotRequired["str"]




1✔





1318



        starting_after: NotRequired["str"]




1✔





1319



        """




1✔





1320



        A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.










1321



        """










1322



        status: NotRequired["Literal['active', 'canceled', 'inactive']"]




1✔





1323



        """




1✔





1324



        Only return cards that have the given status. One of `active`, `inactive`, or `canceled`.










1325



        """










1326



        type: NotRequired["Literal['physical', 'virtual']"]




1✔





1327



        """




1✔





1328



        Only return cards that have the given type. One of `virtual` or `physical`.










1329



        """










1330












1331



    class ListParamsCreated(TypedDict):




1✔





1332



        gt: NotRequired["int"]




1✔





1333



        """




1✔





1334



        Minimum value to filter by (exclusive)










1335



        """










1336



        gte: NotRequired["int"]




1✔





1337



        """




1✔





1338



        Minimum value to filter by (inclusive)










1339



        """










1340



        lt: NotRequired["int"]




1✔





1341



        """




1✔





1342



        Maximum value to filter by (exclusive)










1343



        """










1344



        lte: NotRequired["int"]




1✔





1345



        """




1✔





1346



        Maximum value to filter by (inclusive)










1347



        """










1348












1349



    class ModifyParams(RequestOptions):




1✔





1350



        cancellation_reason: NotRequired["Literal['lost', 'stolen']"]




1✔





1351



        """




1✔





1352



        Reason why the `status` of this card is `canceled`.










1353



        """










1354



        expand: NotRequired["List[str]"]




1✔





1355



        """




1✔





1356



        Specifies which fields in the response should be expanded.










1357



        """










1358



        metadata: NotRequired["Literal['']|Dict[str, str]"]




1✔





1359



        """




1✔





1360



        Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.










1361



        """











1362



        personalization_design: NotRequired["str"]




1✔





1363



        pin: NotRequired["Card.ModifyParamsPin"]




1✔





1364



        """




1✔





1365



        The desired new PIN for this card.










1366



        """










1367



        spending_controls: NotRequired["Card.ModifyParamsSpendingControls"]




1✔





1368



        """




1✔





1369



        Rules that control spending for this card. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.










1370



        """










1371



        status: NotRequired["Literal['active', 'canceled', 'inactive']"]




1✔





1372



        """




1✔





1373



        Dictates whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to `inactive`. If this card is being canceled because it was lost or stolen, this information should be provided as `cancellation_reason`.










1374



        """










1375












1376



    class ModifyParamsPin(TypedDict):




1✔





1377



        encrypted_number: NotRequired["str"]




1✔





1378



        """




1✔





1379



        The card's desired new PIN, encrypted under Stripe's public key.










1380



        """










1381












1382



    class ModifyParamsSpendingControls(TypedDict):




1✔





1383



        allowed_categories: NotRequired[




1✔





1384



            "List[Literal['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', 'electric_vehicle_charging', 'electrical_parts_and_equipment', 'electrical_services', 'electronics_repair_shops', 'electronics_stores', 'elementary_secondary_schools', 'emergency_services_gcas_visa_use_only', '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_licensed_horse_dog_racing_us_region_only', 'government_licensed_online_casions_online_gambling_us_region_only', 'government_owned_lotteries_non_us_region', 'government_owned_lotteries_us_region_only', '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', 'marketplaces', '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']]"










1385



        ]










1386



        """




1✔





1387



        Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.










1388



        """










1389



        blocked_categories: NotRequired[




1✔





1390



            "List[Literal['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', 'electric_vehicle_charging', 'electrical_parts_and_equipment', 'electrical_services', 'electronics_repair_shops', 'electronics_stores', 'elementary_secondary_schools', 'emergency_services_gcas_visa_use_only', '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_licensed_horse_dog_racing_us_region_only', 'government_licensed_online_casions_online_gambling_us_region_only', 'government_owned_lotteries_non_us_region', 'government_owned_lotteries_us_region_only', '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', 'marketplaces', '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']]"










1391



        ]










1392



        """




1✔





1393



        Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.










1394



        """










1395



        spending_limits: NotRequired[




1✔





1396



            "List[Card.ModifyParamsSpendingControlsSpendingLimit]"










1397



        ]










1398



        """




1✔





1399



        Limit spending with amount-based rules that apply across any cards this card replaced (i.e., its `replacement_for` card and _that_ card's `replacement_for` card, up the chain).










1400



        """










1401












1402



    class ModifyParamsSpendingControlsSpendingLimit(TypedDict):




1✔





1403



        amount: int




1✔





1404



        """




1✔





1405



        Maximum amount allowed to spend per interval.










1406



        """










1407



        categories: NotRequired[




1✔





1408



            "List[Literal['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', 'electric_vehicle_charging', 'electrical_parts_and_equipment', 'electrical_services', 'electronics_repair_shops', 'electronics_stores', 'elementary_secondary_schools', 'emergency_services_gcas_visa_use_only', '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_licensed_horse_dog_racing_us_region_only', 'government_licensed_online_casions_online_gambling_us_region_only', 'government_owned_lotteries_non_us_region', 'government_owned_lotteries_us_region_only', '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', 'marketplaces', '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']]"










1409



        ]










1410



        """




1✔





1411



        Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.










1412



        """










1413



        interval: Literal[




1✔





1414



            "all_time",










1415



            "daily",










1416



            "monthly",










1417



            "per_authorization",










1418



            "weekly",










1419



            "yearly",










1420



        ]










1421



        """




1✔





1422



        Interval (or event) to which the amount applies.










1423



        """










1424












1425



    class RetrieveParams(RequestOptions):




1✔





1426



        expand: NotRequired["List[str]"]




1✔





1427



        """




1✔





1428



        Specifies which fields in the response should be expanded.










1429



        """










1430












1431



    class ReturnCardParams(RequestOptions):




1✔





1432



        expand: NotRequired["List[str]"]




1✔





1433



        """




1✔





1434



        Specifies which fields in the response should be expanded.










1435



        """










1436












1437



    class ShipCardParams(RequestOptions):




1✔





1438



        expand: NotRequired["List[str]"]




1✔





1439



        """




1✔





1440



        Specifies which fields in the response should be expanded.










1441



        """










1442












1443



    brand: str




1✔





1444



    """




1✔





1445



    The brand of the card.










1446



    """










1447



    cancellation_reason: Optional[Literal["design_rejected", "lost", "stolen"]]




1✔





1448



    """




1✔





1449



    The reason why the card was canceled.










1450



    """










1451



    cardholder: "Cardholder"




1✔





1452



    """




1✔





1453



    An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards.










1454














1455



    Related guide: [How to create a cardholder](https://stripe.com/docs/issuing/cards#create-cardholder)










1456



    """










1457



    created: int




1✔





1458



    """




1✔





1459



    Time at which the object was created. Measured in seconds since the Unix epoch.










1460



    """










1461



    currency: str




1✔





1462



    """




1✔





1463



    Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Supported currencies are `usd` in the US, `eur` in the EU, and `gbp` in the UK.










1464



    """










1465



    cvc: Optional[str]




1✔





1466



    """




1✔





1467



    The card's CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint.










1468



    """










1469



    exp_month: int




1✔





1470



    """




1✔





1471



    The expiration month of the card.










1472



    """










1473



    exp_year: int




1✔





1474



    """




1✔





1475



    The expiration year of the card.










1476



    """










1477



    financial_account: Optional[str]




1✔





1478



    """




1✔





1479



    The financial account this card is attached to.










1480



    """










1481



    id: str




1✔





1482



    """




1✔





1483



    Unique identifier for the object.










1484



    """










1485



    last4: str




1✔





1486



    """




1✔





1487



    The last 4 digits of the card number.










1488



    """










1489



    livemode: bool




1✔





1490



    """




1✔





1491



    Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.










1492



    """










1493



    metadata: Dict[str, str]




1✔





1494



    """




1✔





1495



    Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.










1496



    """










1497



    number: Optional[str]




1✔





1498



    """




1✔





1499



    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 [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint.










1500



    """










1501



    object: Literal["issuing.card"]




1✔





1502



    """




1✔





1503



    String representing the object's type. Objects of the same type share the same value.










1504



    """











1505



    personalization_design: Optional[ExpandableField["PersonalizationDesign"]]




1✔






1506



    """




1✔





1507



    The personalization design object belonging to this card.










1508



    """










1509



    replaced_by: Optional[ExpandableField["Card"]]




1✔





1510



    """




1✔





1511



    The latest card that replaces this card, if any.










1512



    """










1513



    replacement_for: Optional[ExpandableField["Card"]]




1✔





1514



    """




1✔





1515



    The card this card replaces, if any.










1516



    """










1517



    replacement_reason: Optional[




1✔





1518



        Literal["damaged", "expired", "lost", "stolen"]










1519



    ]










1520



    """




1✔





1521



    The reason why the previous card needed to be replaced.










1522



    """










1523



    shipping: Optional[Shipping]




1✔





1524



    """




1✔





1525



    Where and how the card will be shipped.










1526



    """










1527



    spending_controls: SpendingControls




1✔





1528



    status: Literal["active", "canceled", "inactive"]




1✔





1529



    """




1✔





1530



    Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to `inactive`.










1531



    """










1532



    type: Literal["physical", "virtual"]




1✔





1533



    """




1✔





1534



    The type of the card.










1535



    """










1536



    wallets: Optional[Wallets]




1✔





1537



    """




1✔





1538



    Information relating to digital wallets (like Apple Pay and Google Pay).










1539



    """










1540












1541



    @classmethod




1✔





1542



    def create(cls, **params: Unpack["Card.CreateParams"]) -> "Card":




1✔





1543



        """










1544



        Creates an Issuing Card object.










1545



        """










1546



        return cast(




1✔





1547



            "Card",










1548



            cls._static_request(










1549



                "post",










1550



                cls.class_url(),










1551



                params=params,










1552



            ),










1553



        )










1554












1555



    @classmethod




1✔





1556



    def list(cls, **params: Unpack["Card.ListParams"]) -> ListObject["Card"]:




1✔





1557



        """










1558



        Returns a list of Issuing Card objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.










1559



        """










1560



        result = cls._static_request(




1✔





1561



            "get",










1562



            cls.class_url(),










1563



            params=params,










1564



        )










1565



        if not isinstance(result, ListObject):





1!





1566












1567



            raise TypeError(




×







1568



                "Expected list object from API, got %s"










1569



                % (type(result).__name__)










1570



            )










1571












1572



        return result




1✔





1573












1574



    @classmethod




1✔





1575



    def modify(cls, id: str, **params: Unpack["Card.ModifyParams"]) -> "Card":




1✔





1576



        """










1577



        Updates the specified Issuing Card object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.










1578



        """










1579



        url = "%s/%s" % (cls.class_url(), sanitize_id(id))




1✔





1580



        return cast(




1✔





1581



            "Card",










1582



            cls._static_request(










1583



                "post",










1584



                url,










1585



                params=params,










1586



            ),










1587



        )










1588












1589



    @classmethod




1✔





1590



    def retrieve(




1✔





1591



        cls, id: str, **params: Unpack["Card.RetrieveParams"]










1592



    ) -> "Card":










1593



        """










1594



        Retrieves an Issuing Card object.










1595



        """










1596



        instance = cls(id, **params)




1✔





1597



        instance.refresh()




1✔





1598



        return instance




1✔





1599












1600



    class TestHelpers(APIResourceTestHelpers["Card"]):




1✔





1601



        _resource_cls: Type["Card"]




1✔





1602












1603



        @classmethod




1✔





1604



        def _cls_deliver_card(




1✔





1605



            cls, card: str, **params: Unpack["Card.DeliverCardParams"]










1606



        ) -> "Card":










1607



            """










1608



            Updates the shipping status of the specified Issuing Card object to delivered.










1609



            """










1610



            return cast(




1✔





1611



                "Card",










1612



                cls._static_request(










1613



                    "post",










1614



                    "/v1/test_helpers/issuing/cards/{card}/shipping/deliver".format(










1615



                        card=sanitize_id(card)










1616



                    ),










1617



                    params=params,










1618



                ),










1619



            )










1620












1621



        @overload




1✔





1622



        @staticmethod




1✔





1623



        def deliver_card(




1✔





1624



            card: str, **params: Unpack["Card.DeliverCardParams"]










1625



        ) -> "Card":










1626



            """










1627



            Updates the shipping status of the specified Issuing Card object to delivered.










1628



            """










1629



            ...




×







1630












1631



        @overload




1✔





1632



        def deliver_card(




1✔





1633



            self, **params: Unpack["Card.DeliverCardParams"]










1634



        ) -> "Card":










1635



            """










1636



            Updates the shipping status of the specified Issuing Card object to delivered.










1637



            """










1638



            ...




×







1639












1640



        @class_method_variant("_cls_deliver_card")




1✔





1641



        def deliver_card(  # pyright: ignore[reportGeneralTypeIssues]




1✔





1642



            self, **params: Unpack["Card.DeliverCardParams"]










1643



        ) -> "Card":










1644



            """










1645



            Updates the shipping status of the specified Issuing Card object to delivered.










1646



            """










1647



            return cast(




×







1648



                "Card",










1649



                self.resource._request(










1650



                    "post",










1651



                    "/v1/test_helpers/issuing/cards/{card}/shipping/deliver".format(










1652



                        card=sanitize_id(self.resource.get("id"))










1653



                    ),










1654



                    params=params,










1655



                ),










1656



            )










1657












1658



        @classmethod




1✔





1659



        def _cls_fail_card(




1✔





1660



            cls, card: str, **params: Unpack["Card.FailCardParams"]










1661



        ) -> "Card":










1662



            """










1663



            Updates the shipping status of the specified Issuing Card object to failure.










1664



            """










1665



            return cast(




1✔





1666



                "Card",










1667



                cls._static_request(










1668



                    "post",










1669



                    "/v1/test_helpers/issuing/cards/{card}/shipping/fail".format(










1670



                        card=sanitize_id(card)










1671



                    ),










1672



                    params=params,










1673



                ),










1674



            )










1675












1676



        @overload




1✔





1677



        @staticmethod




1✔





1678



        def fail_card(




1✔





1679



            card: str, **params: Unpack["Card.FailCardParams"]










1680



        ) -> "Card":










1681



            """










1682



            Updates the shipping status of the specified Issuing Card object to failure.










1683



            """










1684



            ...




×







1685












1686



        @overload




1✔





1687



        def fail_card(self, **params: Unpack["Card.FailCardParams"]) -> "Card":




1✔





1688



            """










1689



            Updates the shipping status of the specified Issuing Card object to failure.










1690



            """










1691



            ...




×







1692












1693



        @class_method_variant("_cls_fail_card")




1✔





1694



        def fail_card(  # pyright: ignore[reportGeneralTypeIssues]




1✔





1695



            self, **params: Unpack["Card.FailCardParams"]










1696



        ) -> "Card":










1697



            """










1698



            Updates the shipping status of the specified Issuing Card object to failure.










1699



            """










1700



            return cast(




×







1701



                "Card",










1702



                self.resource._request(










1703



                    "post",










1704



                    "/v1/test_helpers/issuing/cards/{card}/shipping/fail".format(










1705



                        card=sanitize_id(self.resource.get("id"))










1706



                    ),










1707



                    params=params,










1708



                ),










1709



            )










1710












1711



        @classmethod




1✔





1712



        def _cls_return_card(




1✔





1713



            cls, card: str, **params: Unpack["Card.ReturnCardParams"]










1714



        ) -> "Card":










1715



            """










1716



            Updates the shipping status of the specified Issuing Card object to returned.










1717



            """










1718



            return cast(




1✔





1719



                "Card",










1720



                cls._static_request(










1721



                    "post",










1722



                    "/v1/test_helpers/issuing/cards/{card}/shipping/return".format(










1723



                        card=sanitize_id(card)










1724



                    ),










1725



                    params=params,










1726



                ),










1727



            )










1728












1729



        @overload




1✔





1730



        @staticmethod




1✔





1731



        def return_card(




1✔





1732



            card: str, **params: Unpack["Card.ReturnCardParams"]










1733



        ) -> "Card":










1734



            """










1735



            Updates the shipping status of the specified Issuing Card object to returned.










1736



            """










1737



            ...




×







1738












1739



        @overload




1✔





1740



        def return_card(




1✔





1741



            self, **params: Unpack["Card.ReturnCardParams"]










1742



        ) -> "Card":










1743



            """










1744



            Updates the shipping status of the specified Issuing Card object to returned.










1745



            """










1746



            ...




×







1747












1748



        @class_method_variant("_cls_return_card")




1✔





1749



        def return_card(  # pyright: ignore[reportGeneralTypeIssues]




1✔





1750



            self, **params: Unpack["Card.ReturnCardParams"]










1751



        ) -> "Card":










1752



            """










1753



            Updates the shipping status of the specified Issuing Card object to returned.










1754



            """










1755



            return cast(




×







1756



                "Card",










1757



                self.resource._request(










1758



                    "post",










1759



                    "/v1/test_helpers/issuing/cards/{card}/shipping/return".format(










1760



                        card=sanitize_id(self.resource.get("id"))










1761



                    ),










1762



                    params=params,










1763



                ),










1764



            )










1765












1766



        @classmethod




1✔





1767



        def _cls_ship_card(




1✔





1768



            cls, card: str, **params: Unpack["Card.ShipCardParams"]










1769



        ) -> "Card":










1770



            """










1771



            Updates the shipping status of the specified Issuing Card object to shipped.










1772



            """










1773



            return cast(




1✔





1774



                "Card",










1775



                cls._static_request(










1776



                    "post",










1777



                    "/v1/test_helpers/issuing/cards/{card}/shipping/ship".format(










1778



                        card=sanitize_id(card)










1779



                    ),










1780



                    params=params,










1781



                ),










1782



            )










1783












1784



        @overload




1✔





1785



        @staticmethod




1✔





1786



        def ship_card(




1✔





1787



            card: str, **params: Unpack["Card.ShipCardParams"]










1788



        ) -> "Card":










1789



            """










1790



            Updates the shipping status of the specified Issuing Card object to shipped.










1791



            """










1792



            ...




×







1793












1794



        @overload




1✔





1795



        def ship_card(self, **params: Unpack["Card.ShipCardParams"]) -> "Card":




1✔





1796



            """










1797



            Updates the shipping status of the specified Issuing Card object to shipped.










1798



            """










1799



            ...




×







1800












1801



        @class_method_variant("_cls_ship_card")




1✔





1802



        def ship_card(  # pyright: ignore[reportGeneralTypeIssues]




1✔





1803



            self, **params: Unpack["Card.ShipCardParams"]










1804



        ) -> "Card":










1805



            """










1806



            Updates the shipping status of the specified Issuing Card object to shipped.










1807



            """










1808



            return cast(




×







1809



                "Card",










1810



                self.resource._request(










1811



                    "post",










1812



                    "/v1/test_helpers/issuing/cards/{card}/shipping/ship".format(










1813



                        card=sanitize_id(self.resource.get("id"))










1814



                    ),










1815



                    params=params,










1816



                ),










1817



            )










1818












1819



    @property




1✔





1820



    def test_helpers(self):




1✔





1821



        return self.TestHelpers(self)




×







1822












1823



    _inner_class_types = {




1✔





1824



        "shipping": Shipping,










1825



        "spending_controls": SpendingControls,










1826



        "wallets": Wallets,










1827



    }










1828












1829












1830



Card.TestHelpers._resource_cls = Card




1✔



















    

  • 

    •