licence pednatry, dh-make-perl complains
[Business-OnlineThirdPartyPayment.git] / notes_for_module_writers
1 Information on creating a new processor backend to go with
2 Business::OnlineThirdPartyPayment.
3 -----------------------------------------------------------
4
5 NOTE: 
6
7     You should read the notes in Business::OnlinePayment first.
8
9 Create a subclass of Business::OnlineThirdPartyPayment called
10 Business::OnlinePayment::(processor name).  You should override at least
11 the set_defaults, submit, and reference methods.
12
13 See Business::OnlineThirdPartyPayment::Interswitchng as an example.
14
15 submit: 
16   This method functions with both a "Authorize Only" and "Post Authorization"
17 action.  The former must, at a minumum, ensure that popup_url will return
18 an appropriate value when submit also sets is_successful.
19
20   Nothing has happened at this point other than verifying the data is valid
21 and providing the caller with a redirection url.
22
23   When called with "Post Authorization" steps are taken to verify that funds
24 have been authorized by the processor.
25
26 reference:
27   This method is called with a hash of key/value pairs, typically as the
28 result of a HTTP GET or POST, but by whatever mechanism the processor provides.
29 The return value must be the unique reference provided to the "Authorize Only"
30 submit.  Since the usage consists of submit(action=>'Authorize Only'),
31 reference(key=>value...), submit(action=>'Post Authorization'), this may be
32 the appropriate time to set the state of the object for some processors.
33