Download Brand Mobiliser Development Manual

Money Mobiliser State – Transaction Service
Name
Descriptions
Send Money
Send money transaction should be conducted using a two-step transaction involving: PreAuthorization and Commit, as follows:
Pre-Authorization - checks whether there is enough money available for the
transaction, followed by reserving the money so that it is not accessible for other
transactions.
Commit – proceed the actual transaction of debiting the money and fees. The fees
are modeled using different Use Case IDs that are implemented in Money Mobiliser.
The Commit is performed using this state.
This state is used in conjunction with the “Pre-Authorized Send Money” state.
Input Variables
Currency of transaction - The currency for the transaction
Use Case ID - The Use Case ID identifies the type of transaction. The Use Case for a
CashOut transaction is 1005.
Amount - The Amount for the transaction
Optional PIN for Bank Accounts or other PIs - If money is debited from a bank account, the
customer must enter the pin for the respective bank account.
Payer Identification Type - The identification type of the payer. This can be “by mobile
No.”, “by customer ID” or “by user name”.
Payer Identification - The payer is identified here. Normally, this ID is retrieved through
the mobile number. so this field can be left blank.
Payer PI ID - The identification of the payment instrument used by the payer.
Payer PI class - The class of the payment instrument used by the payer. This could be
“Stored Value Account”, “Bank Account”, “Credit Card” or “External Account”.
Payee Identification Type - The identification type of the payee. This could be “by mobile
No.”, “by customer ID” or “by user name”.
Payee Identification - The identification of the payee.
Payee PI ID - The identification of the payment instrument for the payee.
Payee PI class - The class of the payment instrument used for the payee. This could be
“Stored Value Account”, “Bank Account”, “Credit Card” or “External Account”.
Output Variables
Transaction ID - Internal system reference number that identifies the transaction.
Authorisation code - This code identifies the transaction. It is the customers reference to
the transaction in the system and appears on the receipt. The customer can use this code
to track the transaction and request assistance from customer support if there are any
problems.
Follow-up State – OK
Send Money completed successfully.
Follow-up State – Fail
Possible reasons:
Missing Payer and/or Payee Identifications
Unknown Web service error
Web service connection error
Follow-up State – DYN
Error Codes – See Appendix B9 Money Error codes.
136
Brand Mobiliser Development Manual
Version 1.2 - September 2011