Transfer funds between WF accounts

To transfer money between WorldFirst (WF) Accounts, you can use the following APIs:

• consultTransfer: Mimic a transfer and verify the details.
• createTransfer: Transfer money to the beneficiary's WF account.
• inquiryTransfer: Check the transfer result.
• notifyTransfer: Receive transfer result from WorldFirst.

Prerequisites

• Ensure that you have a valid WF account.
• Ensure that the beneficiary has a valid WorldFirst Receiving Account (RA). For instructions on how to create an RA for your customers, see Create a Receiving Account for Customers.

Workflow

The following graphic shows the general workflow of how money is transferred between WF accounts:

Figure 1. Workflow to transfer money between WF accounts

Procedures

Step 1: Prefund the WF account

1. Top up your WF account

Ensure your WF account has enough funds for the transfer by topping it up with the required amount. If you encounter any issues, contact our Technical Support Team for assistance.

2. Get prefunding results

After prefunding, WorldFirst returns the prefunding results via the notifyVostro API. You need to acknowledge the receipt of the returned results. Additionally, you can call the inquiryBalance API to verify that your account is prefunded successfully.

3. Verify the beneficiary's WF account

Before initiating a transfer request, use the inquiryAccount API to get the details of the beneficiary's WF account and ensure it is valid and ready to receive a transfer.

Step 2: Transfer funds

1. (Optional) Mimic a transfer process

For a cross-currency transfer, call the consultTransfer API to mimic a transfer process and carefully check the information returned from WorldFirst. This step is optional if no currency conversion is needed.

2. Initiate a transfer request

Call the createTransfer API to initiate a transfer request.

3. Inquire about transfer results

Call the inquiryTransfer API to inquire about the transfer results. Set a maximum timeout of 2 hours to stop the polling process.

4. Receive the transfer results from WorldFirst

WorldFirst sends the transfer results via the notifyTransfer API. After receiving the results, you need to acknowledge the notification by sending a response message to WorldFirst.

More information

For instructions on how to withdraw your WorldFirst balances to non-WF accounts, such as bank accounts or Alipay accounts, see Funds Payout.