File Coverage

lib/Net/API/Stripe/Connect/Account.pm
Criterion Covered Total %
statement 19 60 31.6
branch n/a
condition n/a
subroutine 7 48 14.5
pod 41 41 100.0
total 67 149 44.9


line stmt bran cond sub pod time code
1             ##----------------------------------------------------------------------------
2             ## Stripe API - ~/lib/Net/API/Stripe/Connect/Account.pm
3             ## Version v0.101.0
4             ## Copyright(c) 2019 DEGUEST Pte. Ltd.
5             ## Author: Jacques Deguest <jack@deguest.jp>
6             ## Created 2019/11/02
7             ## Modified 2022/10/29
8             ##
9             ##----------------------------------------------------------------------------
10             ## https://stripe.com/docs/api/account/object
11             BEGIN
12             {
13             use strict;
14 2     2   24030827 use warnings;
  2         13  
  2         61  
15 2     2   9 use parent qw( Net::API::Stripe::Generic );
  2         5  
  2         57  
16 2     2   9 use vars qw( $VERSION );
  2         5  
  2         10  
17 2     2   135 our( $VERSION ) = 'v0.101.0';
  2         4  
  2         116  
18 2     2   42 };
19              
20             use strict;
21 2     2   11 use warnings;
  2         3  
  2         38  
22 2     2   10  
  2         4  
  2         1874  
