Check Transaction Status
curl --request POST \
--url https://api.payaza.africa/live/card/card_charge/transaction_status \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"service_payload": {
"transaction_reference": "A12345"
}
}
'import requests
url = "https://api.payaza.africa/live/card/card_charge/transaction_status"
payload = { "service_payload": { "transaction_reference": "A12345" } }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({service_payload: {transaction_reference: 'A12345'}})
};
fetch('https://api.payaza.africa/live/card/card_charge/transaction_status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.payaza.africa/live/card/card_charge/transaction_status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'service_payload' => [
'transaction_reference' => 'A12345'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.payaza.africa/live/card/card_charge/transaction_status"
payload := strings.NewReader("{\n \"service_payload\": {\n \"transaction_reference\": \"A12345\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.payaza.africa/live/card/card_charge/transaction_status")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"service_payload\": {\n \"transaction_reference\": \"A12345\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.payaza.africa/live/card/card_charge/transaction_status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"service_payload\": {\n \"transaction_reference\": \"A12345\"\n }\n}"
response = http.request(request)
puts response.read_body{
"response_code": 200,
"response_message": "Transaction data found",
"response_content": {
"transaction_reference": "T1313X12372",
"transaction_amount": 3,
"transaction_fee": 0.05,
"transaction_amount_payable": 3,
"transaction_status": "Completed",
"payer_name": "John Doe",
"source_bank_name": "MASTERCARD",
"payment_date": "2026-10-23 14:28:46.897",
"created_at": "2026-10-23 14:28:46.897",
"debug_message": "Payment Approved"
}
}Card Collection
Check Transaction Status
This endpoint gets the transaction status corresponding to the provided transaction reference for a card transaction.
POST
/
card
/
card_charge
/
transaction_status
Check Transaction Status
curl --request POST \
--url https://api.payaza.africa/live/card/card_charge/transaction_status \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"service_payload": {
"transaction_reference": "A12345"
}
}
'import requests
url = "https://api.payaza.africa/live/card/card_charge/transaction_status"
payload = { "service_payload": { "transaction_reference": "A12345" } }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({service_payload: {transaction_reference: 'A12345'}})
};
fetch('https://api.payaza.africa/live/card/card_charge/transaction_status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.payaza.africa/live/card/card_charge/transaction_status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'service_payload' => [
'transaction_reference' => 'A12345'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.payaza.africa/live/card/card_charge/transaction_status"
payload := strings.NewReader("{\n \"service_payload\": {\n \"transaction_reference\": \"A12345\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.payaza.africa/live/card/card_charge/transaction_status")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"service_payload\": {\n \"transaction_reference\": \"A12345\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.payaza.africa/live/card/card_charge/transaction_status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"service_payload\": {\n \"transaction_reference\": \"A12345\"\n }\n}"
response = http.request(request)
puts response.read_body{
"response_code": 200,
"response_message": "Transaction data found",
"response_content": {
"transaction_reference": "T1313X12372",
"transaction_amount": 3,
"transaction_fee": 0.05,
"transaction_amount_payable": 3,
"transaction_status": "Completed",
"payer_name": "John Doe",
"source_bank_name": "MASTERCARD",
"payment_date": "2026-10-23 14:28:46.897",
"created_at": "2026-10-23 14:28:46.897",
"debug_message": "Payment Approved"
}
}Authorizations
Payaza {{Public API Key in Base 64}}
Body
application/json
Payload containing the transaction reference to query.
Show child attributes
Show child attributes
Response
Check Transaction Status Response
The HTTP or internal response code indicating the result of the operation.
Example:
200
A descriptive message regarding the overall outcome of the query.
Example:
"Transaction data found"
The payload containing the detailed transaction data.
Show child attributes
Show child attributes