Transfer funds between Zyla accounts

To transfer money between Zyla accounts, you can use the following APIs:

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

Prerequisites

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

Workflow

The following figure shows the general workflow of how money is transferred between Zyla accounts:

Figure 1. Process to transfer money between Zyla accounts

Procedures

Step 1: Prefund the Zyla account

1. Top up your Zyla account

Ensure your Zyla 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, Zyla 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 Zyla account

Before initiating a transfer request, use the inquiryAccount API to get the details of the beneficiary's Zyla 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 Zyla. 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 Zyla

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

More information

If you want to withdraw your Zyla balances to non-Zyla accounts, e.g. bank accounts or Alipay accounts, see Funds Payout.