23              
24 0     0 1    
25             ## Moved as of 2019-02-19
26 0     0 1   # sub business_logo { return( shift->_set_get_scalar_or_object( 'business_logo', 'Net::API::Stripe::File', @_ ) ); }
27             # Thanks to Module::Generic _set_get_object feature, even if settings is not set this will not crash
28              
29              
30             ## Moved as of 2019-02-19
31             ## sub business_logo_large { return( shift->_set_get_scalar( 'business_logo_large', @_ ) ); }
32 0     0 1    
33              
34             ## Moved as of 2019-02-19
35             ## sub business_name { return( shift->_set_get_scalar( 'business_name', @_ ) ); }
36              
37 0     0 1    
38             ## Moved as of 2019-02-19
39             ## sub business_primary_color { return( shift->_set_get_scalar( 'business_primary_color', @_ ) ); }
40              
41              
42 0     0 1    
43              
44             ## Moved as of 2019-02-19
45             ## sub business_url { return( shift->_set_get_uri( 'business_url', @_ ) ); }
46              
47 0     0 1    
48             ## This is a fake module (Net::API::Stripe::Connect::Account::Capabilities), but will allow the user to call the property as method of that module
49 0     0 1   ## sub capabilities { return( shift->_set_get_hash_as_object( 'capabilities', 'Net::API::Stripe::Connect::Account::Capabilities', @_ ) ); }
50              
51 0     0 1   {
52             acss_debit_payments => { type => "scalar" },
53             affirm_payments => { type => "scalar" },
54             afterpay_clearpay_payments => { type => "scalar" },
55             au_becs_debit_payments => { type => "scalar" },
56 0     0 1   bacs_debit_payments => { type => "scalar" },
57             bancontact_payments => { type => "scalar" },
58             bank_transfer_payments => { type => "scalar" },
59             blik_payments => { type => "scalar" },
60             boleto_payments => { type => "scalar" },
61 0     0 1   card_issuing => { type => "scalar" },
62             card_payments => { type => "scalar" },
63             cartes_bancaires_payments => { type => "scalar" },
64             eps_payments => { type => "scalar" },
65             fpx_payments => { type => "scalar" },
66             giropay_payments => { type => "scalar" },
67             grabpay_payments => { type => "scalar" },
68             ideal_payments => { type => "scalar" },
69             jcb_payments => { type => "scalar" },
70             klarna_payments => { type => "scalar" },
71             konbini_payments => { type => "scalar" },
72             legacy_payments => { type => "scalar" },
73             link_payments => { type => "scalar" },
74             oxxo_payments => { type => "scalar" },
75             p24_payments => { type => "scalar" },
76             paynow_payments => { type => "scalar" },
77             promptpay_payments => { type => "scalar" },
78             sepa_debit_payments => { type => "scalar" },
79             sofort_payments => { type => "scalar" },
80             tax_reporting_us_1099_k => { type => "scalar" },
81             tax_reporting_us_1099_misc => { type => "scalar" },
82             transfers => { type => "scalar" },
83             us_bank_account_ach_payments => { type => "scalar" },
84             }, @_ ) ); }
85              
86              
87              
88             {
89             is_controller => { type => "boolean" },
90             type => { type => "scalar" },
91             }, @_ ) ); }
92              
93              
94              
95             ## Moved as of 2019-02-19
96             # sub debit_negative_balances { return( shift->_set_get_scalar( 'debit_negative_balances', @_ ) ); }
97 0     0 1    
98              
99 0     0 1   ## Moved as of 2019-02-19
100             # sub decline_charge_on { return( shift->_set_get_object( 'decline_charge_on', 'Net::API::Stripe::Connect::Account::DeclineChargeOn', @_ ) ); }
101 0     0 1    
102              
103              
104              
105             ## Moved as of 2019-02-19
106             ## sub display_name { return( shift->_set_get_scalar( 'display_name', @_ ) ); }
107 0     0 1    
108              
109 0     0 1    
110              
111              
112              
113              
114 0     0 1    
115              
116             ## Moved as of 2019-02-19
117             ## sub payout_statement_descriptor { return( shift->_set_get_scalar( 'payout_statement_descriptor', @_ ) ); }
118              
119 0     0 1    
120             ## Moved as of 2019-02-19
121 0     0 1   ## sub product_description { return( shift->_set_get_scalar( 'product_description', @_ ) ); }
122              
123 0     0 1    
124             ## Moved as of 2019-02-19
125             ## sub payout_schedule { return( shift->_set_get_object( 'payout_schedule', 'Net::API::Stripe::Connect::Account::PaymentSchedule', @_ ) ); }
126              
127              
128 0     0 1    
129              
130 0     0 1   ## Moved as of 2019-02-19
131             ## sub statement_descriptor { return( shift->_set_get_scalar( 'statement_descriptor', @_ ) ); }
132 0     0 1    
133              
134 0     0 1   ## Moved as of 2019-02-19
135             ## sub support_address { return( shift->_set_get_object( 'support_address', 'Net::API::Stripe::Address', @_ ) ); }
136 0     0 1    
137              
138 0     0 1   ## Moved as of 2019-02-19
139             ## sub support_email { return( shift->_set_get_scalar( 'support_email', @_ ) ); }
140 0     0 1    
141              
142 0     0 1   ## Moved as of 2019-02-19
143             ## sub support_phone { return( shift->_set_get_scalar( 'support_phone', @_ ) ); }
144              
145              
146             ## Moved as of 2019-02-19
147 0     0 1   ## sub support_url { return( shift->_set_get_uri( 'support_url', @_ ) ); }
148              
149              
150             ## Moved as of 2019-02-19
151             ## sub timezone { return( shift->_set_get_scalar( 'timezone', @_ ) ); }
152 0     0 1    
153              
154              
155             ## standard, express, or custom
156              
157 0     0 1    
158             ## Not used anymore as of 2019-02-19
159 0     0 1    
160              
161 0     0 1   1;
162              
163              
164             =encoding utf8
165              
166 0     0 1   =head1 NAME
167              
168             Net::API::Stripe::Connect::Account - A Stripe Account Object
169              
170             =head1 SYNOPSIS
171 0     0 1    
172             my $acct = $stripe->account({
173             business_profile =>
174             {
175             logo => '/some/file/path/logo.jpg',
176 0     0 1   name => 'Big Corp, Inc',
177             },
178             settings =>
179             {
180             primary_color => 'blue',
181 0     0 1   dashboard => { display_name => 'Big Corp, Inc' },
182             },
183             business_type => 'company',
184             business_url => 'https://example.com',
185             charges_enabled => $stripe->true,
186 0     0 1   company => $company_object,
187             country => 'jp',
188             default_currency => 'jpy',
189             email => 'hello@example.com',
190             metadata => { transaction_id => 1212, customer_id => 123 },
191 0     0 1   });
192              
193 0     0 1   =head1 VERSION
194              
195             v0.101.0
196              
197 0     0 1   =head1 DESCRIPTION
198              
199             This is an object representing a Stripe account. You can retrieve it to see properties on the account like its current e-mail address or if the account is enabled yet to make live charges.
200              
201 0     0 1   Some properties, marked below, are available only to platforms that want to create and manage Express or Custom accounts (L<https://stripe.com/docs/connect/accounts>).
202              
203             =head1 CONSTRUCTOR
204              
205             =head2 new( %ARG )
206              
207             Creates a new L<Net::API::Stripe::Connect::Account> object.
208             It may also take an hash like arguments, that also are method of the same name.
209              
210             =head1 METHODS
211              
212             =head2 id string
213              
214             Unique identifier for the object.
215              
216             =head2 object string, value is "account"
217              
218             String representing the object’s type. Objects of the same type share the same value.
219              
220             =head2 business_logo
221              
222             This is outdated. It now points to B<business_profile>->B<icon>
223              
224             =head2 business_logo_large
225              
226             This is outdated. It now points to B<business_profile>->B<logo>
227              
228             =head2 business_name
229              
230             This is outdated. It now points to B<business_name>->B<name>
231              
232             =head2 business_primary_color
233              
234             This is outdated. It now points to B<settings>->B<primary_color>
235              
236             =head2 business_profile hash
237              
238             Optional information related to the business.
239              
240             This is a L<Net::API::Stripe::Business::Profile> object.
241              
242             =head2 business_type string
243              
244             The business type. Can be individual or company.
245              
246             =head2 business_url
247              
248             This is outdated. It now points to B<business_profile>->B<url>
249              
250             =head2 capabilities hash
251              
252             A hash containing the set of capabilities that was requested for this account and their associated states. Keys are names of capabilities. You can see the full list L<here|https://stripe.com/docs/api/capabilities/list>. Values may be C<active>, C<inactive>, or C<pending>.
253              
254             It has the following properties:
255              
256             =over 4
257              
258             =item C<acss_debit_payments> string
259              
260             The status of the Canadian pre-authorized debits payments capability of the account, or whether the account can directly process Canadian pre-authorized debits charges.
261              
262             =item C<affirm_payments> string
263              
264             The status of the Affirm capability of the account, or whether the account can directly process Affirm charges.
265              
266             =item C<afterpay_clearpay_payments> string
267              
268             The status of the Afterpay Clearpay capability of the account, or whether the account can directly process Afterpay Clearpay charges.
269              
270             =item C<au_becs_debit_payments> string
271              
272             The status of the BECS Direct Debit (AU) payments capability of the account, or whether the account can directly process BECS Direct Debit (AU) charges.
273              
274             =item C<bacs_debit_payments> string
275              
276             The status of the Bacs Direct Debits payments capability of the account, or whether the account can directly process Bacs Direct Debits charges.
277              
278             =item C<bancontact_payments> string
279              
280             The status of the Bancontact payments capability of the account, or whether the account can directly process Bancontact charges.
281              
282             =item C<bank_transfer_payments> string
283              
284             The status of the customerI<balance payments capability of the account, or whether the account can directly process customer>balance charges.
285              
286             =item C<blik_payments> string
287              
288             The status of the blik payments capability of the account, or whether the account can directly process blik charges.
289              
290             =item C<boleto_payments> string
291              
292             The status of the boleto payments capability of the account, or whether the account can directly process boleto charges.
293              
294             =item C<card_issuing> string
295              
296             The status of the card issuing capability of the account, or whether you can use Issuing to distribute funds on cards
297              
298             =item C<card_payments> string
299              
300             The status of the card payments capability of the account, or whether the account can directly process credit and debit card charges.
301              
302             =item C<cartes_bancaires_payments> string
303              
304             The status of the Cartes Bancaires payments capability of the account, or whether the account can directly process Cartes Bancaires card charges in EUR currency.
305              
306             =item C<eps_payments> string
307              
308             The status of the EPS payments capability of the account, or whether the account can directly process EPS charges.
309              
310             =item C<fpx_payments> string
311              
312             The status of the FPX payments capability of the account, or whether the account can directly process FPX charges.
313              
314             =item C<giropay_payments> string
315              
316             The status of the giropay payments capability of the account, or whether the account can directly process giropay charges.
317              
318             =item C<grabpay_payments> string
319              
320             The status of the GrabPay payments capability of the account, or whether the account can directly process GrabPay charges.
321              
322             =item C<ideal_payments> string
323              
324             The status of the iDEAL payments capability of the account, or whether the account can directly process iDEAL charges.
325              
326             =item C<jcb_payments> string
327              
328             The status of the JCB payments capability of the account, or whether the account (Japan only) can directly process JCB credit card charges in JPY currency.
329              
330             =item C<klarna_payments> string
331              
332             The status of the Klarna payments capability of the account, or whether the account can directly process Klarna charges.
333              
334             =item C<konbini_payments> string
335              
336             The status of the konbini payments capability of the account, or whether the account can directly process konbini charges.
337              
338             =item C<legacy_payments> string
339              
340             The status of the legacy payments capability of the account.
341              
342             =item C<link_payments> string
343              
344             The status of the link_payments capability of the account, or whether the account can directly process Link charges.
345              
346             =item C<oxxo_payments> string
347              
348             The status of the OXXO payments capability of the account, or whether the account can directly process OXXO charges.
349              
350             =item C<p24_payments> string
351              
352             The status of the P24 payments capability of the account, or whether the account can directly process P24 charges.
353              
354             =item C<paynow_payments> string
355              
356             The status of the paynow payments capability of the account, or whether the account can directly process paynow charges.
357              
358             =item C<promptpay_payments> string
359              
360             The status of the promptpay payments capability of the account, or whether the account can directly process promptpay charges.
361              
362             =item C<sepa_debit_payments> string
363              
364             The status of the SEPA Direct Debits payments capability of the account, or whether the account can directly process SEPA Direct Debits charges.
365              
366             =item C<sofort_payments> string
367              
368             The status of the Sofort payments capability of the account, or whether the account can directly process Sofort charges.
369              
370             =item C<tax_reporting_us_1099_k> string
371              
372             The status of the tax reporting 1099-K (US) capability of the account.
373              
374             =item C<tax_reporting_us_1099_misc> string
375              
376             The status of the tax reporting 1099-MISC (US) capability of the account.
377              
378             =item C<transfers> string
379              
380             The status of the transfers capability of the account, or whether your platform can transfer funds to the account.
381              
382             =item C<us_bank_account_ach_payments> string
383              
384             The status of the US bank account ACH payments capability of the account, or whether the account can directly process US bank account charges.
385              
386             =back
387              
388             =head2 charges_enabled boolean
389              
390             Whether the account can create live charges.
391              
392             =head2 company custom only hash
393              
394             Information about the company or business. This field is null unless business_type is set to company.
395              
396             This is a L<Net::API::Stripe::Connect::Account::Company> object.
397              
398             =head2 controller hash
399              
400             The controller of the account.
401              
402             It has the following properties:
403              
404             =over 4
405              
406             =item C<is_controller> boolean
407              
408             C<true> if the Connect application retrieving the resource controls the account and can therefore exercise L<platform controls|https://stripe.com/docs/connect/platform-controls-for-standard-accounts>. Otherwise, this field is null.
409              
410             =item C<type> string
411              
412             The controller type. Can be C<application>, if a Connect application controls the account, or C<account>, if the account controls itself.
413              
414             =back
415              
416             =head2 country string
417              
418             The account’s country.
419              
420             =head2 created custom and express timestamp
421              
422             Time at which the object was created. Measured in seconds since the Unix epoch. This is a C<DateTime> object.
423              
424             =head2 debit_negative_balances
425              
426             This is outdated. It now points to B<settings>->B<payouts>->B<debit_negative_balances>
427              
428             =head2 decline_charge_on
429              
430             This is outdated. It now points to B<settings>->B<card_payments>->B<decline_on>
431              
432             =head2 default_currency string
433              
434             Three-letter ISO currency code representing the default currency for the account. This must be a currency that Stripe supports in the account’s country.
435              
436             =head2 details_submitted boolean
437              
438             Whether account details have been submitted. Standard accounts cannot receive payouts before this is true.
439              
440             =head2 display_name
441              
442             This is outdated. It now points to B<settings>->B<dashboard>->B<display_name>
443              
444             =head2 email string
445              
446             The primary user’s email address.
447              
448             =head2 external_accounts custom and express list
449              
450             External accounts (bank accounts and debit cards) currently attached to this account
451              
452             This is a L<Net::API::Stripe::Connect::Account::ExternalAccounts> object.
453              
454             =head2 future_requirements object
455              
456             Information about the upcoming new requirements for the account, including what information needs to be collected, and by when.
457              
458             This is a L<Net::API::Stripe::Connect::Account::Requirements> object.
459              
460             =head2 individual custom only hash
461              
462             Information about the person represented by the account. This field is null unless business_type is set to individual.
463              
464             This is a L<Net::API::Stripe::Connect::Person> object.
465              
466             =head2 legal_entity
467              
468             This is outdated. Stripe now uses a L<Net::API::Stripe::Connect::Account::Company> object and a L<Net::API::Stripe::Connect::Person> object.
469              
470             =head2 metadata hash
471              
472             Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
473              
474             =head2 payout_schedule
475              
476             This is outdated. It now points to B<settings>->B<payouts>->B<schedule>
477              
478             =head2 payout_statement_descriptor
479              
480             This is outdated. It now points to B<settings>->B<payouts>->B<statement_descriptor>
481              
482             =head2 payouts_enabled boolean
483              
484             Whether Stripe can send payouts to this account.
485              
486             =head2 product_description
487              
488             This is outdated. It now points to B<business_profile>->B<product_description>
489              
490             =head2 requirements custom and express hash
491              
492             Information about the requirements for the account, including what information needs to be collected, and by when.
493              
494             This is a L<Net::API::Stripe::Connect::Account::Requirements> object.
495              
496             =head2 settings hash
497              
498             Options for customizing how the account functions within Stripe.
499              
500             This is a L<Net::API::Stripe::Connect::Account::Settings> object.
501              
502             =head2 statement_descriptor
503              
504             This is outdated. It now points to B<settings>->B<payments>->B<statement_descriptor>
505              
506             =head2 support_address
507              
508             This is outdated. It now points to B<business_profile>->B<support_address>
509              
510             =head2 support_email
511              
512             This is outdated. It now points to B<business_profile>->B<support_email>
513              
514             =head2 support_phone
515              
516             This is outdated. It now points to B<business_profile>->B<support_phone>
517              
518             =head2 support_url
519              
520             This is outdated. It now points to B<business_profile>->B<support_url>
521              
522             =head2 timezone
523              
524             This is outdated. It is a C<DateTime> object.
525              
526             =head2 tos_acceptance custom only hash
527              
528             Details on the acceptance of the Stripe Services Agreement
529              
530             This is a L<Net::API::Stripe::Connect::Account::TosAcceptance> object.
531              
532             =head2 type string
533              
534             The Stripe account type. Can be standard, express, or custom.
535              
536             =head2 verification
537              
538             This is outdated. It is a L<Net::API::Stripe::Connect::Account::Verification> object.
539              
540             =head1 API SAMPLE
541              
542             =head2 Response Standard
543              
544             {
545             "id": "acct_fake123456789",
546             "object": "account",
547             "business_profile": {
548             "mcc": null,
549             "name": "My Shop, Inc",
550             "product_description": "Great products shipping all over the world",
551             "support_address": {
552             "city": "Tokyo",
553             "country": "JP",
554             "line1": "1-2-3 Kudan-minami, Chiyoda-ku",
555             "line2": "",
556             "postal_code": "100-0012",
557             "state": ""
558             },
559             "support_email": "billing@example.com",
560             "support_phone": "+81312345678",
561             "support_url": "",
562             "url": "https://www.example.com"
563             },
564             "business_type": "company",
565             "capabilities": {
566             "card_payments": "active"
567             },
568             "charges_enabled": true,
569             "country": "JP",
570             "default_currency": "jpy",
571             "details_submitted": true,
572             "email": "tech@example.com",
573             "metadata": {},
574             "payouts_enabled": true,
575             "settings": {
576             "branding": {
577             "icon": "file_fake123456789",
578             "logo": null,
579             "primary_color": "#0e77ca"
580             },
581             "card_payments": {
582             "decline_on": {
583             "avs_failure": false,
584             "cvc_failure": false
585             },
586             "statement_descriptor_prefix": null
587             },
588             "dashboard": {
589             "display_name": "myshop-inc",
590             "timezone": "Asia/Tokyo"
591             },
592             "payments": {
593             "statement_descriptor": "MYSHOP, INC",
594             "statement_descriptor_kana": "マイショップインク",
595             "statement_descriptor_kanji": "マイショップインク"
596             },
597             "payouts": {
598             "debit_negative_balances": true,
599             "schedule": {
600             "delay_days": 4,
601             "interval": "weekly",
602             "weekly_anchor": "thursday"
603             },
604             "statement_descriptor": null
605             }
606             },
607             "type": "standard"
608             }
609              
610             =head2 Response Express
611              
612             {
613             "id": "acct_19eGgRCeyNCl6xYZ",
614             "object": "account",
615             "business_profile": {
616             "mcc": null,
617             "name": "MyShop, Inc",
618             "product_description": "Great products shipping all over the world",
619             "support_address": {
620             "city": "Tokyo",
621             "country": "JP",
622             "line1": "1-2-3 Kudan-minami, Chiyoda-ku",
623             "line2": "",
624             "postal_code": "100-0012",
625             "state": ""
626             },
627             "support_email": "billing@example.com",
628             "support_phone": "+81312345678",
629             "support_url": "",
630             "url": "https://www.example.com"
631             },
632             "business_type": "company",
633             "capabilities": {
634             "card_payments": "active"
635             },
636             "charges_enabled": true,
637             "country": "JP",
638             "created": 1484973659,
639             "default_currency": "jpy",
640             "details_submitted": true,
641             "email": "tech@example.com",
642             "external_accounts": {
643             "object": "list",
644             "data": [
645             {
646             "id": "ba_19eGy1CeyNCl6fY2R3ACmqG4",
647             "object": "bank_account",
648             "account": "acct_19eGgRCeyNCl6xYZ",
649             "account_holder_name": "カ)マイショップインク",
650             "account_holder_type": null,
651             "bank_name": "三井住友銀行",
652             "country": "JP",
653             "currency": "jpy",
654             "default_for_currency": true,
655             "fingerprint": "VWINqgzE0zu5x1ab",
656             "last4": "1234",
657             "metadata": {},
658             "routing_number": "0009218",
659             "status": "new"
660             }
661             ],
662             "has_more": false,
663             "url": "/v1/accounts/acct_19eGgRCeyNCl6xYZ/external_accounts"
664             },
665             "metadata": {},
666             "payouts_enabled": true,
667             "requirements": {
668             "current_deadline": null,
669             "currently_due": [],
670             "disabled_reason": null,
671             "eventually_due": [],
672             "past_due": [],
673             "pending_verification": []
674             },
675             "settings": {
676             "branding": {
677             "icon": "file_1DLf5rCeyNCl6fY2kS4e1xyz",
678             "logo": null,
679             "primary_color": "#0e77ca"
680             },
681             "card_payments": {
682             "decline_on": {
683             "avs_failure": false,
684             "cvc_failure": false
685             },
686             "statement_descriptor_prefix": null
687             },
688             "dashboard": {
689             "display_name": "myshop-inc",
690             "timezone": "Asia/Tokyo"
691             },
692             "payments": {
693             "statement_descriptor": "MYSHOP, INC",
694             "statement_descriptor_kana": "マイショップインク",
695             "statement_descriptor_kanji": "マイショップインク"
696             },
697             "payouts": {
698             "debit_negative_balances": true,
699             "schedule": {
700             "delay_days": 4,
701             "interval": "weekly",
702             "weekly_anchor": "thursday"
703             },
704             "statement_descriptor": null
705             }
706             },
707             "type": "express"
708             }
709              
710             =head2 Response Custom
711              
712             {
713             "id": "acct_19eGgRCeyNCl6xYZ",
714             "object": "account",
715             "business_profile": {
716             "mcc": null,
717             "name": "MyShop, Inc",
718             "product_description": "Great products shipping all over the world",
719             "support_address": {
720             "city": "Tokyo",
721             "country": "JP",
722             "line1": "1-2-3 Kudan-minami, Chiyoda-ku",
723             "line2": "",
724             "postal_code": "100-0012",
725             "state": ""
726             },
727             "support_email": "billing@example.com",
728             "support_phone": "+81312345678",
729             "support_url": "",
730             "url": "https://www.example.com"
731             },
732             "business_type": "company",
733             "capabilities": {
734             "card_payments": "active"
735             },
736             "charges_enabled": true,
737             "company": {
738             "address_kana": {
739             "city": "チヨダク",
740             "country": "JP",
741             "line1": "2-3",
742             "line2": "ナシ",
743             "postal_code": null,
744             "state": null,
745             "town": "クダンミナミ1"
746             },
747             "address_kanji": {
748             "city": "千代田区",
749             "country": "JP",
750             "line1": "",
751             "line2": "",
752             "postal_code": null,
753             "state": null,
754             "town": "九段南1-2-3"
755             },
756             "directors_provided": false,
757             "name": "MyShop, Inc",
758             "name_kana": "カブシキカイシャマイショップインク",
759             "name_kanji": "株式会社マイショップインク",
760             "owners_provided": true,
761             "phone": null,
762             "tax_id_provided": true,
763             "verification": {
764             "document": {
765             "back": null,
766             "details": null,
767             "details_code": null,
768             "front": null
769             }
770             }
771             },
772             "country": "JP",
773             "created": 1484973659,
774             "default_currency": "jpy",
775             "details_submitted": true,
776             "email": "tech@example.com",
777             "external_accounts": {
778             "object": "list",
779             "data": [
780             {
781             "id": "ba_19eGy1CeyNCl6fY2R3ACmqG4",
782             "object": "bank_account",
783             "account": "acct_19eGgRCeyNCl6xYZ",
784             "account_holder_name": "カ)マイショップインク",
785             "account_holder_type": null,
786             "bank_name": "三井住友銀行",
787             "country": "JP",
788             "currency": "jpy",
789             "default_for_currency": true,
790             "fingerprint": "VkINqgzE0zu5x1xw",
791             "last4": "2235",
792             "metadata": {},
793             "routing_number": "0009218",
794             "status": "new"
795             }
796             ],
797             "has_more": false,
798             "url": "/v1/accounts/acct_19eGgRCeyNCl6xYZ/external_accounts"
799             },
800             "metadata": {},
801             "payouts_enabled": true,
802             "requirements": {
803             "current_deadline": null,
804             "currently_due": [],
805             "disabled_reason": null,
806             "eventually_due": [],
807             "past_due": [],
808             "pending_verification": []
809             },
810             "settings": {
811             "branding": {
812             "icon": "file_1DLf5rCeyabl6fY2kS4e5xyz",
813             "logo": null,
814             "primary_color": "#0e77ca"
815             },
816             "card_payments": {
817             "decline_on": {
818             "avs_failure": false,
819             "cvc_failure": false
820             },
821             "statement_descriptor_prefix": null
822             },
823             "dashboard": {
824             "display_name": "myshop-inc",
825             "timezone": "Asia/Tokyo"
826             },
827             "payments": {
828             "statement_descriptor": "MYSHOP, IN",
829             "statement_descriptor_kana": "マイショップインク",
830             "statement_descriptor_kanji": "マイショップインク"
831             },
832             "payouts": {
833             "debit_negative_balances": true,
834             "schedule": {
835             "delay_days": 4,
836             "interval": "weekly",
837             "weekly_anchor": "thursday"
838             },
839             "statement_descriptor": null
840             }
841             },
842             "tos_acceptance": {
843             "date": 1484979187,
844             "ip": "114.17.230.189",
845             "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.87 Safari/537.36"
846             },
847             "type": "custom"
848             }
849              
850             =head1 HISTORY
851              
852             =head2 v0.1
853              
854             Initial version
855              
856             =head1 STRIPE HISTORY
857              
858             =head2 2019-02-19
859              
860             Statement descriptor behaviors for card payments created via /v1/charges have changed. See L<Stripe statement descriptor guide|https://stripe.com/docs/statement-descriptors> for details.
861              
862             =over 4
863              
864             =item * Instead of using the platform's statement descriptor, charges created with on_behalf_of or destination will now use the descriptor of the connected account.
865              
866             ~item * The full statement descriptor for a card payment may no longer be provided at charge creation. Dynamic descriptors provided at charge time will now be prefixed by the descriptor prefix set in the dashboard or via the new settings[card_payments][statement_descriptor_prefix] parameter in the Accounts API.
867              
868             =item * If an account has no statement_descriptor set, the account's business or legal name will be used as statement descriptor.
869              
870             =item * Statement descriptors may no longer contain *, ', and ".
871              
872             =back
873              
874             =head2 2019-02-19
875              
876             Many properties on the Account API object have been reworked. To see a mapping of the old argument names to the new ones, see Accounts API Argument Changes.
877              
878             =over 4
879              
880             =item * The legal_entity property on the Account API resource has been replaced with individual, company, and business_type.
881              
882             =item * The verification hash has been replaced with a requirements hash.
883              
884             =over 4
885              
886             =item * The verification[fields_needed] array has been replaced with three arrays to better represent when info is required: requirements[eventually_due], requirements[currently_due], and requirements[past_due].
887              
888             =item * verification[due_by] has been renamed to requirements[current_deadline].
889              
890             =item * The disabled_reason enum value of fields_needed has been renamed to requirements.past_due.
891              
892             =back
893              
894             =item * Properties on the Account API object that configure behavior within Stripe have been moved into the new settings hash.
895              
896             =over 4
897              
898             =item * The payout_schedule, payout_statement_descriptor and debit_negative_balances fields have been moved to settings[payouts] and renamed to schedule, statement_descriptor and debit_negative_balances.
899              
900             =item * The statement_descriptor field has been moved to settings[payments][statement_descriptor].
901              
902             =item * The decline_charge_on fields have been moved to settings[card_payments] and renamed to decline_on.
903              
904             =item * The business_logo, business_logo_large and business_primary_color fields have been moved to settings[branding] and renamed to icon, logo and primary_color. The icon field additionally requires the uploaded image file to be square.
905              
906             =item * The display_name and timezone fields have been moved to settings[dashboard].
907              
908             =back
909              
910             =item * business_name, business_url, product_description, support_address, support_email, support_phone and support_url have been moved to the business_profile subhash.
911              
912             =item * The legal_entity[verification][document] property (now located at individual[verification] and at verification in the Person API object) has been changed to a hash.
913              
914             =over 4
915              
916             =item * The front and back fields support uploading both sides of documents.
917              
918             =item * The details_code field has new error types: document_corrupt, document_failed_copy, document_failed_greyscale, document_failed_other, document_failed_test_mode, document_fraudulent, document_id_country_not_supported, document_id_type_not_supported, document_invalid, document_manipulated, document_missing_back, document_missing_front, document_not_readable, document_not_uploaded, document_photo_mismatch, and document_too_large.
919              
920             =item * The keys property on Account creation has been removed. Platforms should now authenticate as their connected accounts with their own key via the Stripe-Account header.
921              
922             =item * Starting with the 2019-02-19 API, the requested_capabilities property is now required at creation time for accounts in the U.S. See the Capabilities Overview for more information.
923              
924             =back
925              
926             =back
927              
928             =head2 2017-05-25
929              
930             Replaces the managed Boolean property on Account objects with type, whose possible values are: standard, express, and custom. A managed value is required when creating accounts.
931              
932             =head1 AUTHOR
933              
934             Jacques Deguest E<lt>F<jack@deguest.jp>E<gt>
935              
936             =head1 SEE ALSO
937              
938             Stripe API documentation:
939              
940             L<https://stripe.com/docs/api>
941              
942             =head1 COPYRIGHT & LICENSE
943              
944             Copyright (c) 2019-2020 DEGUEST Pte. Ltd.
945              
946             You can use, copy, modify and redistribute this package and associated
947             files under the same terms as Perl itself.
948              
949             =cut