NAME

Net::API::Stripe::Connect::Account::Company - A Stripe Company Object

SYNOPSIS

my $cie = $stripe->account->company({
    address => $stripe->address({
        line1 => '1-2-3 Kudan-Minami, Chiyoda-ku',
        line2 => 'Big Bldg 12F',
        city => 'Tokyo',
        postal_code => '123-4567',
        country => 'jp',
    }),
   address_kana => $stripe->address({
       line1 => 'ちよだくくだんみなみ1-2-3',
       line2 => 'だいびる12かい',
       city => 'とうきょうと',
       postal_code => '123-4567',
       country => 'jp',
   }),
   address_kanji => $stripe->address({
       line1 => '千代田区九段南1-2-3',
       line2 => '大ビル12階',
       city => '東京都',
       postal_code => '123-4567',
       country => 'jp',
   }),
   name => 'Yamato Nadehiko, Inc',
   name_kana => 'やまとなでひこかぶしきがいしゃ',
   name_kanji => '大和撫子株式会社',
   phone => '+81-(0)3-1234-5678',
   structure => 'private_corporation',
});

VERSION

v0.101.0

DESCRIPTION

Settings used to apply the account’s branding to email receipts, invoices, Checkout, and other products.

This is called from method company in modules Net::API::Stripe::Connect::Account and Net::API::Stripe::Issuing::Card::Holder

CONSTRUCTOR

new( %ARG )

Creates a new Net::API::Stripe::Connect::Account::Company object. It may also take an hash like arguments, that also are method of the same name.

METHODS

additional string_array

Additional fields which are only required for some users.

address hash

The company’s primary address.

This is a Net::API::Stripe::Address object.

address_kana hash

The Kana variation of the company’s primary address (Japan only).

This is a Net::API::Stripe::Address object.

address_kanji hash

The Kanji variation of the company’s primary address (Japan only).

This is a Net::API::Stripe::Address object.

directors_provided boolean

Whether the company’s directors have been provided. This Boolean will be true if you’ve manually indicated that all directors are provided via the directors_provided parameter.

executives_provided boolean

Whether the company’s executives have been provided. This Boolean will be true if you’ve manually indicated that all executives are provided via the executives_provided parameter, or if Stripe determined that sufficient executives were provided.

minimum string_array

Fields which every account must eventually provide.

name string

The company’s legal name.

name_kana string

The Kana variation of the company’s legal name (Japan only).

name_kanji string

The Kanji variation of the company’s legal name (Japan only).

owners_provided boolean

Whether the company’s owners have been provided. This Boolean will be true if you’ve manually indicated that all owners are provided via the owners_provided parameter, or if Stripe determined that all owners were provided. Stripe determines ownership requirements using both the number of owners provided and their total percent ownership (calculated by adding the percent_ownership of each owner together).

ownership_declaration object

This hash is used to attest that the beneficial owner information provided to Stripe is both current and correct.

This is a Net::API::Stripe::Connect::Account::TosAcceptance object.

phone string

The company’s phone number (used for verification).

structure string

The category identifying the legal structure of the company or legal entity. See Business structure for more details (https://stripe.com/docs/connect/identity-verification#business-structure).

Possible enum values

government_instrumentality
governmental_unit
incorporated_non_profit
multi_member_llc
private_corporation
private_partnership
public_corporation
public_partnership
tax_exempt_government_instrumentality
unincorporated_association
unincorporated_non_profit

tax_id_provided boolean

Whether the company’s business ID number was provided.

tax_id_registrar string

The jurisdiction in which the tax_id is registered (Germany-based companies only).

vat_id_provided boolean

Whether the company’s business VAT number was provided.

verification hash

Information on the verification state of the company. This is a Net::API::Stripe::Connect::Account::Verification object.

API SAMPLE

{
  "id": "acct_fake123456789",
  "object": "account",
  "business_profile": {
    "mcc": null,
    "name": "My Shop, Inc",
    "product_description": "Great products shipping all over the world",
    "support_address": {
      "city": "Tokyo",
      "country": "JP",
      "line1": "1-2-3 Kudan-minami, Chiyoda-ku",
      "line2": "",
      "postal_code": "100-0012",
      "state": ""
    },
    "support_email": "billing@example.com",
    "support_phone": "+81312345678",
    "support_url": "",
    "url": "https://www.example.com"
  },
  "business_type": "company",
  "capabilities": {
    "card_payments": "active"
  },
  "charges_enabled": true,
  "country": "JP",
  "default_currency": "jpy",
  "details_submitted": true,
  "email": "tech@example.com",
  "metadata": {},
  "payouts_enabled": true,
  "settings": {
    "branding": {
      "icon": "file_fake123456789",
      "logo": null,
      "primary_color": "#0e77ca"
    },
    "card_payments": {
      "decline_on": {
        "avs_failure": false,
        "cvc_failure": false
      },
      "statement_descriptor_prefix": null
    },
    "dashboard": {
      "display_name": "myshop-inc",
      "timezone": "Asia/Tokyo"
    },
    "payments": {
      "statement_descriptor": "MYSHOP, INC",
      "statement_descriptor_kana": "マイショップインク",
      "statement_descriptor_kanji": "マイショップインク"
    },
    "payouts": {
      "debit_negative_balances": true,
      "schedule": {
        "delay_days": 4,
        "interval": "weekly",
        "weekly_anchor": "thursday"
      },
      "statement_descriptor": null
    }
  },
  "type": "standard"
}

HISTORY

v0.1

Initial version

STRIPE HISTORY

2019-12-24

Stripe added the executives_provided property.

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

Stripe API documentation:

https://stripe.com/docs/api/accounts/object

COPYRIGHT & LICENSE

Copyright (c) 2019-2020 DEGUEST Pte. Ltd.

You can use, copy, modify and redistribute this package and associated files under the same terms as Perl itself.