GET: Transaction Status - DarajaPay API Documentation

Fetch transaction status

GET https://darajapay.com/api/v1/transaction-status

Query Parameters

Name	Type	Description
reference*	String	The reference that was returned in the original transaction request

Headers

Name	Type	Description
Authorization*	String	Basic authToken

200: OK Results

{
    "transaction_date": "2024-11-26T08:41:14.160604Z",
    "provider": "m-pesa",
    "success": true,
    "merchant": "Ron Doe",
    "payment_reference": "",
    "third_party_reference": "SKQ96C7K7H",
    "status": "SUCCESS",
    "reference": "6b71cb8b-638d-4b6e-9c7c-b0334a641e3a",
    "CheckoutRequestID": "",
    "provider_reference": "SKQ96C7K7H"
}

From the response you can pick the status parameter to determine if the transaction was successful or not when successful the value will be SUCCESS any other value means the transaction has not been processed

Possible values for status

QUEUED- Payment has been queued and we have not received callback
SUCCESS- Payment has been successfully
FAILED- Payment Failed

Code Examples

PHP

<?php
$url = 'https://darajapay.com/api/v1/transactions/status/TRANSACTION_ID';

$headers = array(
    'Content-Type: application/json',
    'Authorization: Basic YOUR_API_KEY'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Python

import requests

url = "https://darajapay.com/api/v1/transactions/status/TRANSACTION_ID"
headers = {
    "Authorization": "Basic YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

Node.js

const axios = require('axios');

const config = {
    headers: {
        'Authorization': 'Basic YOUR_API_KEY'
    }
};

axios.get('https://darajapay.com/api/v1/transactions/status/TRANSACTION_ID', config)
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

Java

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class TransactionStatusExample {
    public static void main(String[] args) {
        String url = "https://darajapay.com/api/v1/transactions/status/TRANSACTION_ID";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Basic YOUR_API_KEY")
            .GET()
            .build();

        client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
            .thenApply(HttpResponse::body)
            .thenAccept(System.out::println)
            .join();
    }
}

C#

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var url = "https://darajapay.com/api/v1/transactions/status/TRANSACTION_ID";
        
        client.DefaultRequestHeaders.Add("Authorization", "Basic YOUR_API_KEY");
        
        var response = await client.GetAsync(url);
        var result = await response.Content.ReadAsStringAsync();
        
        Console.WriteLine(result);
    }
}

Go

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://darajapay.com/api/v1/transactions/status/TRANSACTION_ID"
    
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Basic YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Ruby

require 'uri'
require 'net/http'

url = URI("https://darajapay.com/api/v1/transactions/status/TRANSACTION_ID")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Basic YOUR_API_KEY"

response = http.request(request)
puts response.read_body