IFinancialEvents

From Virtual World Web Wiki
Jump to: navigation, search

This interface describes a Layer Two extensibility point. Components can implement this interface and an instance of the implementing class will be created by MEF on startup. Financial events fire on various systems to request components' help validating transactions, and to notify components of transactions' status

See also: FinancialEventsHandler

Remarks [edit]

Methods

void AcquireCurrency(IConnectionIdentity identity, Guid financialCurrencyID)
Called by layer one in response to another component calling IFinancialSystem.AcquireCurrency. If your component knows how to help the user get more of this currency, you can respond and offer UI.
void ResolveTransactionAccount(INeedAccountResolve resolve, bool autoCreate = true)
Components can listen to this event and respond by providing a financial account ID for an entity (account mapping)
void TransactionAuthorized(ITransactionInfo trans)
Called on the service provider to notify your component that a financial transaction has been Authorized (prepared, and currency reserved)
void TransactionCancelled(ITransactionInfo trans)
Called on the service provider to notify your component that a financial transaction has been Cancelled
void TransactionSettled(ITransactionInfo trans)
Called on the service provider to notify your component that a financial transaction has been Settled (completed successfully)
void TransactionUpdate(Guid transactionID, Guid currencyID, TransactionStatus status)
Called on the instance host to notify your component that a financial transaction has change status
TransactionAuthResult ValidateTransaction(ITransactionInfo trans)
Components can respond to this event and participate in "validating" (authorizing) the transaction. Otherwise the core will do basic balance checks and allow the transaction.