Search: 
Available in: OFX
BillPayment Component [IBiz E-Banking Integrator V2]

Properties   Methods   Events   Configuration Settings  

The BillPayment control is a single component that supports the SignOn and Payment functions of Open Financial Exchange, as described by Specification 1.0.2.

NOTE: What follows is a very short description of the component interfaces. For more information, please consult the help files that come with the respective package.

Remarks

Payment requests can be used to schedule individual payments and to modify or delete payments if necessary.

To use the BillPayment component, first provide OFXAppId, and OFXAppVersion properties, your FI information (by setting the FIOrganization, FIId and FIUrl properties), your login information (OFXUser, OFXPassword).

Next, set FromBankId, FromAccountId, and FromAccountType properties to the values corresponding to the account from which you wish to pay the bill, Amount to the desired amount, DueDate to the date payment has to be processed, provide either PayeeId or: payee full information (via PayeeAggregate or by setting each payee property such as PayeeName, PayeeAddr1, PayeePhone, PayeeListId (if assigned by the server) and PayeeAccount to your account id with that biller.

Finally, call the PayBill method. If the biller does not exist in the payee list, the payment request will also set up that payee adding it to your payee list.

When the response returns, the PaymentId, PaymentStatus and PaymentDate properties will be populated, indicating the status of your payment. If your FI supports assigning id to payees, an id and list id to that payer might be returned in the server response. These values will be stored in PayeeId and PayeeListId properties.

Between the time a payment is scheduled and the time the server processes the payment, the user can request changes to the parameters of that payment. For example, the Amount or DueDate of the payment can be modified. To accomplish this, the ModifyPayment method can be called where the PaymentId identifies the targeted payment. When this method is called, the full contents of the payment request must be specified, including both modified and unmodified data. All data can be modified except PayeeName and PayeeId. Depending on the server, the response might include reporting the date the server actually processed a payment, or it failed due to insufficient funds.

To cancel a scheduled payment identified by PaymentId, the CancelPayment method must be called.

Obtaining the status for a payment identified by PaymentId can be done by calling the GetStatus method.

Bil payments are subject to synchronization which can be done by calling the SyncPayments method.

Property List


The following is the full list of the properties of the component with short descriptions. Click on the links for complete descriptions.

Amount Payment amount.
BillRef Biller-supplied reference information when paying a bill, if available.
CheckNumber Check number assigned by the server to this payment.
DaysToPay Minimum number of business days required to complete the transaction.
DefaultCurrency Default currency for this transaction.
DueDate Date the payment has to be sent.
FIId Financial institution identifier.
FIOrganization Financial institution organization name.
FIUrl Financial institution URL.
FirewallHost Name or IP address of firewall (optional).
FirewallPassword A password if authentication is to be used when connecting through the firewall.
FirewallPort Port of the firewall to connect to.
FirewallType Determines the type of firewall to connect through.
FirewallUser A user name if authentication is to be used connecting through a firewall.
FromAccountId Account number from which the money for this payment is drawn.
FromAccountType Indicates the type of account from which the money for this payment is drawn.
FromBankId Number that identifies the bank where the money is to be withdrawn.
LostSync Whether the token in the synchronization request is older.
Memo Memo attached to this payment from the customer to payee.
OFXAppId OFX application identifier.
OFXAppVersion OFX application version.
OFXPassword User's password.
OFXRequest The current OFX request aggregate.
OFXResponse The current OFX response aggregate.
OFXUser User's id.
PayeeAccount User's account number with the payee.
PayeeAddr1 Payee's address line 1.
PayeeAddr2 Payee's address line 2.
PayeeAddr3 Payee's address line 3.
PayeeAggregate Payee aggregate.
PayeeCity Payee's city.
PayeeCountry Payee's country.
PayeeId Server-assigned payee identifier.
PayeeIdScope Scope of the payee Id.
PayeeListId Server-assigned payee list record ID for this payee.
PayeeName Payee's name.
PayeePhone Payee's phone.
PayeePostalCode Payee's postal code.
PayeeState Payee's state
PaymentDate Payment processing date.
PaymentId Transaction Id assigned by the server to the payment.
PaymentStatus Payment processing status.
SSLAcceptServerCert Instructs the component to unconditionally accept the server certificate that matches the supplied certificate.
SSLCertEncoded The SSL certificate (PEM/base64 encoded).
SSLCertStore The name of the certificate store for the client certificate.
SSLCertStorePassword The password for the certificate store (if any).
SSLCertStoreType The type of certificate store for the client certificate.
SSLCertSubject The subject of the certificate used for client authentication.
SSLServerCert The server certificate for the last established connection.
SSLServerCertStatus The verification status of the server certificate for the last established connection.
Timeout A timeout for the component.
ToAccountId Account number to which the money for this payment is sent.
ToAccountType Indicates the type of account to which this payment is sent.
ToBankId Number that identifies the bank where the money is to be deposited.

Method List


The following is the full list of the methods of the component with short descriptions. Click on the links for complete descriptions.

AddPayee Add a payee to server's payee list.
CancelPayment Cancels a scheduled bill payment.
Config Sets or retrieves a component configuration setting.
DeletePayee Deletes a payee from the server payee list.
GetStatus Obtains the current processing status of a payment.
ModifyPayee Modifies a payee that already exists in payee list.
ModifyPayment Modifies a scheduled payment.
PayBill Pays a bill to a given payee.
Reset Reset the internal state of the component and all properties to their default values.
SyncPayees Synchronizes payees on the client side with payees on record on the server side.
SyncPayments Synchronizes bills paid on the client side with paid bills on record on the server side.

Event List


The following is the full list of the events fired by the component with short descriptions. Click on the links for complete descriptions.

ConnectionStatus Fired to indicate changes in connection state.
Error Information about errors during data delivery.
SSLServerAuthentication Fired after the server presents its certificate to the client.
SSLStatus Shows the progress of the secure connection.
SyncPayees Fired for each payee included in the synchronization response.
SyncPayments Fired for each payment transaction included in the synchronization response.

Configuration Settings


The following is a list of configuration settings for the component with short descriptions. Click on the links for complete descriptions.

AbsoluteTimeout Determines whether timeouts are inactivity timeouts or absolute timeouts.
CodePage The system code page used for Unicode to Multibyte translations (Windows/COM only).
CurrencyFormat The format to be used for returning currency values.
DateFormat The format to be used for returning and parsing date strings.
FirewallData Used to send extra data to the firewall.
FirewallListener If true, the component binds to a SOCKS firewall as a server (IPPort only).
HTTPVersion The version of HTTP used by the component
IfModifiedSince A date determining the maximum age of the desired document.
InBufferSize The size in bytes of the incoming queue of the socket.
KeepAlive Determines whether the HTTP connection is closed after the completion of the request.
MaxLineLength The maximum amount of data to accumulate when no EOL is found.
MaxTransferredData The maximum number of incoming bytes to be stored by the component.
NewPassword New password for the current OFX user.
OFXLog Log file for the OFX transaction.
OpenSSLCADir The path to a directory containing CA certificates.
OpenSSLCAFile Name of the file containing the list of CA's trusted by your application.
OpenSSLCipherList A string that controls the ciphers to be used by SSL.
OpenSSLPrngSeedData The data to seed the pseudo random number generator(PRNG).
OutBufferSize The size in bytes of the outgoing queue of the socket.
ProxyAuthorization The authorization string to be sent to the proxy server.
ProxyPassword A password if Basic authentication is to be used for the proxy.
ProxyPort Port for the proxy server (default 80).
ProxyServer Name or IP address of a proxy server (optional).
ProxyUser A user name if Basic authentication is to be used for the proxy.
SSLCipherStrength The minimum cipher strength used for bulk encryption.
SSLEnabledProtocols Used to enable/disable the supported security protocols.
SSLProvider The name of the security provider to use.
SSLSecurityFlags Flags that control certificate verification
ServerMessage Server message if a warning or other information returned.
SocketHandle The handle of the main socket used by the component.
UseWinInet If set, the WinInet API is used for retrieving the URL
UseWinInetCookies Controls whether to send and accept cookies when making http requests through WinInet
UserAgent Information about the user agent (browser).
WinsockInfo Identifying information about the loaded Winsock stack (Windows only)
WinsockLoaded Loads and unloads Winsock on demand (Windows only)
WinsockMaxDatagramSize Size in bytes of the largest UDP datagram that can be sent or received (Windows only)
WinsockMaxSockets Maximum number of sockets available to a single process (Windows only)
WinsockPath The path to the Winsock DLL used (Windows only)
WinsockStatus The status of the Winsock stack (Windows only)

| About | Privacy Policy | Terms of Use |
© Copyright 2008 /n software inc.