View Customer Transactions

POST {api-url}/viewCustomerTransactions1?ns={community}

Use this call to get a paginated list of transactions for a user.

Request

Parameters

Field	Type	Requirement	Description
DateFrom	String	Required	Specify the starting date and time for the search (YYYY/MM/DD HH:MM).
DateTo	String	Required	Specify the ending date and time for the search (YYYY/MM/DD HH:MM).
Username	String	Required	A unique username of the user.
TransactionType	String	Required	A filter for the type of transaction you would like to list. Can be set to All.
Limit	String	Optional	An integer to limit the quantity of transaction responses.
Cursor	String	Optional	The cursor string from a previous response to fetch the next page.
Metadata	String	Optional	Any other detail that the merchant wishes to store on this transaction.

Example Body

{
  "Username": "27820000000",
  "DateFrom": "2024/05/11 16:00",
  "DateTo": "2024/05/11 23:00",
  "Limit": "100",
  "Cursor": "",
  "TransactionType": "All",
  "Metadata": "{\"ActorUserIDs\": \"547828938941114\"}"
}

Response

The response will be returned as an array of transaction objects.

Parameters (per object)

Field	Type	Description
TransactionList	Array	An array of transaction objects mapping the financial history of the user.
TID	String	TID (Transaction ID) of the executed lookup response.
Cursor	String	A cursor string to use in the next request to fetch the subsequent page.
State	String	Transaction state (Success or Failed).
Status	String	Transaction status code (1 or negative error code).
Error	String	Failure reason, if applicable.

Example Body

{
    "TransactionList": [
        {
            "TID": "8615615066",
            "Community": "celbux",
            "Date": "2024/05/11",
            "Time": "12:00",
            "Type": "Buy",
            "Amount": "2000",
            "Fee": "60",
            "Recipient": "27820000000",
            "ReverseID": "8515615069",
            "ConfirmID": "1",
            "State": "Success",
            "Reference": "101",
            "Direction": "OUT",
            "Currency": "ZAR"
        }
    ],
    "TID": "15000000000",
    "Cursor": "a1dJW2xrY3ksLRtJS0Uh...",
    "State": "Success",
    "Status": "1",
    "Error": ""
}

cURL

curl -X POST '{api-url}/viewCustomerTransactions1?ns={community}' \
-H 'Authorization: bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"Username":"27820000000","DateFrom":"2024/05/11 16:00","DateTo":"2024/05/11 23:00","Limit":"100","Cursor":"","TransactionType":"All","Metadata":"{\"ActorUserIDs\": \"547828938941114\"}"}'

C#

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

class Program
{
    static async Task Main(string[] args)
    {
        var client = new HttpClient();
        var request = new HttpRequestMessage(HttpMethod.Post, "{api-url}/viewCustomerTransactions1?ns={community}");
        request.Headers.Add("Authorization", "bearer YOUR_TOKEN");

        var jsonPayload = @"{
  ""Username"": ""27820000000"",
  ""DateFrom"": ""2024/05/11 16:00"",
  ""DateTo"": ""2024/05/11 23:00"",
  ""Limit"": ""100"",
  ""Cursor"": """",
  ""TransactionType"": ""All"",
  ""Metadata"": ""{\""ActorUserIDs\"": \""547828938941114\""}""
}";
        request.Content = new StringContent(jsonPayload, Encoding.UTF8, "application/json");

        var response = await client.SendAsync(request);
        response.EnsureSuccessStatusCode();

        var responseBody = await response.Content.ReadAsStringAsync();
        Console.WriteLine(responseBody);
    }
}

Go

package main

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

func main() {
  url := "{api-url}/viewCustomerTransactions1?ns={community}"
  payload := strings.NewReader(`{"Username":"27820000000","DateFrom":"2024/05/11 16:00","DateTo":"2024/05/11 23:00","Limit":"100","Cursor":"","TransactionType":"All","Metadata":"{\"ActorUserIDs\": \"547828938941114\"}"}`)

  req, _ := http.NewRequest("POST", url, payload)
  req.Header.Add("Authorization", "bearer YOUR_TOKEN")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()

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

Java

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

public class ApiRequest {
    public static void main(String[] args) throws Exception {
        var payload = """
                {
  "Username": "27820000000",
  "DateFrom": "2024/05/11 16:00",
  "DateTo": "2024/05/11 23:00",
  "Limit": "100",
  "Cursor": "",
  "TransactionType": "All",
  "Metadata": "{\"ActorUserIDs\": \"547828938941114\"}"
}
                """;

        var request = HttpRequest.newBuilder()
                .uri(URI.create("{api-url}/viewCustomerTransactions1?ns={community}"))
                .header("Authorization", "bearer YOUR_TOKEN")
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(payload))
                .build();

        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Node.js

// Requires Node.js v18+
(async () => {
    const url = '{api-url}/viewCustomerTransactions1?ns={community}';
    const payload = {
    "Username": "27820000000",
    "DateFrom": "2024/05/11 16:00",
    "DateTo": "2024/05/11 23:00",
    "Limit": "100",
    "Cursor": "",
    "TransactionType": "All",
    "Metadata": {
        "ActorUserIDs": "547828938941114"
    }
};

    try {
        const response = await fetch(url, {
            method: 'POST',
            headers: {
                'Authorization': 'bearer YOUR_TOKEN',
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(payload)
        });
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
})();

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '{api-url}/viewCustomerTransactions1?ns={community}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
  "Username": "27820000000",
  "DateFrom": "2024/05/11 16:00",
  "DateTo": "2024/05/11 23:00",
  "Limit": "100",
  "Cursor": "",
  "TransactionType": "All",
  "Metadata": "{\"ActorUserIDs\": \"547828938941114\"}"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: bearer YOUR_TOKEN',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;

Python

import requests
import json

url = "{api-url}/viewCustomerTransactions1?ns={community}"
payload = {
  "Username": "27820000000",
  "DateFrom": "2024/05/11 16:00",
  "DateTo": "2024/05/11 23:00",
  "Limit": "100",
  "Cursor": "",
  "TransactionType": "All",
  "Metadata": {
    "ActorUserIDs": "547828938941114"
  }
}

headers = {
    "Authorization": "bearer YOUR_TOKEN",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Ruby

require 'uri'
require 'net/http'
require 'json'

url = URI("{api-url}/viewCustomerTransactions1?ns={community}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'bearer YOUR_TOKEN'
request["Content-Type"] = 'application/json'

request.body = JSON.dump({
  "Username": "27820000000",
  "DateFrom": "2024/05/11 16:00",
  "DateTo": "2024/05/11 23:00",
  "Limit": "100",
  "Cursor": "",
  "TransactionType": "All",
  "Metadata": {
    "ActorUserIDs": "547828938941114"
  }
})

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