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.