registration/account-creation
The bank knows each user by both a user name and an account
number. To take money out of an account (e.g. in a payment), the
bank must be given the account number: the account number is sort
of like a credit-card number.
All protocols are of the request/response type. All protocol
messages have the same structure (of class genericModuleMessage)
- Version:
- $Revision: 1.26 $ $Date: 1997/02/27 14:18:24 $
- Author:
- N. Asokan ([email protected])
-
genericModule()
-
-
genericAccountStatus(String, ComPointAddress, StringBuffer, StringBuffer)
- Get the status of the account
-
genericAuthorise(String, ComPointAddress, String, String)
- Check authorisation for a payment.
-
genericCapture(String, String, ComPointAddress, String, String)
- Capture a payment.
-
genericInit(ComPointAddress)
- Initialise/re-initialise the system.
-
genericPay(String, String, String, ComPointAddress, String, String, String)
- Send a payment.
-
genericReceivePayment(ChannelServicePointThread, String[], String[], String[], String[], String, ComPointAddress, String)
- Receive a payment from anyone
-
genericRegister(String, ComPointAddress, String, String)
- Register the account with the acquirer.
genericModule
public genericModule()
genericInit
public static ChannelServicePointThread genericInit(ComPointAddress addr) throws genericModuleException
- Initialise/re-initialise the system.
This method registers a port/protocol with with the communication
manager so that incoming payment messages can be handled.
- Parameters:
- addr - ComPointAddress object indicating port and protocol
- Returns:
- a handle to the service point thread created
- Throws: genericModuleException
- if the registration fails.
genericPay
public static genericEvidence genericPay(String payer_name,
String payer_AC_number,
String payee_name,
ComPointAddress payee,
String amount,
String currency,
String ext_ref) throws genericModuleException
- Send a payment.
Sends a payment to the specified party.
- Parameters:
- payer_name - name by which we are to be known to the
payee (this need not be the same name that the bank
knows us by)
- payer_AC_number - our account number in the bank
- payee_name - name of the payee
- payee - address of the payee
- amount - numeric value of payment
- currency - currency of payment
- ext_ref - external reference string to be passed on to
the other side
- Returns:
- genericEvidence object containing results and status
- Throws: genericModuleException
- on all sorts of errors
- See Also:
- genericReceivePayment
genericReceivePayment
public static genericEvidence genericReceivePayment(ChannelServicePointThread in_portal,
String a_amount[],
String a_currency[],
String a_payer_name[],
String a_payer_AC_number[],
String my_AC_number,
ComPointAddress acquirer,
String ext_ref) throws genericModuleException
- Receive a payment from anyone
- Parameters:
- in_portal - service point thread created when we
registered our address with comm. manager
- a_amount - numeric value of payment (return value)
- a_currency - currency of payment (return value)
- a_payer_name - name of the payer (return value)
- a_payer_AC_number - (return value)
- ext_ref - external reference string passed on from
the other side
- my_AC_number - my account number at the acquirer
- acquirer - address of the acquirer
- Returns:
- genericEvidence object containing results and status
- Throws: genericModuleException
- on all sorts of errors
- See Also:
- genericPay
genericAuthorise
public static genericEvidence genericAuthorise(String payer_AC_number,
ComPointAddress acquirer,
String amount,
String currency) throws genericModuleException
- Check authorisation for a payment.
Check to see if the payer account has enough money for a proposed
payment.
- Parameters:
- payer_AC_nymber - payer's account number
- acquirer - address of the acquirer bank
- amount - numeric value of proposed payment
- currency - currency of proposed payment
- ext_ref - external reference string
- Returns:
- genericEvidence object containing results and status
- Throws: genericModuleException
- on all sorts of errors
genericAccountStatus
public static genericEvidence genericAccountStatus(String account_number,
ComPointAddress acquirer,
StringBuffer amount,
StringBuffer currency) throws genericModuleException
- Get the status of the account
- Parameters:
- account_number - number of the account
- acquirer - address of the acquirer
- amount - holder for return value: amount
- currency - holder for return value: currency
- Returns:
- evidence accumulated during the transaction
- Throws: genericModuleException
- on misc.errors.
genericCapture
public static genericEvidence genericCapture(String payer_AC_number,
String payee_AC_number,
ComPointAddress acquirer,
String amount,
String currency) throws genericModuleException
- Capture a payment.
Arrange for the payment amount to be moved from the payer's
account to our account.
- Parameters:
- payer_AC_nymber - payer's account number
- payee_AC_nymber - payee's account number
- acquirer - address of the acquirer bank
- amount - numeric value of proposed payment
- currency - currency of proposed payment
- ext_ref - external reference string
- Returns:
- genericEvidence object containing results and status
- Throws: genericModuleException
- on all sorts of errors
genericRegister
public static String genericRegister(String name,
ComPointAddress acquirer,
String amount,
String currency) throws genericModuleException
- Register the account with the acquirer.
Create/renew an account and set the account balance to the
specified amount.
- Parameters:
- name - name of the account holder
- acquirer - address of the bank
- amount - value of the new balance
- currency - currency of the new balance
- ext_ref - external reference string
- Returns:
- String representing the account number
- Throws: genericModuleException
- for misc. errors
All Packages Class Hierarchy This Package Previous Next Index