File Coverage

lib/Net/API/Stripe/Issuing/MerchantData.pm
Criterion Covered Total %
statement 19 28 67.8
branch n/a
condition n/a
subroutine 7 16 43.7
pod 9 9 100.0
total 35 53 66.0


line stmt bran cond sub pod time code
1             ##----------------------------------------------------------------------------
2             ## Stripe API - ~/lib/Net/API/Stripe/Issuing/MerchantData.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             package Net::API::Stripe::Issuing::MerchantData;
11             BEGIN
12             {
13 2     2   21170641 use strict;
  2         15  
  2         62  
14 2     2   12 use warnings;
  2         4  
  2         59  
15 2     2   10 use parent qw( Net::API::Stripe::Generic );
  2         5  
  2         9  
16 2     2   146 use vars qw( $VERSION );
  2         5  
  2         181  
17 2     2   56 our( $VERSION ) = 'v0.101.0';
18             };
19              
20 2     2   14 use strict;
  2         3  
  2         42  
21 2     2   9 use warnings;
  2         3  
  2         466  
22              
23 0     0 1   sub category { return( shift->_set_get_scalar( 'category', @_ ) ); }
24              
25 0     0 1   sub category_code { return( CORE::shift->_set_get_scalar( 'category_code', @_ ) ); }
26              
27 0     0 1   sub city { return( shift->_set_get_scalar( 'city', @_ ) ); }
28              
29 0     0 1   sub country { return( shift->_set_get_scalar( 'country', @_ ) ); }
30              
31 0     0 1   sub name { return( shift->_set_get_scalar( 'name', @_ ) ); }
32              
33 0     0 1   sub network_id { return( shift->_set_get_scalar( 'network_id', @_ ) ); }
34              
35 0     0 1   sub postal_code { return( shift->_set_get_scalar( 'postal_code', @_ ) ); }
36              
37 0     0 1   sub state { return( shift->_set_get_scalar( 'state', @_ ) ); }
38              
39 0     0 1   sub url { return( shift->_set_get_uri( 'url', @_ ) ); }
40              
41             1;
42              
43             __END__
44              
45             =encoding utf8
46              
47             =head1 NAME
48              
49             Net::API::Stripe::Issuing::MerchantData - A Stripe Merchant Data Object
50              
51             =head1 SYNOPSIS
52              
53             my $data = $stripe->authorization->merchant_data({
54             # https://stripe.com/docs/issuing/categories
55             category => '8111',
56             city => 'Tokyo',
57             country => 'jp',
58             name => 'Big Corp, Inc',
59             network_id => $some_id,
60             postal_code => '123-4567',
61             state => undef,
62             url => 'https://store.example.com/12/service/advisory',
63             });
64              
65             =head1 VERSION
66              
67             v0.101.0
68              
69             =head1 DESCRIPTION
70              
71             This is used in L<Net::API::Stripe::Issuing::Authorization> object.
72              
73             This is instantiated by method B<merchant_data> in module L<Net::API::Stripe::Issuing::Authorization>, L<Net::API::Stripe::Issuing::Authorization::Transaction> and L<Net::API::Stripe::Issuing::Transaction>
74              
75             =head1 CONSTRUCTOR
76              
77             =head2 new( %ARG )
78              
79             Creates a new L<Net::API::Stripe::Issuing::MerchantData> object.
80             It may also take an hash like arguments, that also are method of the same name.
81              
82             =head1 METHODS
83              
84             =head2 category string
85              
86             A categorization of the seller’s type of business. See Stripe merchant categories guide (L<https://stripe.com/docs/issuing/categories>) for a list of possible values.
87              
88             =head2 category_code string
89              
90             The merchant category code for the seller’s business
91              
92             =head2 city string
93              
94             City where the seller is located
95              
96             =head2 country string
97              
98             Country where the seller is located
99              
100             =head2 name string
101              
102             Name of the seller
103              
104             =head2 network_id string
105              
106             Identifier assigned to the seller by the card brand
107              
108             =head2 postal_code string
109              
110             Postal code where the seller is located
111              
112             =head2 state string
113              
114             State where the seller is located
115              
116             =head2 url string
117              
118             The url an online purchase was made from
119              
120             =head1 API SAMPLE
121              
122             {
123             "id": "iauth_fake123456789",
124             "object": "issuing.authorization",
125             "approved": true,
126             "authorization_method": "online",
127             "authorized_amount": 500,
128             "authorized_currency": "usd",
129             "balance_transactions": [],
130             "card": null,
131             "cardholder": null,
132             "created": 1540642827,
133             "held_amount": 0,
134             "held_currency": "usd",
135             "is_held_amount_controllable": false,
136             "livemode": false,
137             "merchant_data": {
138             "category": "taxicabs_limousines",
139             "city": "San Francisco",
140             "country": "US",
141             "name": "Rocket Rides",
142             "network_id": "1234567890",
143             "postal_code": "94107",
144             "state": "CA",
145             "url": null
146             },
147             "metadata": {},
148             "pending_authorized_amount": 0,
149             "pending_held_amount": 0,
150             "request_history": [],
151             "status": "reversed",
152             "transactions": [
153             {
154             "id": "ipi_fake123456789",
155             "object": "issuing.transaction",
156             "amount": -100,
157             "authorization": "iauth_fake123456789",
158             "balance_transaction": null,
159             "card": "ic_fake123456789",
160             "cardholder": null,
161             "created": 1540642827,
162             "currency": "usd",
163             "dispute": null,
164             "livemode": false,
165             "merchant_amount": null,
166             "merchant_currency": null,
167             "merchant_data": {
168             "category": "taxicabs_limousines",
169             "city": "San Francisco",
170             "country": "US",
171             "name": "Rocket Rides",
172             "network_id": "1234567890",
173             "postal_code": "94107",
174             "state": "CA",
175             "url": null
176             },
177             "metadata": {},
178             "type": "capture"
179             },
180             {
181             "id": "ipi_fake123456789",
182             "object": "issuing.transaction",
183             "amount": -100,
184             "authorization": "iauth_fake123456789",
185             "balance_transaction": null,
186             "card": "ic_fake123456789",
187             "cardholder": null,
188             "created": 1540642827,
189             "currency": "usd",
190             "dispute": null,
191             "livemode": false,
192             "merchant_amount": null,
193             "merchant_currency": null,
194             "merchant_data": {
195             "category": "taxicabs_limousines",
196             "city": "San Francisco",
197             "country": "US",
198             "name": "Rocket Rides",
199             "network_id": "1234567890",
200             "postal_code": "94107",
201             "state": "CA",
202             "url": null
203             },
204             "metadata": {},
205             "type": "capture"
206             }
207             ],
208             "verification_data": {
209             "address_line1_check": "not_provided",
210             "address_zip_check": "match",
211             "authentication": "none",
212             "cvc_check": "match"
213             },
214             "wallet_provider": null
215             }
216              
217             =head1 HISTORY
218              
219             =head2 v0.1
220              
221             Initial version
222              
223             =head1 AUTHOR
224              
225             Jacques Deguest E<lt>F<jack@deguest.jp>E<gt>
226              
227             =head1 SEE ALSO
228              
229             Stripe API documentation:
230              
231             L<https://stripe.com/docs/api>
232              
233             =head1 COPYRIGHT & LICENSE
234              
235             Copyright (c) 2019-2020 DEGUEST Pte. Ltd.
236              
237             You can use, copy, modify and redistribute this package and associated
238             files under the same terms as Perl itself.
239              
240             =cut