curl --request GET \
--url https://api.jenzy.com/v1/collections/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.jenzy.com/v1/collections/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.jenzy.com/v1/collections/{id}', 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.jenzy.com/v1/collections/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.jenzy.com/v1/collections/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.jenzy.com/v1/collections/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jenzy.com/v1/collections/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "settled",
"amount_mwk": "1000.00",
"fee": "15.00",
"amount_credited": "985.00",
"rail": "bank",
"source_customer_name": "PETER BANDA",
"source_account_number": "265991234567",
"source_institution": "Airtel Money",
"rtp_reference_number": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "validation_error",
"message": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>"
}
}Get a collection
One collection by id — a pay-in that credited your balance.
curl --request GET \
--url https://api.jenzy.com/v1/collections/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.jenzy.com/v1/collections/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.jenzy.com/v1/collections/{id}', 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.jenzy.com/v1/collections/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.jenzy.com/v1/collections/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.jenzy.com/v1/collections/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jenzy.com/v1/collections/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "settled",
"amount_mwk": "1000.00",
"fee": "15.00",
"amount_credited": "985.00",
"rail": "bank",
"source_customer_name": "PETER BANDA",
"source_account_number": "265991234567",
"source_institution": "Airtel Money",
"rtp_reference_number": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "validation_error",
"message": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>"
}
}Authorizations
Your Jenzy API key: Authorization: Bearer jz_live_…
Path Parameters
The collection id (UUID).
Response
The collection.
Collection id — your handle for polling and support.
settled means the money credited your balance. reversed means the provider then clawed the pay-in back — treat the collection.reversed event as authoritative; your balance catches up.
settled, reversed "settled"
The gross amount the sender sent — exact decimal string at 2 decimal places. Parse with a decimal library, never a float.
"1000.00"
The transaction fee, as one combined figure — an exact decimal string. Always equal to amount_mwk minus amount_credited. Use POST /fees/quote to know it in advance.
"15.00"
What your balance moved by: amount_mwk minus fee, as an exact decimal string.
"985.00"
How the money arrived: momo from a mobile wallet, bank from a bank account. Null when the rail could not be determined.
bank, momo, null Who sent the money, as reported by the provider.
"PETER BANDA"
The account or wallet the money came from, verbatim — your handle for matching the pay-in to your own customer.
"265991234567"
The institution the money came from, as reported by the provider.
"Airtel Money"
The reference you supplied when requesting this payment, echoed back for matching. Null when the payer sent the money directly.