WorldFirst DocsWorldFirst DocsDOCS

Transfer funds

You can programmatically create a transfer request by calling the WorldFirst transfer APIs. Additionally, you can command the transfer process with appropriate input and applicable parameters.

The following figure illustrates the overall transfer process:

image

Figure 1. Overall transfer process

  1. 1

    Step 1. Prefund

    3 steps Collapse all Expand all

    You need to pre-fund your account before utilizing WorldFirst services to transfer funds. Contact WorldFirst and transfer pre-funding funds to an allocated account offline. Click on the Expand all button to view the precedures:

      1. 1. Make offline prefunding

        Mark the card Unmark the card

        Contact WorldFirst and transfer pre-funding funds to an allocated account offline. 

      2. 2. Check prefunding balance

        Mark the card Unmark the card

        Call the inquiryBalance API to check whether your account has been successfully pre-funded.

      3. 3. Receive prefunding notification

        Mark the card Unmark the card

        WorldFirst sends out a notification with the notifyVostro interface after receiving the funds from banking institutions. You need to acknowledge the reception of the notification and process the result accordingly.

    1. 2

      Step 2. Transfer funds

      3 steps Collapse all Expand all

      After your account is successfully prefunded, proceed to transfer funds. Click on the Expand all button to view the necessary steps:

      1. 1. Ensure sufficient balance

        Mark the card Unmark the card

        As the best practice, call the inquiryBalance API before making a transfer request to ensure the account balance is sufficient.

        1. 2. Create a transfer request

          Mark the card Unmark the card

          Call the createTransfer API to initiate a transfer request.

          • The transfer process is asynchronous. WorldFirst responds in the createTransfer API indicating the transfer request is being processed. Call the inquiryTransfer API to obtain the transfer result.

          • (Optional) For a cross-currency transfer request, you can specify the foreign exchange quote in the transferToDetail.transferQuote field.

        2. 3. Receive transfer notification

          Mark the card Unmark the card

          WorldFirst sends out the result notification with the notifyTransfer API. You need to acknowledge the reception of the notification and process the result accordingly.