remove debugging (tax-exempt numbers during signup, RT#32299)
[freeside.git] / FS / FS / ClientAPI / Signup.pm
1 package FS::ClientAPI::Signup;
2
3 use strict;
4 use vars qw( $DEBUG $me );
5 use Data::Dumper;
6 use Tie::RefHash;
7 use FS::Conf;
8 use FS::Record qw(qsearch qsearchs dbdef);
9 use FS::CGI qw(popurl);
10 use FS::Msgcat qw(gettext);
11 use FS::Misc qw(card_types);
12 use FS::ClientAPI_SessionCache;
13 use FS::agent;
14 use FS::cust_main_county;
15 use FS::part_pkg;
16 use FS::svc_acct_pop;
17 use FS::cust_main;
18 use FS::cust_pkg;
19 use FS::svc_acct;
20 use FS::svc_phone;
21 use FS::acct_snarf;
22 use FS::queue;
23 use FS::reg_code;
24 use FS::payby;
25 use FS::banned_pay;
26
27 $DEBUG = 0;
28 $me = '[FS::ClientAPI::Signup]';
29
30 sub clear_cache {
31   warn "$me clear_cache called\n" if $DEBUG;
32   my $cache = new FS::ClientAPI_SessionCache( {
33       'namespace' => 'FS::ClientAPI::Signup',
34   } );
35   $cache->clear();
36   return {};
37 }
38
39 sub signup_info {
40   my $packet = shift;
41
42   warn "$me signup_info called on $packet\n" if $DEBUG;
43
44   my $conf = new FS::Conf;
45   my $svc_x = $conf->config('signup_server-service') || 'svc_acct';
46
47   my $cache = new FS::ClientAPI_SessionCache( {
48     'namespace' => 'FS::ClientAPI::Signup',
49   } );
50   my $signup_info_cache = $cache->get('signup_info_cache');
51
52   if ( $signup_info_cache ) {
53
54     warn "$me loading cached signup info\n" if $DEBUG > 1;
55
56   } else {
57
58     warn "$me populating signup info cache\n" if $DEBUG > 1;
59
60     my $agentnum2part_pkg = 
61       {
62         map {
63           my $agent = $_;
64           my $href = $agent->pkgpart_hashref;
65           $agent->agentnum =>
66             [
67               map { { 'payby'       => [ $_->payby ],
68                       'freq_pretty' => $_->freq_pretty,
69                       'options'     => { $_->options },
70                       %{$_->hashref}
71                   } }
72                 grep { $_->svcpart($svc_x)
73                        && ( $href->{ $_->pkgpart }
74                             || ( $_->agentnum
75                                  && $_->agentnum == $agent->agentnum
76                                )
77                           )
78                      }
79                   qsearch( 'part_pkg', { 'disabled' => '' } )
80             ];
81         } qsearch('agent', { 'disabled' => '' })
82       };
83
84     my $msgcat = { map { $_=>gettext($_) }
85                        qw( passwords_dont_match invalid_card unknown_card_type
86                            not_a empty_password illegal_or_empty_text )
87                  };
88     warn "msgcat: ". Dumper($msgcat). "\n" if $DEBUG > 2;
89
90     my $label = { map { $_ => FS::Msgcat::_gettext($_) }
91                       qw( stateid stateid_state )
92                 };
93     warn "label: ". Dumper($label). "\n" if $DEBUG > 2;
94
95     my @agent_fields = qw( agentnum agent );
96
97     my @bools = qw( emailinvoiceonly security_phrase );
98
99     my @signup_bools = qw( no_company recommend_daytime recommend_email );
100
101     my @signup_server_scalars = qw( default_pkgpart default_svcpart default_domsvc );
102
103     my @selfservice_textareas = qw( head body_header body_footer );
104
105     my @selfservice_scalars = qw(
106       body_bgcolor box_bgcolor
107       text_color link_color vlink_color hlink_color alink_color
108       font title_color title_align title_size menu_bgcolor menu_fontsize
109     );
110
111     #XXX my @selfservice_bools = qw(
112     #  menu_skipblanks menu_skipheadings menu_nounderline
113     #);
114
115     #my $selfservice_binaries = qw(
116     #  title_left_image title_right_image
117     #  menu_top_image menu_body_image menu_bottom_image
118     #);
119
120     $signup_info_cache = {
121
122       'cust_main_county' => [ map $_->hashref,
123                                   qsearch('cust_main_county', {} )
124                             ],
125
126       'agent' => [ map { my $agent = $_;
127                          +{ map { $_ => $agent->get($_) } @agent_fields }
128                        }
129                        qsearch('agent', { 'disabled' => '' } )
130                  ],
131
132       'part_referral' => [ map $_->hashref,
133                                qsearch('part_referral', { 'disabled' => '' } )
134                          ],
135
136       'agentnum2part_pkg' => $agentnum2part_pkg,
137
138       'svc_acct_pop' => [ map $_->hashref, qsearch('svc_acct_pop',{} ) ],
139
140       'emailinvoiceonly' => $conf->exists('emailinvoiceonly'),
141
142       'security_phrase' => $conf->exists('security_phrase'),
143
144       'nomadix' => $conf->exists('signup_server-nomadix'),
145
146       'payby' => [ $conf->config('signup_server-payby') ],
147
148       'payby_longname' => [ map { FS::payby->longname($_) } 
149                             $conf->config('signup_server-payby') ],
150
151       'card_types' => card_types(),
152
153       ( map { $_ => $conf->exists("signup-$_") } @signup_bools ),
154
155       ( map { $_ => scalar($conf->config("signup_server-$_")) }
156             @signup_server_scalars
157       ),
158
159       ( map { $_ => join("\n", $conf->config("selfservice-$_")) }
160             @selfservice_textareas
161       ),
162       ( map { $_ => scalar($conf->config("selfservice-$_")) }
163             @selfservice_scalars
164       ),
165
166       #( map { $_ => scalar($conf->config_binary("selfservice-$_")) }
167       #      @selfservice_binaries
168       #),
169
170       'agentnum2part_pkg'  => $agentnum2part_pkg,
171       'svc_acct_pop'       => [ map $_->hashref, qsearch('svc_acct_pop',{} ) ],
172       'nomadix'            => $conf->exists('signup_server-nomadix'),
173       'payby'              => [ $conf->config('signup_server-payby') ],
174       'card_types'         => card_types(),
175       'paytypes'           => [ @FS::cust_main::paytypes ],
176       'cvv_enabled'        => 1,
177       'require_cvv'        => $conf->exists('signup-require_cvv'),
178       'stateid_enabled'    => $conf->exists('show_stateid'),
179       'paystate_enabled'   => $conf->exists('show_bankstate'),
180       'exempt_groups'      => [ grep /\S/, $conf->config('tax-cust_exempt-groups') ],
181       'ship_enabled'       => 1,
182       'msgcat'             => $msgcat,
183       'label'              => $label,
184       'statedefault'       => scalar($conf->config('statedefault')) || 'CA',
185       'countrydefault'     => scalar($conf->config('countrydefault')) || 'US',
186       'refnum'             => scalar($conf->config('signup_server-default_refnum')),
187       'signup_service'     => $svc_x,
188       'company_name'       => scalar($conf->config('company_name')),
189       #per-agent?
190       'logo'               => scalar($conf->config_binary('logo.png')),
191       'prepaid_template_custnum' => $conf->exists('signup_server-prepaid-template-custnum'),
192     };
193
194     $cache->set('signup_info_cache', $signup_info_cache);
195
196   }
197
198   my $signup_info = { %$signup_info_cache };
199   warn "$me signup info loaded\n" if $DEBUG > 1;
200   warn Dumper($signup_info). "\n" if $DEBUG > 2;
201
202   my @addl = qw( signup_server-classnum2 signup_server-classnum3 );
203
204   if ( grep { $conf->exists($_) } @addl ) {
205   
206     $signup_info->{optional_packages} = [];
207
208     foreach my $addl ( @addl ) {
209
210       warn "$me adding optional package info\n" if $DEBUG > 1;
211
212       my $classnum = $conf->config($addl) or next;
213
214       my @pkgs = map { {
215                          'freq_pretty' => $_->freq_pretty,
216                          'options'     => { $_->options },
217                          %{ $_->hashref }
218                        };
219                      }
220                      qsearch( 'part_pkg', { classnum => $classnum } );
221
222       push @{$signup_info->{optional_packages}}, \@pkgs;
223
224       warn "$me done adding opt. package info for $classnum\n" if $DEBUG > 1;
225
226     }
227
228   }
229
230   my $agentnum = $packet->{'agentnum'}
231                  || $conf->config('signup_server-default_agentnum');
232   $agentnum =~ /^(\d*)$/ or die "illegal agentnum";
233   $agentnum = $1;
234
235   my $session = '';
236   if ( exists $packet->{'session_id'} ) {
237
238     warn "$me loading agent session\n" if $DEBUG > 1;
239     my $cache = new FS::ClientAPI_SessionCache( {
240       'namespace' => 'FS::ClientAPI::Agent',
241     } );
242     $session = $cache->get($packet->{'session_id'});
243     if ( $session ) {
244       $agentnum = $session->{'agentnum'};
245     } else {
246       return { 'error' => "Can't resume session" }; #better error message
247     }
248     warn "$me done loading agent session\n" if $DEBUG > 1;
249
250   } elsif ( exists $packet->{'customer_session_id'} ) {
251
252     warn "$me loading customer session\n" if $DEBUG > 1;
253     my $cache = new FS::ClientAPI_SessionCache( {
254       'namespace' => 'FS::ClientAPI::MyAccount',
255     } );
256     $session = $cache->get($packet->{'customer_session_id'});
257     if ( $session ) {
258       my $custnum = $session->{'custnum'};
259       my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum });
260       return { 'error' => "Can't find your customer record" } unless $cust_main;
261       $agentnum = $cust_main->agentnum;
262     } else {
263       return { 'error' => "Can't resume session" }; #better error message
264     }
265     warn "$me done loading customer session\n" if $DEBUG > 1;
266
267   }
268
269   $signup_info->{'part_pkg'} = [];
270
271   if ( $packet->{'reg_code'} ) {
272
273     warn "$me setting package list via reg_code\n" if $DEBUG > 1;
274
275     $signup_info->{'part_pkg'} = 
276       [ map { { 'payby'       => [ $_->payby ],
277                 'freq_pretty' => $_->freq_pretty,
278                 'options'     => { $_->options },
279                 %{$_->hashref}
280               };
281             }
282           grep { $_->svcpart($svc_x) }
283           map { $_->part_pkg }
284             qsearchs( 'reg_code', { 'code'     => $packet->{'reg_code'},
285                                     'agentnum' => $agentnum,              } )
286
287       ];
288
289     $signup_info->{'error'} = 'Unknown registration code'
290       unless @{ $signup_info->{'part_pkg'} };
291
292     warn "$me done setting package list via reg_code\n" if $DEBUG > 1;
293
294   } elsif ( $packet->{'promo_code'} ) {
295
296     warn "$me setting package list via promo_code\n" if $DEBUG > 1;
297
298     $signup_info->{'part_pkg'} =
299       [ map { { 'payby'   => [ $_->payby ],
300                 'freq_pretty' => $_->freq_pretty,
301                 'options'     => { $_->options },
302                 %{$_->hashref}
303             } }
304           grep { $_->svcpart($svc_x) }
305             qsearch( 'part_pkg', { 'promo_code' => {
306                                      op=>'ILIKE',
307                                      value=>$packet->{'promo_code'}
308                                    },
309                                    'disabled'   => '',                  } )
310       ];
311
312     $signup_info->{'error'} = 'Unknown promotional code'
313       unless @{ $signup_info->{'part_pkg'} };
314
315     warn "$me done setting package list via promo_code\n" if $DEBUG > 1;
316   }
317
318   if ( $agentnum ) {
319
320     warn "$me setting agent-specific payment flag\n" if $DEBUG > 1;
321     my $agent = qsearchs('agent', { 'agentnum' => $agentnum } )
322       or return { 'error' => "Self-service agent #$agentnum does not exist" };
323     warn "$me has agent $agent\n" if $DEBUG > 1;
324     my @paybys = @{ $signup_info->{'payby'} };
325     $signup_info->{'hide_payment_fields'} = [];
326
327     my $gatewaynum = $conf->config('selfservice-payment_gateway');
328     my $force_gateway;
329     if ( $gatewaynum ) {
330       $force_gateway = qsearchs('payment_gateway', { gatewaynum => $gatewaynum });
331       warn "using forced gateway #$gatewaynum - " .
332         $force_gateway->gateway_username . '@' . $force_gateway->gateway_module
333         if $DEBUG > 1;
334       die "configured gatewaynum $gatewaynum not found!" if !$force_gateway;
335     }
336     foreach my $payby (@paybys) {
337       warn "$me checking $payby payment fields\n" if $DEBUG > 1;
338       my $hide = 0;
339       if ( FS::payby->realtime($payby) ) {
340         my $gateway = $force_gateway || 
341           $agent->payment_gateway( 'method'  => FS::payby->payby2bop($payby),
342                                    'nofatal' => 1,
343                                  );
344         if ( $gateway && $gateway->gateway_namespace
345                     eq 'Business::OnlineThirdPartyPayment'
346            ) {
347           warn "$me hiding $payby payment fields\n" if $DEBUG > 1;
348           $hide = 1;
349         }
350       }
351       push @{$signup_info->{'hide_payment_fields'}}, $hide;
352     } # foreach $payby
353     warn "$me done setting agent-specific payment flag\n" if $DEBUG > 1;
354
355     warn "$me setting agent-specific package list\n" if $DEBUG > 1;
356     $signup_info->{'part_pkg'} = $signup_info->{'agentnum2part_pkg'}{$agentnum}
357       unless @{ $signup_info->{'part_pkg'} };
358     warn "$me done setting agent-specific package list\n" if $DEBUG > 1;
359
360     warn "$me setting agent-specific adv. source list\n" if $DEBUG > 1;
361     $signup_info->{'part_referral'} =
362       [
363         map { $_->hashref }
364           qsearch( {
365                      'table'     => 'part_referral',
366                      'hashref'   => { 'disabled' => '' },
367                      'extra_sql' => "AND (    agentnum = $agentnum  ".
368                                     "      OR agentnum IS NULL    ) ",
369                    },
370                  )
371       ];
372     warn "$me done setting agent-specific adv. source list\n" if $DEBUG > 1;
373
374     $signup_info->{'agent_name'} = $agent->agent;
375
376     $signup_info->{'company_name'} = $conf->config('company_name', $agentnum);
377
378     #some of the above could probably be cached, too
379
380     my $signup_info_cache_agent = $cache->get("signup_info_cache_agent$agentnum");
381
382     if ( $signup_info_cache_agent ) {
383
384       warn "$me loading cached signup info for agentnum $agentnum\n"
385         if $DEBUG > 1;
386
387     } else {
388
389       warn "$me populating signup info cache for agentnum $agentnum\n"
390         if $DEBUG > 1;
391
392       $signup_info_cache_agent = {
393         #( map { $_ => scalar( $conf->config($_, $agentnum) ) }
394         #  qw( company_name ) ),
395         ( map { $_ => scalar( $conf->config("selfservice-$_", $agentnum ) ) }
396           qw( body_bgcolor box_bgcolor menu_bgcolor ) ),
397         ( map { $_ => join("\n", $conf->config("selfservice-$_", $agentnum ) ) }
398           qw( head body_header body_footer ) ),
399         ( map { $_ => join("\n", $conf->config("signup_server-$_", $agentnum ) ) }
400           qw( terms_of_service ) ),
401
402         ( map { $_ => scalar($conf->exists($_, $agentnum)) } 
403           qw(cust_main-require_phone agent-ship_address) ),
404       };
405
406       if ( $signup_info_cache_agent->{'agent-ship_address'} 
407            && $agent->agent_cust_main ) {
408
409         my $cust_main = $agent->agent_cust_main;
410         my $location = $cust_main->ship_location;
411         $signup_info_cache_agent->{"ship_$_"} = $location->get($_)
412           foreach qw( address1 city county state zip country );
413
414       }
415
416       $cache->set("signup_info_cache_agent$agentnum", $signup_info_cache_agent);
417
418     }
419
420     $signup_info->{$_} = $signup_info_cache_agent->{$_}
421       foreach keys %$signup_info_cache_agent;
422
423   }
424   # else {
425   # delete $signup_info->{'part_pkg'};
426   #}
427
428   warn "$me sorting package list\n" if $DEBUG > 1;
429   $signup_info->{'part_pkg'} = [ sort { $a->{pkg} cmp $b->{pkg} }  # case?
430                                       @{ $signup_info->{'part_pkg'} }
431                                ];
432   warn "$me done sorting package list\n" if $DEBUG > 1;
433
434   if ( exists $packet->{'session_id'} ) {
435     my $agent_signup_info = { %$signup_info };
436     delete $agent_signup_info->{agentnum2part_pkg};
437     $agent_signup_info->{'agent'} = $session->{'agent'};
438     return $agent_signup_info;
439   } 
440   elsif ( exists $packet->{'keys'} ) {
441     my @keys = @{ $packet->{'keys'} };
442     return { map { $_ => $signup_info->{$_} } @keys };
443   }
444   else {
445     return $signup_info;
446   }
447
448 }
449
450 sub domain_select_hash {
451   my $packet = shift;
452
453   my $response = {};
454
455   if ($packet->{pkgpart}) {
456     my $part_pkg = qsearchs('part_pkg' => { 'pkgpart' => $packet->{pkgpart} } );
457     #$packet->{svcpart} = $part_pkg->svcpart('svc_acct')
458     $packet->{svcpart} = $part_pkg->svcpart
459       if $part_pkg;
460   }
461
462   if ($packet->{svcpart}) {
463     my $part_svc = qsearchs('part_svc' => { 'svcpart' => $packet->{svcpart} } );
464     $response->{'domsvc'} = $part_svc->part_svc_column('domsvc')->columnvalue
465       if ($part_svc && $part_svc->part_svc_column('domsvc')->columnflag  eq 'D');
466   }
467
468   $response->{'domains'}
469     = { domain_select_hash FS::svc_acct( map { $_ => $packet->{$_} }
470                                                  qw(svcpart pkgnum)
471                                        ) };
472
473   $response;
474 }
475
476 sub new_customer {
477   my $packet = shift;
478
479   my $conf = new FS::Conf;
480   my $svc_x = $conf->config('signup_server-service') || 'svc_acct';
481
482   if ( $svc_x eq 'svc_acct' ) {
483   
484     #things that aren't necessary in base class, but are for signup server
485       #return "Passwords don't match"
486       #  if $hashref->{'_password'} ne $hashref->{'_password2'}
487     return { 'error' => gettext('empty_password') }
488       unless length($packet->{'_password'});
489     # a bit inefficient for large numbers of pops
490     return { 'error' => gettext('no_access_number_selected') }
491       unless $packet->{'popnum'} || !scalar(qsearch('svc_acct_pop',{} ));
492
493   }
494   elsif ( $svc_x eq 'svc_pbx' ) {
495     #possibly some validation will be needed
496   }
497
498   my $agentnum;
499   if ( exists $packet->{'session_id'} ) {
500     my $cache = new FS::ClientAPI_SessionCache( {
501       'namespace' => 'FS::ClientAPI::Agent',
502     } );
503     my $session = $cache->get($packet->{'session_id'});
504     if ( $session ) {
505       $agentnum = $session->{'agentnum'};
506     } else {
507       return { 'error' => "Can't resume session" }; #better error message
508     }
509   } else {
510     $agentnum = $packet->{agentnum}
511                 || $conf->config('signup_server-default_agentnum');
512   }
513
514   my ($bill_hash, $ship_hash);
515   foreach my $f (FS::cust_main->location_fields) {
516     # avoid having to change this in front-end code
517     $bill_hash->{$f} = $packet->{"bill_$f"} || $packet->{$f};
518     $ship_hash->{$f} = $packet->{"ship_$f"};
519   }
520
521   #shares some stuff with htdocs/edit/process/cust_main.cgi... take any
522   # common that are still here and library them.
523   my $template_custnum = $conf->config('signup_server-prepaid-template-custnum');
524   my $cust_main;
525   if ( $template_custnum && $packet->{prepaid_shortform} ) {
526
527     my $template_cust = qsearchs('cust_main', { 'custnum' => $template_custnum } );
528     return { 'error' => 'Configuration error' } unless $template_cust;
529     $cust_main = new FS::cust_main ( {
530       'agentnum'      => $agentnum,
531       'refnum'        => $packet->{refnum}
532                          || $conf->config('signup_server-default_refnum'),
533
534       ( map { $_ => $template_cust->$_ } qw( 
535               last first company daytime night fax mobile
536             )
537       ),
538
539       ( map { $_ => $packet->{$_} } qw(
540               ss stateid stateid_state
541
542               payby
543               payinfo paycvv paydate payname paystate paytype
544               paystart_month paystart_year payissue
545               payip
546
547               referral_custnum comments
548             )
549       ),
550
551     } );
552
553     $bill_hash = { $template_cust->bill_location->location_hash };
554     $ship_hash = { $template_cust->ship_location->location_hash };
555
556   } else {
557
558     $cust_main = new FS::cust_main ( {
559       #'custnum'          => '',
560       'agentnum'      => $agentnum,
561       'refnum'        => $packet->{refnum}
562                          || $conf->config('signup_server-default_refnum'),
563
564       map { $_ => $packet->{$_} } qw(
565         last first ss company 
566         daytime night fax mobile
567         stateid stateid_state
568         payby
569         payinfo paycvv paydate payname paystate paytype
570         paystart_month paystart_year payissue
571         payip
572         override_ban_warn
573         referral_custnum comments
574       ),
575
576     } );
577   }
578
579   my $bill_location = FS::cust_location->new($bill_hash);
580   my $ship_location;
581   my $agent = qsearchs('agent', { 'agentnum' => $agentnum } );
582   if ( $conf->exists('agent-ship_address', $agentnum) 
583     && $agent->agent_custnum ) {
584
585     my $agent_cust_main = $agent->agent_cust_main;
586     my $prefix = length($agent_cust_main->ship_last) ? 'ship_' : '';
587     $ship_location = FS::cust_location->new({ 
588         $agent_cust_main->ship_location->location_hash
589     });
590
591   }
592   # we don't have an equivalent of the "same" checkbox in selfservice
593   # so is there a ship address, and if so, is it different from the billing 
594   # address?
595   elsif ( length($ship_hash->{address1}) > 0 and
596           grep { $bill_hash->{$_} ne $ship_hash->{$_} } keys(%$ship_hash)
597          ) {
598
599     $ship_location = FS::cust_location->new( $ship_hash );
600   
601   }
602   else {
603     $ship_location = $bill_location;
604   }
605
606   $cust_main->set('bill_location' => $bill_location);
607   $cust_main->set('ship_location' => $ship_location);
608
609   return { 'error' => "Illegal payment type" }
610     unless grep { $_ eq $packet->{'payby'} }
611                 $conf->config('signup_server-payby');
612
613   if (FS::payby->realtime($packet->{payby})
614     and not $conf->exists('signup_server-third_party_as_card')) {
615     my $payby = $packet->{payby};
616
617     my $agent = qsearchs('agent', { 'agentnum' => $agentnum });
618     return { 'error' => "Unknown reseller" }
619       unless $agent;
620
621     my $gw;
622     my $gatewaynum = $conf->config('selfservice-payment_gateway');
623     if ( $gatewaynum ) {
624       $gw = qsearchs('payment_gateway', { gatewaynum => $gatewaynum });
625       die "configured gatewaynum $gatewaynum not found!" if !$gw;
626     }
627     else {
628       $gw = $agent->payment_gateway( 'method'  => FS::payby->payby2bop($payby),
629                                      'nofatal' => 1,
630                                     );
631     }
632
633     $cust_main->payby('BILL')   # MCRD better?
634       if $gw && $gw->gateway_namespace eq 'Business::OnlineThirdPartyPayment';
635   }
636
637   return { 'error' => "CVV2 is required" }
638     if $cust_main->payby =~ /^(CARD|DCRD)$/
639     && ! $cust_main->paycvv
640     && $conf->exists('signup-require_cvv');
641
642   $cust_main->payinfo($cust_main->daytime)
643     if $cust_main->payby eq 'LECB' && ! $cust_main->payinfo;
644
645   my @invoicing_list = $packet->{'invoicing_list'}
646                          ? split( /\s*\,\s*/, $packet->{'invoicing_list'} )
647                          : ();
648
649   my %insert_options = ();
650
651   my @exempt_groups = grep /\S/, $conf->config('tax-cust_exempt-groups');
652   my @tax_exempt = grep { $packet->{"tax_$_"} eq 'Y' } @exempt_groups;
653   $insert_options{'tax_exemption'} = {
654     map { $_ => $packet->{"tax_$_".'_num'} } @tax_exempt
655   };
656
657   $packet->{'pkgpart'} =~ /^(\d+)$/ or '' =~ /^()$/;
658   my $pkgpart = $1;
659   return { 'error' => 'Please select a package' } unless $pkgpart; #msgcat
660
661   my $part_pkg =
662     qsearchs( 'part_pkg', { 'pkgpart' => $pkgpart } )
663       or return { 'error' => "WARNING: unknown pkgpart: $pkgpart" };
664   my $svcpart = $part_pkg->svcpart($svc_x);
665
666   my $reg_code = '';
667   if ( $packet->{'reg_code'} ) {
668     $reg_code = qsearchs( 'reg_code', { 'code'     => $packet->{'reg_code'},
669                                         'agentnum' => $agentnum,             } )
670       or return { 'error' => 'Unknown registration code' };
671   }
672
673   my $cust_pkg = new FS::cust_pkg ( {
674     #later#'custnum' => $custnum,
675     'pkgpart'    => $packet->{'pkgpart'},
676     'promo_code' => $packet->{'promo_code'},
677     'reg_code'   => $packet->{'reg_code'},
678   } );
679   #my $error = $cust_pkg->check;
680   #return { 'error' => $error } if $error;
681
682   #should be all auto-magic and shit
683   my @svc = ();
684   if ( $svc_x eq 'svc_acct' ) {
685
686     my $svc = new FS::svc_acct {
687       'svcpart'   => $svcpart,
688       map { $_ => $packet->{$_} }
689         qw( username _password sec_phrase popnum domsvc ),
690     };
691
692     my @acct_snarf;
693     my $snarfnum = 1;
694     while (    exists($packet->{"snarf_machine$snarfnum"})
695             && length($packet->{"snarf_machine$snarfnum"}) ) {
696       my $acct_snarf = new FS::acct_snarf ( {
697         'machine'   => $packet->{"snarf_machine$snarfnum"},
698         'protocol'  => $packet->{"snarf_protocol$snarfnum"},
699         'username'  => $packet->{"snarf_username$snarfnum"},
700         '_password' => $packet->{"snarf_password$snarfnum"},
701       } );
702       $snarfnum++;
703       push @acct_snarf, $acct_snarf;
704     }
705     $svc->child_objects( \@acct_snarf );
706     push @svc, $svc;
707
708   } elsif ( $svc_x eq 'svc_phone' ) {
709
710     push @svc, new FS::svc_phone ( {
711       'svcpart' => $svcpart,
712        map { $_ => $packet->{$_} }
713          qw( countrycode phonenum sip_password pin ),
714     } );
715
716   } elsif ( $svc_x eq 'svc_pbx' ) {
717
718     push @svc, new FS::svc_pbx ( {
719         'svcpart' => $svcpart,
720         map { $_ => $packet->{$_} } 
721           qw( id title ),
722         } );
723   
724   } else {
725     die "unknown signup service $svc_x";
726   }
727
728   if ($packet->{'mac_addr'} && $conf->exists('signup_server-mac_addr_svcparts'))
729   {
730
731     my %mac_addr_svcparts = map { $_ => 1 }
732                             $conf->config('signup_server-mac_addr_svcparts');
733     my @pkg_svc = grep { $_->quantity && $mac_addr_svcparts{$_->svcpart} }
734                   $cust_pkg->part_pkg->pkg_svc;
735
736     return { 'error' => 'No service defined to assign mac address' }
737       unless @pkg_svc;
738
739     my $svc = new FS::svc_acct {
740       'svcpart'   => $pkg_svc[0]->svcpart, #multiple matches? alas..
741       'username'  => $packet->{'mac_addr'},
742       '_password' => '', #blank as requested (set passwordmin to 0)
743     };
744
745     push @svc, $svc;
746
747   }
748
749   foreach my $svc ( @svc ) {
750     my $y = $svc->setdefault; # arguably should be in new method
751     return { 'error' => $y } if $y && !ref($y);
752     #$error = $svc->check;
753     #return { 'error' => $error } if $error;
754   }
755
756   #setup a job dependancy to delay provisioning
757   my $placeholder = new FS::queue ( {
758     'job'    => 'FS::ClientAPI::Signup::__placeholder',
759     'status' => 'locked',
760   } );
761   my $error = $placeholder->insert;
762   return { 'error' => $error } if $error;
763
764   use Tie::RefHash;
765   tie my %hash, 'Tie::RefHash';
766   %hash = ( $cust_pkg => \@svc );
767   #msgcat
768   $error = $cust_main->insert(
769     \%hash,
770     \@invoicing_list,
771     'depend_jobnum' => $placeholder->jobnum,
772      %insert_options,
773   );
774   if ( $error ) {
775     my $perror = $placeholder->delete;
776     $error .= " (Additionally, error removing placeholder: $perror)" if $perror;
777     return { 'error' => $error };
778   }
779
780   if ( $conf->exists('signup_server-realtime') ) {
781
782     #warn "$me Billing customer...\n" if $Debug;
783
784     my $bill_error = $cust_main->bill( 'depend_jobnum'=>$placeholder->jobnum );
785     #warn "$me error billing new customer: $bill_error"
786     #  if $bill_error;
787
788     $bill_error = $cust_main->apply_payments_and_credits;
789     #warn "$me error applying payments and credits for".
790     #     " new customer: $bill_error"
791     #  if $bill_error;
792
793     unless ( $packet->{payby} eq 'PREPAY' ) {
794       $bill_error = $cust_main->realtime_collect(
795          method        => FS::payby->payby2bop( $packet->{payby} ),
796          depend_jobnum => $placeholder->jobnum,
797          selfservice   => 1,
798       );
799       #warn "$me error collecting from new customer: $bill_error"
800       #  if $bill_error;
801     }
802
803     if ($bill_error && ref($bill_error) eq 'HASH') {
804       return { 'error' => '_collect',
805                ( map { $_ => $bill_error->{$_} }
806                  qw(popup_url reference collectitems)
807                ),
808                amount => $cust_main->balance,
809              };
810     }
811
812     $bill_error = $cust_main->apply_payments_and_credits;
813     #warn "$me error applying payments and credits for".
814     #     " new customer: $bill_error"
815     #  if $bill_error;
816
817     if ( $cust_main->balance > 0 ) {
818
819       #this makes sense.  credit is "un-doing" the invoice
820       $cust_main->credit( $cust_main->balance, 'signup server decline',
821                           'reason_type' => $conf->config('signup_credit_type'),
822                         );
823       $cust_main->apply_credits;
824
825       #should check list for errors...
826       #$cust_main->suspend;
827       local $FS::svc_Common::noexport_hack = 1;
828       $cust_main->cancel('quiet'=>1);
829
830       my $perror = $placeholder->depended_delete;
831       warn "error removing provisioning jobs after decline: $perror" if $perror;
832       unless ( $perror ) {
833         $perror = $placeholder->delete;
834         warn "error removing placeholder after decline: $perror" if $perror;
835       }
836
837       return { 'error' => '_decline' };
838     }
839
840   }
841
842   if ( $reg_code ) {
843     $error = $reg_code->delete;
844     return { 'error' => $error } if $error;
845   }
846
847   $error = $placeholder->delete;
848   return { 'error' => $error } if $error;
849
850   if ( $conf->exists('signup-duplicate_cc-warn_hours') ) {
851     my $hours = $conf->config('signup-duplicate_cc-warn_hours');
852     my $ban = new FS::banned_pay $cust_main->_new_banned_pay_hashref;
853     $ban->end_date( int( time + $hours*3600 ) );
854     $ban->bantype('warn');
855     $ban->reason('signup-duplicate_cc-warn_hours');
856     $error = $ban->insert;
857     warn "WARNING: error inserting temporary banned_pay for ".
858          " signup-duplicate_cc-warn_hours (proceeding anyway): $error"
859       if $error;
860   }
861
862   my %return = ( 'error'          => '',
863                  'signup_service' => $svc_x,
864                  'custnum'        => $cust_main->custnum,
865                );
866
867   if ( $svc[0] ) {
868
869     $return{'svcnum'} = $svc[0]->svcnum;
870
871     if ( $svc_x eq 'svc_acct' ) {
872       $return{$_} = $svc[0]->$_() for qw( username _password );
873     } elsif ( $svc_x eq 'svc_phone' ) {
874       $return{$_} = $svc[0]->$_() for qw(countrycode phonenum sip_password pin);
875     } elsif ( $svc_x eq 'svc_pbx' ) {
876       #$return{$_} = $svc[0]->$_() for qw( ) #nothing yet
877      } else {
878       return {'error' => "configuration error: unknown signup service $svc_x"};
879       #die "unknown signup service $svc_x";
880       # return an error that's visible to someone somewhere
881     }
882
883   }
884
885   return \%return;
886
887 }
888
889 sub capture_payment {
890   my $packet = shift;
891
892   warn "$me capture_payment called on $packet\n" if $DEBUG;
893
894   ###
895   # identify processor/gateway from called back URL
896   ###
897
898   my $conf = new FS::Conf;
899
900   my $payment_gateway;
901   if ( my $gwnum = $conf->config('selfservice-payment_gateway') ) {
902     $payment_gateway = qsearchs('payment_gateway', { 'gatewaynum' => $gwnum })
903       or die "configured gatewaynum $gwnum not found!";
904   }
905   else {
906     my $url = $packet->{url};
907
908     $payment_gateway = qsearchs('payment_gateway', 
909         { 'gateway_callback_url' => popurl(0, $url) } 
910       );
911     if (!$payment_gateway) { 
912
913       my ( $processor, $login, $password, $action, @bop_options ) =
914         $conf->config('business-onlinepayment');
915       $action ||= 'normal authorization';
916       pop @bop_options if scalar(@bop_options) % 2 && $bop_options[-1] =~ /^\s*$/;
917       die "No real-time processor is enabled - ".
918           "did you set the business-onlinepayment configuration value?\n"
919         unless $processor;
920
921       $payment_gateway = new FS::payment_gateway( {
922         gateway_namespace => $conf->config('business-onlinepayment-namespace'),
923         gateway_module    => $processor,
924         gateway_username  => $login,
925         gateway_password  => $password,
926         gateway_action    => $action,
927         options   => [ ( @bop_options ) ],
928       });
929     }
930   }
931  
932   die "No real-time third party processor is enabled - ".
933       "did you set the business-onlinepayment configuration value?\n*"
934     unless $payment_gateway->gateway_namespace eq 'Business::OnlineThirdPartyPayment';
935
936   ###
937   # locate pending transaction
938   ###
939
940   eval "use Business::OnlineThirdPartyPayment";
941   die $@ if $@;
942
943   my $transaction =
944     new Business::OnlineThirdPartyPayment( $payment_gateway->gateway_module,
945                                            @{ [ $payment_gateway->options ] },
946                                          );
947
948   my $paypendingnum = $transaction->reference($packet->{data});
949
950   my $cust_pay_pending =
951     qsearchs('cust_pay_pending', { paypendingnum => $paypendingnum } );
952
953   unless ($cust_pay_pending) {
954     my $bill_error = "No payment is being processed with id $paypendingnum".
955                      "; Transaction aborted.";
956     return { error => '_decline', bill_error => $bill_error };
957   }
958
959   if ($cust_pay_pending->status ne 'thirdparty') {
960     my $bill_error = "Payment with id $paypendingnum is not thirdparty, but ".
961                      $cust_pay_pending->status.  "; Transaction aborted.";
962     return { error => '_decline', bill_error => $bill_error };
963   }
964
965   my $cust_main = $cust_pay_pending->cust_main;
966   if ( $packet->{cancel} ) {
967     # the user has chosen not to make this payment
968     # (probably should be a separate API call, but I don't want to duplicate
969     # all of the above...which should eventually go away)
970     my $error = $cust_pay_pending->delete;
971     # don't show any errors related to this; they're not meaningful
972     warn "error canceling pending payment $paypendingnum: $error\n" if $error;
973     return { 'error'      => '_cancel',
974              'session_id' => $cust_pay_pending->session_id };
975   } else {
976     # create the payment
977     my $bill_error =
978       $cust_main->realtime_botpp_capture( $cust_pay_pending, 
979         %{$packet->{data}},
980         apply => 1,
981     );
982
983     return { 'error'      => ( $bill_error->{bill_error} ? '_decline' : '' ),
984              %$bill_error,
985            };
986   }
987
988 }
989
990 1;