Making Bank Payments Using Beyonic

We at Beyonic are pleased to announce that we now support bank payments in Kenya and Uganda. We support 26 banks in Uganda and another 32 in Kenya. Via our portal and API, we provide a standard way of making payments to all the banks.

The process is as simple as below:

1. Create a contact.
2. Create the contact’s bank account.
3. Pay the bank account!

I will expound on each of the steps above.

STEP 1

First login into your @beyonic account using https://payments.beyonic.com/users/login/. You may be required to verify using our state of the art two factor authentication via SMS, Phone Call or Google Authenticator or Authy.

Beyonic Login Page

Creation of a contact can be done via the Beyonic web or API platforms.

For the web platforms use the url https://payments.beyonic.com/contacts/contact/create/ while for the API platform follow the instructions at https://apidocs.beyonic.com/#creating-a-new-contact.

If the bank account you want to add belongs to an already existent account then you can skip this step.

STEP 2

Create the contact’s bank account. To do this, go to the contact list page https://payments.beyonic.com/contacts/contact/ and select the specific contact. Select the contact bank accounts tab.

Beyonic Contact Page, Bank Accounts Tab

Here you will see the existent accounts. Click the create new button to create a new button. You will be redirected to a screen as below. Ensure to fill the mandatory fields i.e. Account number, bank, account label and currency. Thereafter click the create button.

You will be redirected to a page with the bank account details. Viola you have created your first contact bank account! You can now proceed to pay him or her.

STEP 3

Click the payments tab on the side bar and select create new payment.

Select the “Send Bank Payment” Tab and select the contact bank account you want to pay.

Enter the description, amount, choose the wallet and if you want to send the recipient an SMS when the payment is made.

Now here comes the interesting bit.

Say I’m the finance manager in Company X and I want to pay salaries to John Doe for whom we have a one year contract with. I don’t have to repeat the whole process every month.

I can just select the scheduling controls and decide when to send. In this case I will add a rule to send every 28th of the month and repeat until 28th December 2020 when John Doe’s contract will expire.

However the scheduling feature is optional and we encourage you to take great caution while using it.

Click create and Beyonic will take care of the rest. Every 28th of the month John Doe will be receiving his salary while I the finance manager will be getting the statements. If you did not choose the scheduling controls then it will be sent out once only.

Sending Via API

For those making payments via API in the API docs. The endpoint remains the same i.e. https://app.beyonic.com/api/payments. The major difference with the mobile money payments is that you will be sending additional data. There are two scenarios.

Scenario one

The contact bank account does not exist in the Beyonic System. The following fields have to be present:

• account_name : The name of the account to be created
• account_number : The account number of the recipient in the bank
• bank : The id of the bank in Beyonic ( see instructions of retrieving below)

The request payload JSON will be as below:

Postman request for Beyonic bank Payment to a new Bank Account

Note that a contact will be created in the Beyonic System using the phone number provided in the payload and the bank account linked to the contact. If a contact with the given phone number existed in Beyonic then the account will be tied to the contact. If an account with the given account umber already existed then no new account will be created.

Scenario two

The contact bank account already existed in Beyonic. The following fields have to be present:

• contact_bank_account : This is the id of the contact bank account in Beyonic. Not that the contact id and the contact bank account id are different, be sre to use the correct one.

Postman request for Beyonic Bank Payment with existing bank account

In both payment scenarios remember to set the payment_type as “bank”.

Getting supported banks

On the web platform, find the supported banks at https://payments.beyonic.com/bankpayments/bank/.

On API find the supported banks by making a GET request to https://app.beyonic.com/api/banks as described in the API docs.

Beyonic list Bank Payments API

The JSON response will contain a list of banks in the results object. Each bank object will be as follows:

{
“id”: 6,
“name”: “Absa Bank (Barclays)”,
“country”: {
           “iso”: “UG”,
           “iso3”: “UGA”,
           “iso_numeric”: 800,
           “name”: “UGANDA”,
            “printable_name”: “Uganda”,
            “phone_prefix”: “256”,
            “supported”: true
     },
“swift_code”: null
}

After the schedule is created, if you have approval rules in your organization then it will have to be approved just like with mobile money payments. After a successful bank payment, if you chose to send SMS the recipient will receive one from Beyonic. The recipient’s bank may or may not send the bank payment sms or statement after the transaction.

Transaction Times

For Kenyan transactions the payment is instant. For Uganda transactions the payment may take between 2minutes to 3 hours to be cleared depending on the bank. However, we are in discussion with the banks to make this process instant too.

Support

In case of any queries feel free to contact us at support@beyonic.com or any of the other methods at https://beyonic.com/contact-us/.

Enjoy a seamless experience with Beyonic!