How to integrate FBOT with your App.

FBOT is an automated payment application.

Initialize and Verify a Bank Account.

This deep link is used to verify and check User state on FBOT application. If the user does not have any banking credentials stored, FBOT will prompt the internet banking login screen to log in and store it for the next time.

DEEP LINK

fbot://verify

QUERY STRING

Query StringAdditional info
bankAccount (required) The default bank account number which the user selects to make the payment process (assuming that the user is has already selected a default bank account). For example, 1234567890 (you need to remove the dashes in between).
callback(required)The deeplink that is used to jump back to the caller app when the initial and verify steps are finished. The payment status is return as query string with the key name status. For example, if the callback link is app://verify, FBOT will return the callback as: app://verify?status=success or app://verify?status=failed&errorCode=<error_code>the error code is describe below.

ERROR CODE

Error NumberReasons
100An internal error case. Developers are advised to contact an admin.
101Cannot find a matching bank account number on the FBOT internet banking account. 
102Cannot verify the bank account with internet banking. It is possible that the internet banking service is not available or is broken. 

Create a Transaction from an External App.

This deep link is used for making a payment transaction. Furthermore, it is necessary to complete the initialize and verify bank account steps above.

DEEP LINK

fbot://payment

QUERY STRING

Query StringAdditional Info
destinationNumber  (required) A general number that is used to signify the destination that you want to send to.
amount (required) the amount of money to send.
callback(required)The deeplink that is used to jump back to the caller app when the payment is processed and finished. The payment status is return as query string with key name status. For example, if the callback link is app://payment/1, FBOT will return the callback asapp://payment/1?status=success or app://payment/1?status=failed&errorCode=<error_code>
NOTE: We plan to return the error code with a failed status soon.

ERROR CODE

Error CodeReasons
200 An internal error case. Developers are advised to contact an admin.
201Tried to make a payment with FBOT, but without a synced bank account. This happens when the user uninstalls FBOT after FBOT has already been registered (account does not match failed status case).
202FBOT cannot create the transaction. It is possible that the internet banking service is not available or is broken. 

August 27, 2019 - posted by fbotapplication

Categories