HomeEscape API

Service

Name	Add Bank Account
Description	Add bank account
Method	POST
URL	/bills/deposit/bank
Example	/api/bills/deposit/bank
Access	OWNER, MANAGER, TRAVELER

HTTP Headers

Authorization	eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXUyJ9...

Parameters

Fields	Type	Required	Description
account_name	text	yes	Name of the account owner.
account_type	text	yes	Values: checking or saving.
account_holder	text	yes	Values: personal or business.
account_number	number	yes	Number of account.
account_routing	number	yes	Number of rounting.
country	text	yes	Name of the country.

Response

            
                {
                    "code": R111,
                    "message": "Success"
                }

Response Codes

Code	Message	Cause	Possible Frontend Message [Behavior]
`EC000`	`Internal error in API`	Internal error connecting the database	"Oops! Looks like we hit a snag. Try closing the app and reopening it."
`EC001`	`User not found`	Token user id doesn't match our records	"Sorry, We couldn't find your information!"
`EC034`	`Country not found`	Country doesn't match our records	"Please enter a valid Country"
`R000`	`Fail`	The bank account wasn't added
`R111`	`Success`	The operation was successful	[Show the changes]
`SC006`	`User no authorization`	The token role is not valid for using the API services	"You have been logged out." - [Take the user to the login screen]
`SC014`	`Expired token`	The token has expired	"You have been logged out." - [Take the user to the login screen]
`VID247`	`Invalid input for account_name`	Account_name is empty or it doesn't have only letters	"Please fill out this field" - "Account name must have only letters"
`VID248`	`Invalid input for account_type`	Account_type is empty or it is not in ["checking", "saving"]	[Call the API again using a valid value for account_type]
`VID249`	`Invalid input for account_holder`	Account_holder is empty or it is not in ["personal", "business"]	[Call the API again using a valid value for account_holder]
`VID250`	`Invalid input for account_number`	Account_number is empty or it doesn't have only number	"Please fill out this field" - "Account number must have only number"
`VID251`	`Invalid input for account_routing`	Account_routing is empty or it doesn't have only number	"Please fill out this field" - "Account routing must have only number"
`VID252`	`Invalid input for country`	Country name doesn't have only letters	"Country must have only letters"