Transaction status - Beem API

Use POST /v1/transaction-status to check the status of a previously submitted airtime transfer. Endpoint: https://apiairtime.beem.africa/v1/transaction-status

Request parameters

Headers

Header	Required	Description
`Authorization`	Yes	Basic Auth or access token — see Authentication
`Content-Type`	Yes	`application/json`

Body

Parameter	Type	Required	Description
`transaction_id`	String	Yes	Transaction ID returned when the airtime transfer was submitted

Sample implementations

Node.js
PHP
GitHub

const axios = require("axios");
const https = require("https");
const btoa = require("btoa");

const api_key = "<api_key>";
const secret_key = "<secret_key>";
const url = "https://apiairtime.beem.africa/v1/transaction-status";

const payload = { transaction_id: "<transaction_id>" };

axios
  .post(url, payload, {
    headers: {
      "content-type": "application/json",
      Authorization: "Basic " + btoa(api_key + ":" + secret_key),
    },
    httpsAgent: new https.Agent({ rejectUnauthorized: false }),
  })
  .then((resp) => console.log(resp.data))
  .catch((err) => console.log(err.message));

<?php
$url = "https://apiairtime.beem.africa/v1/transaction-status";
$api_key = '<api_key>';
$secret_key = '<secret_key>';

$body = ['transaction_id' => '<transaction_id>'];

$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Basic ' . base64_encode("$api_key:$secret_key"),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode($body),
  CURLOPT_SSL_VERIFYHOST => 0,
  CURLOPT_SSL_VERIFYPEER => 0,
]);

$response = curl_exec($ch);
if ($response === false) {
  die(curl_error($ch));
}
var_dump($response);
?>

Success response

HTTP 200 OK

{
  "code": 100,
  "message": "SUCCESSFUL",
  "args": {
    "timestamp": "2021-06-09T09:21:39.000Z",
    "transaction_id": "1623230499585",
    "reference_id": "12345678",
    "amount": "12345678",
    "dest_addr": "255701000000"
  }
}

Error responses

Invalid transaction ID
Invalid authentication
Missing authorization

HTTP 400 Bad Request

{
  "code": 400,
  "message": "Invalid Transaction Id"
}

HTTP 401 Unauthorized

{
  "code": 120,
  "message": "Invalid Authentication Parameters"
}

HTTP 400 Bad Request

{
  "error": "No authorization headers"
}