# All active NGN checkouts
curl -G https://api.kwugwo.africa/v1/checkouts \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
--data-urlencode "filter[status][]=1" \
--data-urlencode "filter[currency][]=NGN"
const q = "filter[status][]=1&filter[currency][]=NGN";
const checkouts = await fetch(`https://api.kwugwo.africa/v1/checkouts?${q}`, {
headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` },
}).then(r => r.json());
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/checkouts?" . http_build_query([
'filter' => ['status' => [1], 'currency' => ['NGN']],
]));
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$checkouts = json_decode(curl_exec($ch), true);
curl_close($ch);
import os, requests
checkouts = requests.get(
"https://api.kwugwo.africa/v1/checkouts",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
params=[("filter[status][]", 1), ("filter[currency][]", "NGN")],
).json()
url := "https://api.kwugwo.africa/v1/checkouts?filter%5Bstatus%5D%5B%5D=1&filter%5Bcurrency%5D%5B%5D=NGN"
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": "chk.VCvr.vBtGwathtd99FpQGIGwIAATX",
"currency": "NGN",
"mediums": [
{ "medium": "bank_transfer" },
{ "medium": "ussd" }
]
}
]
Checkouts
List checkouts
The checkouts configured on your workspace.
GET
/
v1
/
checkouts
# All active NGN checkouts
curl -G https://api.kwugwo.africa/v1/checkouts \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
--data-urlencode "filter[status][]=1" \
--data-urlencode "filter[currency][]=NGN"
const q = "filter[status][]=1&filter[currency][]=NGN";
const checkouts = await fetch(`https://api.kwugwo.africa/v1/checkouts?${q}`, {
headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` },
}).then(r => r.json());
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/checkouts?" . http_build_query([
'filter' => ['status' => [1], 'currency' => ['NGN']],
]));
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$checkouts = json_decode(curl_exec($ch), true);
curl_close($ch);
import os, requests
checkouts = requests.get(
"https://api.kwugwo.africa/v1/checkouts",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
params=[("filter[status][]", 1), ("filter[currency][]", "NGN")],
).json()
url := "https://api.kwugwo.africa/v1/checkouts?filter%5Bstatus%5D%5B%5D=1&filter%5Bcurrency%5D%5B%5D=NGN"
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": "chk.VCvr.vBtGwathtd99FpQGIGwIAATX",
"currency": "NGN",
"mediums": [
{ "medium": "bank_transfer" },
{ "medium": "ussd" }
]
}
]
Returns your workspace’s checkouts. Pass a
checkout’s
Invalid filter values return
uid as checkout on Create an ugwo to
route that payment through it.
This endpoint is not paginated; it returns a plain array.
Query parameters
string[]
Repeatable.
1 for active, 2 for inactive. Defaults to both.string[]
Repeatable. ISO-4217 codes, e.g.
filter[currency][]=NGN.422.
Response
An array of Checkout objects.Inactive checkouts are listed (unless you filter them out), but
Get a checkout returns
404 for them and payments
can’t be routed through them.# All active NGN checkouts
curl -G https://api.kwugwo.africa/v1/checkouts \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
--data-urlencode "filter[status][]=1" \
--data-urlencode "filter[currency][]=NGN"
const q = "filter[status][]=1&filter[currency][]=NGN";
const checkouts = await fetch(`https://api.kwugwo.africa/v1/checkouts?${q}`, {
headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` },
}).then(r => r.json());
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/checkouts?" . http_build_query([
'filter' => ['status' => [1], 'currency' => ['NGN']],
]));
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$checkouts = json_decode(curl_exec($ch), true);
curl_close($ch);
import os, requests
checkouts = requests.get(
"https://api.kwugwo.africa/v1/checkouts",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
params=[("filter[status][]", 1), ("filter[currency][]", "NGN")],
).json()
url := "https://api.kwugwo.africa/v1/checkouts?filter%5Bstatus%5D%5B%5D=1&filter%5Bcurrency%5D%5B%5D=NGN"
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": "chk.VCvr.vBtGwathtd99FpQGIGwIAATX",
"currency": "NGN",
"mediums": [
{ "medium": "bank_transfer" },
{ "medium": "ussd" }
]
}
]