Callbacks

You can choose to receive callbacks once a transaction is completed. A unique signing key is generated for your account and used to sign the callback data, providing an additional layer of authenticat

To generate a signature you will have to create signature data and this includes the following

data = <reqTransactionID+transactionID+amount+status>
hmacData = HMAC256(data, signingKey)
signature = base64.encoding(hmacData)

<?php
function generateSignature($reqTransactionID, $transactionID, $amount, $status, $signingKey) {
    // Concatenate the fields
    $data = $reqTransactionID . $transactionID . $amount . $status;
    
    // Create HMAC-SHA256 using signingKey
    $hmac = hash_hmac('sha256', $data, $signingKey, true);
    
    // Return Base64-encoded signature
    return base64_encode($hmac);
}

// Example
$signature = generateSignature("REQ123", "TXN456", "50000", "SUCCESS", "my_secret_key");
echo $signature;

import crypto from "crypto";

export function generateSignature(
  reqTransactionID: string,
  transactionID: string,
  amount: string | number,
  status: string,
  signingKey: string
): string {
  const data = `${reqTransactionID}${transactionID}${amount}${status}`;
  const hmac = crypto.createHmac("sha256", signingKey).update(data).digest();
  return hmac.toString("base64");
}

// Example
const signature = generateSignature("REQ123", "TXN456", 50000, "SUCCESS", "my_secret_key");
console.log(signature);

import hmac
import hashlib
import base64

def generate_signature(reqTransactionID, transactionID, amount, status, signing_key):
    # Concatenate fields
    data = f"{reqTransactionID}{transactionID}{amount}{status}"
    
    # Create HMAC-SHA256 hash
    hmac_data = hmac.new(signing_key.encode(), data.encode(), hashlib.sha256).digest()
    
    # Encode in Base64
    signature = base64.b64encode(hmac_data).decode()
    return signature

# Example
signature = generate_signature("REQ123", "TXN456", "50000", "SUCCESS", "my_secret_key")
print(signature)

{
"code": "200",
"reqTransactionID": "876765454543",
"status": "SUCCESS",
"transaction": {
    "status": "SUCCESS",
    "mnoTransactionID": "9867542234445",
},
"transactionID": "554813f9-0113-4fab-813b-5970d44454bc",
"signature": "MmUwZmM1MjdiNmM3ODE3YTUzY2UyZjAwYTc1ZTFhNDcxNzdiODk3NWE1OTc3ODZmNDBkYzYzYWM1N2EyYmNhNw=="
}

{
"code": "200",
"reqTransactionID": "876765454543",
"status": "SUCCESS",
"transaction": {
    "status": "FAILED",
    "message": "Reason for failure",
    "mnoTransactionID": "9867542234445",
},
"transactionID": "554813f9-0113-4fab-813b-5970d44454bc",
"signature": "MmUwZmM1MjdiNmM3ODE3YTUzY2UyZjAwYTc1ZTFhNDcxNzdiODk3NWE1OTc3ODZmNDBkYzYzYWM1N2EyYmNhNw=="
}

PreviousCheck Status NextError Codes

Last updated 1 month ago