beemafrica

go-client

Go libary to ease the integration with the Beem Africa (SMS, AIRTIME, OTP, 2WAY-SMS, BPAY, USSD)

Installation

To start using this in your project

go get -u github.com/Jkarage/beemafrica

Authentication

To authenticate and usage of the package add your credentials to your environment.

For Unix Based

export BEEM_API_KEY=<your beem api key>
export BEEM_SECRET_KEY=<your beem secret key>

For Windows

set BEEM_API_KEY=<your beem api key>
set BEEM_SECRET_KEY=<your beem secret key>

Run Tests with one command

    go test ./... -v

Sending SMS with beemAfrica

You can now send sms to multiple recipients with this package by just adding your credentials to the environment.

Usage Example

package main

import (
 "io"
 "log"
 "os"

 "github.com/Jkarage/beemafrica"
)

func main() {
 sms := beemafrica.NewSMS()
 resp, err := sms.SendSMS("Sample text message", []string{"2557135070XX"}, "")
 if err != nil {
  log.Fatal(err)
 }
 io.Copy(os.Stdout, resp.Body)
}

Requesting the sms Ballance from beemAfrica

The package provides an api for requesting the sms ballance in a specific account.

SMS Usage Example

package main

import (
 "io"
 "log"
 "os"

 "github.com/Jkarage/beemafrica"
)

func main() {
 client := beemafrica.NewSMS()
 resp, err := client.GetBallance()
 if err != nil {
  log.Fatal(err)
 }
 io.Copy(os.Stdout, resp.Body)

 io.Copy(os.Stdout, resp.Body)
}

AIRTIME

Sending airtime to a friend

    client := beemafrica.NewAirtime()
    resp, err := client.Transfer("2557135070XX", 2000, 1234)
    if err != nil {
    log.Fatal(err)
    }
    io.Copy(os.Stdout, resp.Body)

Getting airtime ballance

    client := beemafrica.NewAirtime()
    resp, err := client.GetBallance()
    if err != nil {
    log.Fatal(err)
    }
    io.Copy(os.Stdout, resp.Body)

OTP

Requesting an OTP PIN

    client := beemafrica.NewOTP()
    resp, err := client.Request("2557135070XX", 12XX)
    if err != nil {
    log.Fatal(err)
    }

    io.Copy(os.Stdout, resp.Body)

Verifying an OTP PIN

client := beemafrica.NewOTP()
 resp, err := client.Verify("44bcae75-15ff-4885-915c-6eeba6xxxxx", "57XXXX")
 if err != nil {
  log.Fatal(err)
 }

 io.Copy(os.Stdout, resp.Body)