Apache-Centipaid

 view release on metacpan or  search on metacpan

Centipaid.pm  view on Meta::CPAN

B<Apache::Centipaid> is a mod_perl Authentication handler used in 
granting access to users wishing to access paid web services, after 
making payment on centipaid.com which process micropayments using
internet stamps. 

Centipaid.com offers websites the flexibility to charge small amounts
of money, also refered to as B<micropayment>, to users wishing to
access to their web services without the complexity of setting up 
e-commerce enabled site, or to deal with expensive credit card 
processing options. Users benefit from not having to reveal their
identity or credit card information everytime they decide to visit a 
website.  Instead, centipaid allows users to simply pay using
a pre-paid internet stamp, by simply uploading the stamp to centipaid's
site. The stamps are valid in all sites using centipaid.com payment
system.

To access a site, recipts are issued by centipaid and are used to track 
valid payments.  This information is captured and processed by the
Apache::Centipaid module.  The information is then stored locally to 
any SQL database installed.  The module relies on DBD/DBI interface
so as long as the database has a DBD interface installed under Perl,

Centipaid.pm  view on Meta::CPAN

 need several sections of its site to show payment 
 requests in different languages. Some of the ISO
 639 language codes are: English (en), Arabic (ar), 
 japanese (ja), Spanish (es), etc..


=item B<enforce_ip> 0

 This tells the module if the website wants to tie
 the receipt to a one ip.  This may be requiered in
 certain casees where the site admin decides that
 access to the site is made only from the ip of
 the machine that makes the payment, as long as the
 machine also holds the receipt cookie.  The valid 
 values are 0 for "do not restrict to ip", and 1 
 for "yes do restrict to the ip".  If ommited, then
 the default is 0.
    

=item B<Authetication server information>

Centipaid.pm  view on Meta::CPAN

  paid double NOT NULL default '0',
  ip varchar(100) default NULL,
  zone varchar(50) NOT NULL default '',
  PRIMARY KEY  (rcpt)
);

==end

where B<rcpt> stores the recipt number, B<date> and B<expire> contain the date the
receipt was issued on the site, and its expiration. B<Paid> contains the amount paid
in float format.  The B<IP> could be used in cases where the site admin decides to tie
a payment to an ip as well as a browser.  We do not reommend this, since people use 
proxy servers, and dynamic IPs.  The B<zone> is used for statistical purposes, where
the website admin can see what sections are being used most.



=head1 TODO

=item B<Apache::DBI support> Use Apache::DBI instead of DBI to use persistent connections

RCS/Centipaid.pm,v  view on Meta::CPAN

B<Apache::Centipaid> is a mod_perl Authentication handler used in 
granting access to users wishing to access paid web services, after 
making payment on centipaid.com which process micropayments using
internet stamps. 

Centipaid.com offers websites the flexibility to charge small amounts
of money, also refered to as B<micropayment>, to users wishing to
access to their web services without the complexity of setting up 
e-commerce enabled site, or to deal with expensive credit card 
processing options. Users benefit from not having to reveal their
identity or credit card information everytime they decide to visit a 
website.  Instead, centipaid allows users to simply pay using
a pre-paid internet stamp, by simply uploading the stamp to centipaid's
site. The stamps are valid in all sites using centipaid.com payment
system.

To access a site, recipts are issued by centipaid and are used to track 
valid payments.  This information is captured and processed by the
Apache::Centipaid module.  The information is then stored locally to 
any SQL database installed.  The module relies on DBD/DBI interface
so as long as the database has a DBD interface installed under Perl,

RCS/Centipaid.pm,v  view on Meta::CPAN

 need several sections of its site to show payment 
 requests in different languages. Some of the ISO
 639 language codes are: English (en), Arabic (ar), 
 japanese (ja), Spanish (es), etc..


=item B<enforce_ip> 0

 This tells the module if the website wants to tie
 the receipt to a one ip.  This may be requiered in
 certain casees where the site admin decides that
 access to the site is made only from the ip of
 the machine that makes the payment, as long as the
 machine also holds the receipt cookie.  The valid 
 values are 0 for "do not restrict to ip", and 1 
 for "yes do restrict to the ip".  If ommited, then
 the default is 0.
    

=item B<Authetication server information>

RCS/Centipaid.pm,v  view on Meta::CPAN

  paid double NOT NULL default '0',
  ip varchar(100) default NULL,
  zone varchar(50) NOT NULL default '',
  PRIMARY KEY  (rcpt)
);

==end

where B<rcpt> stores the recipt number, B<date> and B<expire> contain the date the
receipt was issued on the site, and its expiration. B<Paid> contains the amount paid
in float format.  The B<IP> could be used in cases where the site admin decides to tie
a payment to an ip as well as a browser.  We do not reommend this, since people use 
proxy servers, and dynamic IPs.  The B<zone> is used for statistical purposes, where
the website admin can see what sections are being used most.



=head1 TODO

=item B<Apache::DBI support> Use Apache::DBI instead of DBI to use persistent connections