After the customer gets onboard with WorldFirst, you are granted to the account management features such as:

• Inquire about the account information: The Partner can query the relevant account information. Currently, WorldFirst only supports inquires information about a Customer's Receiving Accounts.
• Check account balances: You may query the remaining balance of your Virtual Account (VA), or receive notifications for balance changes.

Compare the differences between a Receiving Account and a Virtual Account:

Receiving Account (RA)

A Receiving Account is used for the purpose of receiving funds using WorldFirst services. Every Customer is entitled to a unique Receiving Account after getting onboarded with WorldFirst. 

Information about a Receiving Account include:

• Account type: Receiving Account
• Account number
• Account status
• Currencies of the account

Note: There isn't an "account balance" for a Receiving Account since it is not a bank account registered at a banking institution. To check the account balance for a Customer, refer to Virtual Account.

Virtual Account (VA)

A bank account that is assigned by WorldFirst to a Customer. A Virtual Account is used for making monetary transfers between banking institutions.

To query the Customer's account balance, you are checking the remaining account balance of the Customer's Virtual Account.

Inquire about the account information

The Partner can make inquires about associated accounts with the inquiryAccount API.

For example, the Partner can call the inquiryAccount API to check the account status after the Customer onboarding process. WorldFirst returns account information such as the account number, currency, etc.

Note: Currently, the Partner can only query information of a Customer's Receiving Account.

The following graphic illustrates the steps to check account balances:

Figure 2. Query account information

Check account balances

You can call the inquiryBalance API to check the remaining balance of your Virtual Account. For example:

• After the Partner makes a prefunding deposit, the Partner can call the inquiryBalance API to check if WorldFirst has received the prefund.
• Before making a transfer request, the Partner can call the inquiryBalance API to check if the account balance is sufficient.

WorldFirst notifies the Partner with the notifyVostro API when the Partner's Virtual Account's balance changes.

The graphic below illustrates the process in general:

Figure 3. Check account balances with WorldFirst APIs