curl https://api.kwugwo.africa/v1/onye/ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY"
const onye = await fetch(
`https://api.kwugwo.africa/v1/onye/${onyeUid}`,
{ headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/onye/{$onyeUid}");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$onye = json_decode(curl_exec($ch), true);
curl_close($ch);
import os, requests
onye = requests.get(
f"https://api.kwugwo.africa/v1/onye/{onye_uid}",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()
url := fmt.Sprintf("https://api.kwugwo.africa/v1/onye/%s", onyeUid)
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KWUGWO_SECRET_KEY"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
{
"uid": "ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Okeke",
"nzube_ref": "user_8821",
"billing_address": {
"address": "12 Marina",
"address2": "",
"city": "Lagos",
"state": "Lagos",
"zip": "101001",
"country": "NG"
},
"created_at": "2026-05-15T09:14:22+00:00",
"updated_at": "2026-05-15T09:14:22+00:00",
"meta": { "source": "shopify" },
"total_successful_activities": 3,
"total_failed_activities": 0,
"latest_ugwo_activity": {
"uid": "act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs",
"activity_type": "charge",
"psp": "paystack_ng",
"status": "successful",
"amount": 500000,
"charged_amount": 500000,
"refunded_amount": 0,
"...": "see The Activity object"
}
}
{
"code": 404,
"message": "nzube.onye.error.not_found"
}
Customers (Onye)
Get a customer
Fetch a customer by ID, with their latest payment attempt.
GET
/
v1
/
onye
/
{uid}
curl https://api.kwugwo.africa/v1/onye/ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY"
const onye = await fetch(
`https://api.kwugwo.africa/v1/onye/${onyeUid}`,
{ headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/onye/{$onyeUid}");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$onye = json_decode(curl_exec($ch), true);
curl_close($ch);
import os, requests
onye = requests.get(
f"https://api.kwugwo.africa/v1/onye/{onye_uid}",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()
url := fmt.Sprintf("https://api.kwugwo.africa/v1/onye/%s", onyeUid)
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KWUGWO_SECRET_KEY"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
{
"uid": "ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Okeke",
"nzube_ref": "user_8821",
"billing_address": {
"address": "12 Marina",
"address2": "",
"city": "Lagos",
"state": "Lagos",
"zip": "101001",
"country": "NG"
},
"created_at": "2026-05-15T09:14:22+00:00",
"updated_at": "2026-05-15T09:14:22+00:00",
"meta": { "source": "shopify" },
"total_successful_activities": 3,
"total_failed_activities": 0,
"latest_ugwo_activity": {
"uid": "act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs",
"activity_type": "charge",
"psp": "paystack_ng",
"status": "successful",
"amount": 500000,
"charged_amount": 500000,
"refunded_amount": 0,
"...": "see The Activity object"
}
}
{
"code": 404,
"message": "nzube.onye.error.not_found"
}
Returns the customer. Unlike the other customer
endpoints,
latest_ugwo_activity here is the full Activity
object rather than its ID.
Deleted customers return 404.
Path parameters
string
required
Customer ID,
ony.XXXX.YYYY....Response
A Customer object withlatest_ugwo_activity
expanded.
curl https://api.kwugwo.africa/v1/onye/ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY"
const onye = await fetch(
`https://api.kwugwo.africa/v1/onye/${onyeUid}`,
{ headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/onye/{$onyeUid}");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$onye = json_decode(curl_exec($ch), true);
curl_close($ch);
import os, requests
onye = requests.get(
f"https://api.kwugwo.africa/v1/onye/{onye_uid}",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()
url := fmt.Sprintf("https://api.kwugwo.africa/v1/onye/%s", onyeUid)
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KWUGWO_SECRET_KEY"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
{
"uid": "ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Okeke",
"nzube_ref": "user_8821",
"billing_address": {
"address": "12 Marina",
"address2": "",
"city": "Lagos",
"state": "Lagos",
"zip": "101001",
"country": "NG"
},
"created_at": "2026-05-15T09:14:22+00:00",
"updated_at": "2026-05-15T09:14:22+00:00",
"meta": { "source": "shopify" },
"total_successful_activities": 3,
"total_failed_activities": 0,
"latest_ugwo_activity": {
"uid": "act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs",
"activity_type": "charge",
"psp": "paystack_ng",
"status": "successful",
"amount": 500000,
"charged_amount": 500000,
"refunded_amount": 0,
"...": "see The Activity object"
}
}
{
"code": 404,
"message": "nzube.onye.error.not_found"
}