Get transaction status
POST
/api/global/transaction-status
curl -X POST "https://api.payhero.africa/api/global/transaction-status" \ -u "API_USERNAME:API_PASSWORD" \ -H "Content-Type: application/json" \ -d '{ "request_id": "KAD061833323iI"}'<?php$ch = curl_init("https://api.payhero.africa/api/global/transaction-status");$options = [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_USERPWD => "API_USERNAME:API_PASSWORD", CURLOPT_HTTPHEADER => ["Content-Type: application/json"], CURLOPT_POSTFIELDS => json_encode([ "request_id" => "KAD061833323iI", ]),];curl_setopt_array($ch, $options);$response = curl_exec($ch);curl_close($ch);echo $response;import requests
response = requests.post( "https://api.payhero.africa/api/global/transaction-status", auth=("API_USERNAME", "API_PASSWORD"), json={ "request_id": "KAD061833323iI", },)print(response.json())const auth = Buffer.from("API_USERNAME:API_PASSWORD").toString("base64");
const response = await fetch("https://api.payhero.africa/api/global/transaction-status", { method: "POST", headers: { Authorization: `Basic ${auth}`, "Content-Type": "application/json", }, body: JSON.stringify({ "request_id": "KAD061833323iI" }),});
const data = await response.json();console.log(data);Look up the current status of a transaction by its request ID.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
request_id
required
The merchant/request reference returned when the transaction was created.
string
Example
KAD061833323iIResponses
Section titled “Responses”Transaction status retrieved.
Missing or invalid Basic auth credentials.
Media typeapplication/json
object
error_code
string
error_message
string
status_code
integer
Example
{ "error_code": "invalid_argument", "error_message": "the transaction amount is insufficient as it wont cater for cost: (4.62)", "status_code": 400}