Funding through Bank Transfer

Many customers rely on bank transfers as their primary payment method. Wallet Engine makes it easy for your customers to use bank transfers to deposit money to the wallets.

Prior to this use case, your customer selects top-up via Bank Transfer. First, your application needs to set up international money transfer on Wallet Engine. Second, based on the information exchanged with Wallet Engine, your application provides the customer with transfer details.

Your customer will need to exit the application and pay by bank transfer directly through their bank, they can do this either:

• Through online banking, mobile app, from anywhere.

• Over the phone, with telephone banking.

• Directly, at a local bank branch.

Use Case Overview

• Alice is your customer who selects the bank transfer option at the top-up page. Your backend asks Wallet Engine to verify and create a payment request. This will bring up the request_id as well as a reference, and the total amount after calculating the transaction fee. Your application provides Alice with that information and the Wallet Engine bank transfer information.

• Alice then needs to instruct her bank to make the transfer. She can browse to the bank’s website, use the bank’s mobile app, call the bank via telephone, or visit a bank branch. In fact, the transfer can be made by anyone and from any country, just provide the correct transfer information, then Alice will receive the money into the wallet.

• Wallet Engine notifies your backend when the bank transfer is completed successfully (via Webhook). Your application notifies Alice that the purchase succeeded or wallet has been top-upper.

Bank Transfer Workflow

In previous steps:

• Your application displays a top-up channel for a bank transfer with a fee.

• The customer selects the bank transfer payment method and clicks Confirm.

Highlights in your workflow and the basic stage.

…

• Stage 1:

  • Your application backend requests Wallet Engine to process a bank transfer payment.

  • Wallet Engine processes the transaction and responds with request_id, fee, and total amount.

• Stage 2:

  • Your application displays the payment instructions to the customer and finish.

  • To make sure the top-up process isn't delayed, please double-check that:

    • Your customers included the reference correctly: this helps us identify the client and proceed with the transfer. For the reference, you can use client_id or request_id.

    • Your customers enter the exact amount they are sending with Wallet Engine. Transfer more or less could delay the top-up process.

• Stage 3:

  • Wallet Engine is notified that the transfer was successful. Wallet Engine notifies your application backend that the payment was completed successfully.

  • Your application notifies the customer that the wallet has been top-upped or the purchase succeeded.

Implementing the Workflow

How you'll use Wallet Engine’s API to implement the workflow.

When the customer clicks Confirm, your application backend calls the API below to create the payment:

/topup/bank

POST https://sandbox.walletengine.io/api/topup/bank

Request Body

Name	Type	Description
app_id	string
amount	number
channel_id	string

200

{
  "request_id": "5dee1542283a5",
  "amount": 25,
  "fee": 0.1,
  "total": 25.1
}

Example Request

{
  "app_id": "1db2a50be7626",
  "amount": 25,
  "channel_id": "credit_bank"
}

Your application shows the instructions for completing the payment.

Closing the Transaction

After the customer’s bank transfer and Wallet Engine is informed that the money was received. Wallet Engine sends you a webhook with the details of the transaction.

Now you can display a page telling your customer that their top-up or purchase was successful and closes out the transaction with your customer.